1 <samba:parameter xmlns:samba="http://samba.org/common">
2 <term><anchor id="CHANGESHARECOMMAND"/>change share command (G)</term>
3 <listitem><para>Samba 2.2.0 introduced the ability to dynamically
4 add and delete shares via the Windows NT 4.0 Server Manager. The
5 <parameter moreinfo="none">change share command</parameter> is used to define an
6 external program or script which will modify an existing service definition
7 in <filename moreinfo="none">smb.conf</filename>. In order to successfully
8 execute the <parameter moreinfo="none">change share command</parameter>, <command moreinfo="none">smbd</command>
9 requires that the administrator be connected using a root account (i.e.
14 When executed, <command moreinfo="none">smbd</command> will automatically invoke the
15 <parameter moreinfo="none">change share command</parameter> with four parameters.
19 <listitem><para><parameter moreinfo="none">configFile</parameter> - the location
20 of the global <filename moreinfo="none">smb.conf</filename> file.
23 <listitem><para><parameter moreinfo="none">shareName</parameter> - the name of the new
27 <listitem><para><parameter moreinfo="none">pathName</parameter> - path to an **existing**
31 <listitem><para><parameter moreinfo="none">comment</parameter> - comment string to associate
37 This parameter is only used modify existing file shares definitions. To modify
38 printer shares, use the "Printers..." folder as seen when browsing the Samba host.
42 See also <link linkend="ADDSHARECOMMAND"><parameter moreinfo="none">add share
43 command</parameter></link>, <link linkend="DELETESHARECOMMAND"><parameter moreinfo="none">delete
44 share command</parameter></link>.
47 <para>Default: <emphasis>none</emphasis></para>
48 <para>Example: <command moreinfo="none">change share command = /usr/local/bin/addshare</command></para>