docs: Improve description of the share commands in man smb.conf.
[samba.git] / docs-xml / smbdotconf / misc / changesharecommand.xml
index 5a42e225594436ddd0f059d9ecb9d11d5bf1c3f5..2033fcf46cdfd88aa90576fafdf4f38852568bca 100644 (file)
@@ -8,14 +8,17 @@
        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
 Manager.  The <parameter moreinfo="none">change share command</parameter> is used to define an external
 program or script which will modify an existing service definition in <filename
-moreinfo="none">smb.conf</filename>.  In order to successfully execute the <parameter moreinfo="none">change
-share command</parameter>, <command moreinfo="none">smbd</command> requires that the administrator be
-connected using a root account (i.e. uid == 0).
+moreinfo="none">smb.conf</filename>.
        </para>
 
        <para>
-       If the connected account has <literal>SeDiskOperatorPrivilege</literal>, scripts defined in
-       <parameter moreinfo="none">change share</parameter> parameter are executed as root.
+       In order to successfully execute the
+       <parameter moreinfo="none">change share command</parameter>,
+       <command moreinfo="none">smbd</command> requires that the administrator
+       connects using a root account (i.e. uid == 0) or has the
+       <literal>SeDiskOperatorPrivilege</literal>.
+       Scripts defined in the <parameter moreinfo="none">change share command</parameter>
+       parameter are executed as root.
        </para>
 
        <para>
@@ -58,13 +61,14 @@ connected using a root account (i.e. uid == 0).
        </itemizedlist>
 
        <para>
-       This parameter is only used modify existing file shares definitions.  To modify
-       printer shares, use the &quot;Printers...&quot; folder as seen when browsing the Samba host.
+       This parameter is only used to modify existing file share definitions.
+       To modify printer shares, use the &quot;Printers...&quot; folder as seen
+       when browsing the Samba host.
        </para>
 </description>
 
 <related>add share command</related>
 <related>delete share command</related>
 <value type="default"></value>
-<value type="example">/usr/local/bin/addshare</value>
+<value type="example">/usr/local/bin/changeshare</value>
 </samba:parameter>