Adding upstream version 2:4.20.0+dfsg.upstream/2%4.20.0+dfsg

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 53 insertions, 0 deletions

diff --git a/docs-xml/smbdotconf/filename/vetofiles.xml b/docs-xml/smbdotconf/filename/vetofiles.xml
new file mode 100644
index 0000000..11bb51e
--- /dev/null
+++ b/docs-xml/smbdotconf/filename/vetofiles.xml
@@ -0,0 +1,53 @@
+<samba:parameter name="veto files"
+                 context="S"
+                 type="string"
+                 substitution="1"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+ <description>
+	<para>
+	This is a list of files and directories that are neither visible nor accessible.  Each entry in 
+	the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?' 
+	can be used to specify multiple files or directories as in DOS wildcards.
+	</para>
+
+	<para>
+	Each entry must be a unix path, not a DOS path and must <emphasis>not</emphasis> include the  
+	unix directory 	separator '/'.
+	</para>
+
+	<para>
+	Note that the <smbconfoption name="case sensitive"/> option is applicable in vetoing files.
+	</para>
+		
+	<para>
+	One feature of the veto files parameter that it is important to be aware of is Samba's behaviour when
+	trying to delete a directory. If a directory that is to be deleted contains nothing but veto files this
+	deletion will <emphasis>fail</emphasis> unless you also set the <smbconfoption name="delete veto files"/> 
+	parameter to <parameter moreinfo="none">yes</parameter>.
+	</para>
+
+	<para>
+	Setting this parameter will affect the performance of Samba, as it will be forced to check all files 
+	and directories for a match as they are scanned.
+	</para>
+
+	<para>
+	Examples of use include:
+<programlisting>
+; Veto any files containing the word Security,
+; any ending in .tmp, and any directory containing the
+; word root.
+veto files = /*Security*/*.tmp/*root*/
+
+; Veto the Apple specific files that a NetAtalk server
+; creates.
+veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/
+</programlisting>
+	</para>
+
+</description>
+<related>hide files</related>
+<related>case sensitive</related>
+
+<value type="default"><comment>No files or directories are vetoed</comment></value>
+</samba:parameter>