docs/smbdotconf/filename/vetofiles.xml

   1 <samba:parameter name="veto files"
   2                  context="S"
   3                                  type="string"
   4                  xmlns:samba="http://samba.org/common">
   5  <description>
   6         <para>This is a list of files and directories that
   7         are neither visible nor accessible.  Each entry in the list must
   8         be separated by a '/', which allows spaces to be included
   9         in the entry. '*' and '?' can be used to specify multiple files
  10         or directories as in DOS wildcards.</para>
  11
  12         <para>Each entry must be a unix path, not a DOS path and
  13         must <emphasis>not</emphasis> include the  unix directory
  14         separator '/'.</para>
  15
  16         <para>Note that the <parameter moreinfo="none">case sensitive</parameter> option
  17         is applicable in vetoing files.</para>
  18
  19         <para>One feature of the veto files parameter that it
  20         is important to be aware of is Samba's behaviour when
  21         trying to delete a directory. If a directory that is
  22         to be deleted contains nothing but veto files this
  23         deletion will <emphasis>fail</emphasis> unless you also set
  24         the <parameter moreinfo="none">delete veto files</parameter> parameter to
  25         <parameter moreinfo="none">yes</parameter>.</para>
  26
  27         <para>Setting this parameter will affect the performance
  28         of Samba, as it will be forced to check all files and directories
  29         for a match as they are scanned.</para>
  30 </description>
  31 <related>hide files</related>
  32 <related>case sensitive</related>
  33
  34 <value type="default"><comment>No files or directories are vetoed.</comment></value>
  35
  36 <value type="example">
  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 </value>
  46 </samba:parameter>