<para>Setting this parameter will affect the performance
of Samba, as it will be forced to check all files and directories
for a match as they are scanned.</para>
-</description>
-<related>hide files</related>
-<related>case sensitive</related>
-<value type="default"><comment>No files or directories are vetoed.</comment></value>
-
-<value type="example">
-; Veto any files containing the word Security,
+ <para>
+ Examples of use include:
+<screen>
+; Veto any files containing the word Security,
; any ending in .tmp, and any directory containing the
; word root.
veto files = /*Security*/*.tmp/*root*/
; Veto the Apple specific files that a NetAtalk server
; creates.
veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/
-</value>
+</screen>
+ </para>
+
+</description>
+<related>hide files</related>
+<related>case sensitive</related>
+
+<value type="default">No files or directories are vetoed.</value>
</samba:parameter>
To cause Samba not to grant oplocks on these files you would use
the line (either in the [global] section or in the section for
the particular NetBench share :</para>
+
+ <para>
+ An example of use is:
+<screen>
+veto oplock files = /.*SEM/
+</screen>
+ </para>
</description>
<value type="default"><comment>No files are vetoed for oplock grants</comment></value>
-<value type="example">/.*SEM/</value>
</samba:parameter>
path in the <parameter moreinfo="none">lprm command</parameter> as the PATH may not be
available to the server.</para>
+ <para>
+ Examples of use are:
+<screen>
+lprm command = /usr/bin/lprm -P%p %j
+
+or
+
+lprm command = /usr/bin/cancel %p-%j
+</screen>
+ </para>
+
</description>
<related>printing</related>
-<value type="default">depends on the setting of <parameter moreinfo="none">printing</parameter></value>
-<value type="example">/usr/bin/lprm -P%p %j</value>
-<value type="example">/usr/bin/cancel %p-%j</value>
+<value type="default"> determined by printing parameter</value>
</samba:parameter>
</para></listitem>
</itemizedlist>
+
</para>
-</description>
+ Examples of use are:
+<screen>
+passdb backend = tdbsam:/etc/samba/private/passdb.tdb \
+ smbpasswd:/etc/samba/smbpasswd
-<value type="default">smbpasswd</value>
+or
+
+passdb backend = ldapsam:ldaps://ldap.example.com
-<value type="example">tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd</value>
+or
-<value type="example">ldapsam:ldaps://ldap.example.com</value>
+passdb backend = ldapsam:"ldap://ldap-1.example.com \
+ ldap://ldap-2.example.com"
-<value type="example">ldapsam:"ldap://ldap-1.example.com ldap://ldap-2.example.com"</value>
+or
-<value type="example">mysql:my_plugin_args tdbsam</value>
+passdb backend = mysql:my_plugin_args tdbsam
+</screen>
+</description>
+
+<value type="default">smbpasswd</value>
</samba:parameter>
<para>The setting of this parameter determines whether user and
group list information is returned for an anonymous connection.
and mirrors the effects of the
- <constant>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\LSA\RestrictAnonymous</constant> registry key in Windows
- 2000 and Windows NT. When set to 0, user and group list
- information is returned to anyone who asks. When set
+<screen>
+HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
+ Control\LSA\RestrictAnonymous
+</screen>
+ registry key in Windows 2000 and Windows NT. When set to 0, user
+ and group list information is returned to anyone who asks. When set
to 1, only an authenticated user can retrive user and
group list information. For the value 2, supported by
Windows 2000/XP and Samba, no anonymous connections are allowed at
<description>
<para>This option sets the path to the encrypted smbpasswd file. By
default the path to the smbpasswd file is compiled into Samba.</para>
+
+ <para>
+ An example of use is:
+<screen>
+smb passwd file = /etc/samba/smbpasswd
+</screen>
+ </para>
</description>
<value type="default">${prefix}/private/smbpasswd</value>
-<value type="example">/etc/samba/smbpasswd</value>
</samba:parameter>
to the fully qualified username (i.e. DOMAIN\user) only
after the user has been successfully authenticated.
</para>
+
+ <para>
+ An example of use is:
+<screen>
+username map = /usr/local/samba/lib/users.map
+</screen>
+ </para>
</description>
<value type="default"><comment>no username map</comment></value>
-<value type="example">/usr/local/samba/lib/users.map</value>
</samba:parameter>