| 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"><comment>No files or directories are vetoed</comment></value>
 | 
|---|
| 52 | </samba:parameter>
 | 
|---|