1 <samba:parameter name="change share command"
4 advanced="1" developer="1"
5 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
7 <para>Samba 2.2.0 introduced the ability to dynamically
8 add and delete shares via the Windows NT 4.0 Server Manager. The
9 <parameter moreinfo="none">change share command</parameter> is used to define an
10 external program or script which will modify an existing service definition
11 in <filename moreinfo="none">smb.conf</filename>. In order to successfully
12 execute the <parameter moreinfo="none">change share command</parameter>, <command moreinfo="none">smbd</command>
13 requires that the administrator be connected using a root account (i.e.
18 When executed, <command moreinfo="none">smbd</command> will automatically invoke the
19 <parameter moreinfo="none">change share command</parameter> with five parameters.
24 <para><parameter moreinfo="none">configFile</parameter> - the location
25 of the global <filename moreinfo="none">smb.conf</filename> file.
30 <para><parameter moreinfo="none">shareName</parameter> - the name of the new
36 <para><parameter moreinfo="none">pathName</parameter> - path to an **existing**
42 <para><parameter moreinfo="none">comment</parameter> - comment string to associate
48 <para><parameter moreinfo="none">max
49 connections</parameter>
50 Number of maximum simultaneous connections to this
57 This parameter is only used modify existing file shares definitions. To modify
58 printer shares, use the "Printers..." folder as seen when browsing the Samba host.
62 <related>add share command</related>
63 <related>delete share command</related>
64 <value type="default"></value>
65 <value type="example">/usr/local/bin/addshare</value>