← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/filename/vetofiles.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/smbdotconf/filename/vetofiles.xml
 
1
<samba:parameter name="veto files"
 
2
                 context="S"
 
3
                                 type="string"
 
4
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
5
 <description>
 
6
        <para>
 
7
        This is a list of files and directories that are neither visible nor accessible.  Each entry in 
 
8
        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?' 
 
9
        can be used to specify multiple files or directories as in DOS wildcards.
 
10
        </para>
 
11
 
 
12
        <para>
 
13
        Each entry must be a unix path, not a DOS path and must <emphasis>not</emphasis> include the  
 
14
        unix directory  separator '/'.
 
15
        </para>
 
16
 
 
17
        <para>
 
18
        Note that the <smbconfoption name="case sensitive"/> option is applicable in vetoing files.
 
19
        </para>
 
20
                
 
21
        <para>
 
22
        One feature of the veto files parameter that it is important to be aware of is Samba's behaviour when
 
23
        trying to delete a directory. If a directory that is to be deleted contains nothing but veto files this
 
24
        deletion will <emphasis>fail</emphasis> unless you also set the <smbconfoption name="delete veto files"/> 
 
25
        parameter to <parameter moreinfo="none">yes</parameter>.
 
26
        </para>
 
27
 
 
28
        <para>
 
29
        Setting this parameter will affect the performance of Samba, as it will be forced to check all files 
 
30
        and directories for a match as they are scanned.
 
31
        </para>
 
32
 
 
33
        <para>
 
34
        Examples of use include:
 
35
<programlisting>
 
36
; Veto any files containing the word Security,
 
37
; any ending in .tmp, and any directory containing the
 
38
; word root.
 
39
veto files = /*Security*/*.tmp/*root*/
 
40
 
 
41
; Veto the Apple specific files that a NetAtalk server
 
42
; creates.
 
43
veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/
 
44
</programlisting>
 
45
        </para>
 
46
 
 
47
</description>
 
48
<related>hide files</related>
 
49
<related>case sensitive</related>
 
50
 
 
51
<value type="default">No files or directories are vetoed.</value>
 
52
</samba:parameter>