summaryrefslogtreecommitdiff
path: root/docs/smbdotconf/filename/vetofiles.xml
blob: 637e82449f0d754a31564591ab4ac2a840664253 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
<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:
<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/
</screen>
	</para>

</description>
<related>hide files</related>
<related>case sensitive</related>

<value type="default">No files or directories are vetoed.</value>
</samba:parameter>