docs-xml/smbdotconf/filename/vetofiles.xml

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