From 9113a26fcc9607c0747ed11ee7220dcb23c6e093 Mon Sep 17 00:00:00 2001
From: Volker Lendecke <vlendec@samba.org>
Date: Sat, 27 May 2006 16:56:17 +0000
Subject: Document recycle:subdir_mode, thanks to Thomas Bork (This used to be
 commit a6449190e6ad7097a0f62638825366f91f5ec326)

---
 docs/Samba3-HOWTO/TOSHARG-VFS.xml | 46 ++++++++++++++++++++++++++++++++++-----
 1 file changed, 40 insertions(+), 6 deletions(-)

(limited to 'docs/Samba3-HOWTO/TOSHARG-VFS.xml')

diff --git a/docs/Samba3-HOWTO/TOSHARG-VFS.xml b/docs/Samba3-HOWTO/TOSHARG-VFS.xml
index 18fe9db978..7ebb05b22c 100644
--- a/docs/Samba3-HOWTO/TOSHARG-VFS.xml
+++ b/docs/Samba3-HOWTO/TOSHARG-VFS.xml
@@ -340,11 +340,18 @@ quotasettings:	gid nolimit = no
 <indexterm><primary>.recycle</primary></indexterm>
 <indexterm><primary>recycle:keeptree</primary></indexterm>
 <indexterm><primary>deleted files</primary></indexterm>
-		The <guiicon>Recycle Bin</guiicon> will not appear in <application>Windows Explorer</application> views of the
-		network file system (share) nor on any mapped drive. Instead, a directory called <filename>.recycle</filename>
-		will be automatically created when the first file is deleted. Users can recover files from the
-		<filename>.recycle</filename> directory. If the <parameter>recycle:keeptree</parameter> has been specified,
-		deleted files will be found in a path identical with that from which the file was deleted.
+		The <guiicon>Recycle Bin</guiicon> will not appear in
+		<application>Windows Explorer</application> views of the network
+		file system (share) nor on any mapped drive. Instead, a directory
+		called <filename>.recycle</filename> will be automatically created
+		when the first file is deleted and <parameter>recycle:repository</parameter>
+		is not configured.
+		If <parameter>recycle:repository</parameter> is configured, the name
+		of the created directory depends on <parameter>recycle:repository</parameter>.
+		Users can recover files from the recycle bin. If the
+		<parameter>recycle:keeptree</parameter> has been specified,	deleted
+		files will be found in a path identical with that from which the
+		file was deleted.
 		</para>
 		
 		<para>Supported options for the <command>recycle</command> module are as follow:
@@ -353,7 +360,34 @@ quotasettings:	gid nolimit = no
 			<term>recycle:repository</term>
 				<listitem><para>
 <indexterm><primary>recycle:repository</primary></indexterm>
-				Relative path of the directory where deleted files should be moved.
+				Path of the directory where deleted files should be moved.
+				</para></listitem>
+			</varlistentry>
+
+			<varlistentry>
+			<term>recycle:directory_mode</term>
+				<listitem><para>
+<indexterm><primary>directory_mode</primary></indexterm>
+				Set it to the octal mode you want for the recycle directory. With
+				this mode the recycle directory	will be created if it not
+				exists and the first file is deleted.
+				If <parameter>recycle:subdir_mode</parameter> is not set, these
+				mode also apply to sub directories.
+				If <parameter>directory_mode</parameter> not exists, the default
+				mode 0700 is used.
+				</para></listitem>
+			</varlistentry>
+
+			<varlistentry>
+			<term>recycle:subdir_mode</term>
+				<listitem><para>
+<indexterm><primary>recycle:subdir_mode</primary></indexterm>
+				Set it to the octal mode you want for the sub directories of
+				the recycle directory. With this mode	the sub directories will
+				be created.
+				If <parameter>recycle:subdir_mode</parameter> is not set, the
+				sub directories will be created with the mode from
+				<parameter>directory_mode</parameter>.
 				</para></listitem>
 			</varlistentry>
 
-- 
cgit