1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-25 23:21:54 +03:00
samba-mirror/docs-xml/smbdotconf/filename/vetofiles.xml
Garming Sam 1273df8379 docs: update veto files to be consistent with testparm
Signed-off-by: Garming Sam <garming@catalyst.net.nz>
Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Alexander Bokovoy <ab@samba.org>
2014-01-28 17:26:37 +13:00

53 lines
1.8 KiB
XML

<samba:parameter name="veto files"
context="S"
type="string"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>
This is a list of files and directories that are neither visible nor accessible. Each entry in
the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
can be used to specify multiple files or directories as in DOS wildcards.
</para>
<para>
Each entry must be a unix path, not a DOS path and must <emphasis>not</emphasis> include the
unix directory separator '/'.
</para>
<para>
Note that the <smbconfoption name="case sensitive"/> option is applicable in vetoing files.
</para>
<para>
One feature of the veto files parameter that it is important to be aware of is Samba's behaviour when
trying to delete a directory. If a directory that is to be deleted contains nothing but veto files this
deletion will <emphasis>fail</emphasis> unless you also set the <smbconfoption name="delete veto files"/>
parameter to <parameter moreinfo="none">yes</parameter>.
</para>
<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>
<para>
Examples of use include:
<programlisting>
; 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/
</programlisting>
</para>
</description>
<related>hide files</related>
<related>case sensitive</related>
<value type="default"><comment>No files or directories are vetoed</comment></value>
</samba:parameter>