1 <samba:parameter name="change share command"
3 advanced="1" developer="1"
4 xmlns:samba="http://samba.org/common">
6 <para>Samba 2.2.0 introduced the ability to dynamically
7 add and delete shares via the Windows NT 4.0 Server Manager. The
8 <parameter moreinfo="none">change share command</parameter> is used to define an
9 external program or script which will modify an existing service definition
10 in <filename moreinfo="none">smb.conf</filename>. In order to successfully
11 execute the <parameter moreinfo="none">change share command</parameter>, <command moreinfo="none">smbd</command>
12 requires that the administrator be connected using a root account (i.e.
17 When executed, <command moreinfo="none">smbd</command> will automatically invoke the
18 <parameter moreinfo="none">change share command</parameter> with four parameters.
23 <para><parameter moreinfo="none">configFile</parameter> - the location
24 of the global <filename moreinfo="none">smb.conf</filename> file.
29 <para><parameter moreinfo="none">shareName</parameter> - the name of the new
35 <para><parameter moreinfo="none">pathName</parameter> - path to an **existing**
41 <para><parameter moreinfo="none">comment</parameter> - comment string to associate
48 This parameter is only used modify existing file shares definitions. To modify
49 printer shares, use the "Printers..." folder as seen when browsing the Samba host.
53 See also <link linkend="ADDSHARECOMMAND"><parameter moreinfo="none">add share
54 command</parameter></link>, <link linkend="DELETESHARECOMMAND"><parameter moreinfo="none">delete
55 share command</parameter></link>.
58 <para>Default: <emphasis>none</emphasis></para>
60 <para>Example: <command moreinfo="none">change share command = /usr/local/bin/addshare</command></para>