docs/docbook/smbdotconf/filename/vetofiles.xml

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