able to change the permissions on it. However, this behavior
is often confusing to DOS/Windows users. Enabling this parameter
allows a user who has write access to the file (by whatever
- means) to modify the permissions on it. Note that a user
+ means) to modify the permissions (including ACL) on it. Note that a user
belonging to the group owning the file will not be allowed to
change permissions if the group is only granted read access.
- Ownership of the file/directory is not changed, only the permissions
- are modified.</para>
+ Ownership of the file/directory may also be changed.</para>
</description>
<value type="default">no</value>
</samba:parameter>
--- /dev/null
+<samba:parameter name="add printer command"
+ context="G"
+ type="string"
+ advanced="1" developer="1"
+ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+ <para>Samba 3.0.23 introduces support for adding printer ports
+ remotely using the Windows "Add Standard TCP/IP Port Wizard".
+ This option defines an external program to be executed when
+ smbd receives a request to add a new Port to the system.
+ he script is passed two parameters:
+ </para>
+
+ <itemizedlist>
+ <listitem><para><parameter moreinfo="none">port name</parameter></para></listitem>
+ <listitem><para><parameter moreinfo="none">device URI</parameter></para></listitem>
+ </itemizedlist>
+
+ <para>The deviceURI is in the for of socket://<hostname>[:<portnumber>]
+ or lpd://<hostname>/<queuename>.</para>
+</description>
+
+<related>enum ports command</related>
+
+<value type="default"></value>
+<value type="example">/etc/samba/scripts/addport.sh</value>
+</samba:parameter>
</para>
<para>
- This is a new parameter introduced in Samba 3.0.20.
+ This is parameter has been marked deprecated in Samba 3.0.23. The same behavior is now
+ implemented by the <parameter moreinfo="none">dos filemode</parameter> option.
</para>
- <para>
- This can be particularly useful to allow groups to manage their own security on a part
- of the filesystem they have group ownership of, removing the bottleneck of having only
- the user owner or superuser able to reset permissions.
- </para>
</description>
<related>inherit owner</related>
+++ /dev/null
-<samba:parameter name="enable rid algorithm"
- context="G"
- advanced="1" developer="1" hide="1"
- type="boolean"
- xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
-<description>
- <para>This option is used to control whether or not smbd in Samba 3.0 should fallback
- to the algorithm used by Samba 2.2 to generate user and group RIDs. The longterm
- development goal is to remove the algorithmic mappings of RIDs altogether, but
- this has proved to be difficult. This parameter is mainly provided so that
- developers can turn the algorithm on and off and see what breaks. This parameter
- should not be disabled by non-developers because certain features in Samba will fail
- to work without it.
- </para>
-
-</description>
-<value type="default">yes</value>
-</samba:parameter>
<warning><para>Turning off group enumeration may cause some programs to behave oddly. </para></warning>
</description>
-<value type="default">yes</value>
+<value type="default">no</value>
</samba:parameter>
usernames. </para></warning>
</description>
-<value type="default">yes</value>
+<value type="default">no</value>
</samba:parameter>