summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/filename/vetofiles.xml
blob: faef2040b92315b0568f58d0fe327fefed269b26 (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
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="VETOFILES"/>veto files(S)</term>
		<listitem><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 <parameter moreinfo="none">case sensitive</parameter> 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 <parameter moreinfo="none">delete veto files</parameter> 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>See also <link linkend="HIDEFILES"><parameter moreinfo="none">hide files
		</parameter></link> and <link linkend="CASESENSITIVE"><parameter moreinfo="none">
		case sensitive</parameter></link>.</para>

		<para>Default: <emphasis>No files or directories are vetoed.
		</emphasis></para>

<para>Examples:<programlisting format="linespecific">
; 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>
		</listitem>
		</samba:parameter>