Changeset 286 for branches/samba-3.0/docs/manpages/vfs_recycle.8

Timestamp:

Jun 24, 2009, 5:09:21 PM (16 years ago)

Author:

Herwig Bauernfeind

Message:

Update 3.0 to 3.0.35

File:

• branches/samba-3.0/docs/manpages/vfs_recycle.8 (modified) (1 diff)

branches/samba-3.0/docs/manpages/vfs_recycle.8

@@ -1 +1 @@
 .\"     Title: vfs_recycle
-.\"    Author: 
-.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
-.\"      Date: 08/25/2008
+.\"    Author: [see the "AUTHOR" section]
+.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
+.\"      Date: 06/22/2009
 .\"    Manual: System Administration tools
 .\"    Source: Samba 3.0
+.\"  Language: English
 .\"
-.TH "VFS_RECYCLE" "8" "08/25/2008" "Samba 3\.0" "System Administration tools"
+.TH "VFS_RECYCLE" "8" "06/22/2009" "Samba 3\&.0" "System Administration tools"
+.\" -----------------------------------------------------------------
+.\" * (re)Define some macros
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" toupper - uppercase a string (locale-aware)
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de toupper
+.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
+\\$*
+.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH-xref - format a cross-reference to an SH section
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de SH-xref
+.ie n \{\
+.\}
+.toupper \\$*
+.el \{\
+\\$*
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SH - level-one heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SH
+.\" put an extra blank line of space above the head in non-TTY output
+.if t \{\
+.sp 1
+.\}
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[an-margin]u
+.ti 0
+.HTML-TAG ".NH \\n[an-level]"
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+\." make the size of the head bigger
+.ps +3
+.ft B
+.ne (2v + 1u)
+.ie n \{\
+.\" if n (TTY output), use uppercase
+.toupper \\$*
+.\}
+.el \{\
+.nr an-break-flag 0
+.\" if not n (not TTY), use normal case (not uppercase)
+\\$1
+.in \\n[an-margin]u
+.ti 0
+.\" if not n (not TTY), put a border/line under subheading
+.sp -.6
+\l'\n(.lu'
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" SS - level-two heading that works better for non-TTY output
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de1 SS
+.sp \\n[PD]u
+.nr an-level 1
+.set-an-margin
+.nr an-prevailing-indent \\n[IN]
+.fi
+.in \\n[IN]u
+.ti \\n[SN]u
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.ps \\n[PS-SS]u
+\." make the size of the head bigger
+.ps +2
+.ft B
+.ne (2v + 1u)
+.if \\n[.$] \&\\$*
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BB/BE - put background/screen (filled box) around block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BB
+.if t \{\
+.sp -.5
+.br
+.in +2n
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EB
+.if t \{\
+.if "\\$2"adjust-for-leading-newline" \{\
+.sp -1
+.\}
+.br
+.di
+.in
+.ll
+.gcolor
+.nr BW \\n(.lu-\\n(.i
+.nr BH \\n(dn+.5v
+.ne \\n(BHu+.5v
+.ie "\\$2"adjust-for-leading-newline" \{\
+\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.el \{\
+\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
+.\}
+.in 0
+.sp -.5v
+.nf
+.BX
+.in
+.sp .5v
+.fi
+.\}
+..
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" BM/EM - put colored marker in margin next to block of text
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.de BM
+.if t \{\
+.br
+.ll -2n
+.gcolor red
+.di BX
+.\}
+..
+.de EM
+.if t \{\
+.br
+.di
+.ll
+.gcolor
+.nr BH \\n(dn
+.ne \\n(BHu
+\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
+.in 0
+.nf
+.BX
+.in
+.fi
+.\}
+..
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
 .ad l
-.SH "NAME"
-vfs_recycle - Samba VFS recycle bin
-.SH "SYNOPSIS"
-.HP 1
-vfs objects = recycle
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "Name"
+vfs_recycle \- Samba VFS recycle bin
+.SH "Synopsis"
+.fam C
+.HP \w'\ 'u
+\FCvfs objects = recycle\F[]
+.fam
 .SH "DESCRIPTION"
 .PP
 This VFS module is part of the
 \fBsamba\fR(7)
-suite\.
+suite\&.
 .PP
 The
-vfs_recycle
-intercepts file deletion requests and moves the affected files to a temporary repository rather than deleting them immediately\. This gives the same effect as the Recycle Bin on Windows computers\.
-.PP
-The Recycle Bin will not appear in Windows Explorer views of the network file system (share) nor on any mapped drive\. Instead, a directory called \.recycle will be automatically created when the first file is deleted and recycle:repository is not configured\. If recycle:repository is configured, the name of the created directory depends on recycle:repository\. Users can recover files from the recycle bin\. If the recycle:keeptree option has been specified, deleted files will be found in a path identical with that from which the file was deleted\.
-.PP
-This module is stackable\.
+\FCvfs_recycle\F[]
+intercepts file deletion requests and moves the affected files to a temporary repository rather than deleting them immediately\&. This gives the same effect as the Recycle Bin on Windows computers\&.
+.PP
+The Recycle Bin will not appear in Windows Explorer views of the network file system (share) nor on any mapped drive\&. Instead, a directory called \&.recycle will be automatically created when the first file is deleted and recycle:repository is not configured\&. If recycle:repository is configured, the name of the created directory depends on recycle:repository\&. Users can recover files from the recycle bin\&. If the recycle:keeptree option has been specified, deleted files will be found in a path identical with that from which the file was deleted\&.
+.PP
+This module is stackable\&.
 .SH "OPTIONS"
 .PP
 recycle:repository = PATH
 .RS 4
-Path of the directory where deleted files should be moved\.
-.sp
-If this option is not set, the default path \.recycle is used\.
+Path of the directory where deleted files should be moved\&.
+.sp
+If this option is not set, the default path \&.recycle is used\&.
 .RE
 .PP
 recycle:directory_mode = MODE
 .RS 4
-Set MODE to the octal mode the recycle repository should be created with\. The recycle repository will be created when first file is deleted\. If recycle:subdir_mode is not set, MODE also applies to subdirectories\.
-.sp
-If this option is not set, the default mode 0700 is used\.
+Set MODE to the octal mode the recycle repository should be created with\&. The recycle repository will be created when first file is deleted\&. If recycle:subdir_mode is not set, MODE also applies to subdirectories\&.
+.sp
+If this option is not set, the default mode 0700 is used\&.
 .RE
 .PP
 recycle:subdir_mode = MODE
 .RS 4
-Set MODE to the octal mode with which sub directories of the recycle repository should be created\.
-.sp
-If this option is not set, subdirectories will be created with the mode from recycle:directory_mode\.
+Set MODE to the octal mode with which sub directories of the recycle repository should be created\&.
+.sp
+If this option is not set, subdirectories will be created with the mode from recycle:directory_mode\&.
 .RE
 .PP
 recycle:keeptree = BOOL
 .RS 4
-Specifies whether the directory structure should be preserved or whether the files in a directory that is being deleted should be kept separately in the repository\.
+Specifies whether the directory structure should be preserved or whether the files in a directory that is being deleted should be kept separately in the repository\&.
 .RE
 .PP
 recycle:versions = BOOL
 .RS 4
-If this option is True, two files with the same name that are deleted will both be kept in the repository\. Newer deleted versions of a file will be called "Copy #x of filename"\.
+If this option is True, two files with the same name that are deleted will both be kept in the repository\&. Newer deleted versions of a file will be called "Copy #x of filename"\&.
 .RE
 .PP
 recycle:touch = BOOL
 .RS 4
-Specifies whether a file\'s access date should be updated when the file is moved to the repository\.
+Specifies whether a file\'s access date should be updated when the file is moved to the repository\&.
 .RE
 .PP
 recycle:touch_mtime = BOOL
 .RS 4
-Specifies whether a file\'s last modified date should be updated when the file is moved to the repository\.
+Specifies whether a file\'s last modified date should be updated when the file is moved to the repository\&.
 .RE
 .PP
 recycle:minsize = BYTES
 .RS 4
-Files that are smaller than the number of bytes specified by this parameter will not be put into the repository\.
+Files that are smaller than the number of bytes specified by this parameter will not be put into the repository\&.
 .RE
 .PP
 recycle:maxsize = BYTES
 .RS 4
-Files that are larger than the number of bytes specified by this parameter will not be put into the repository\.
+Files that are larger than the number of bytes specified by this parameter will not be put into the repository\&.
 .RE
 .PP
 recycle:exclude = LIST
 .RS 4
-List of files that should not be put into the repository when deleted, but deleted in the normal way\. Wildcards such as * and ? are supported\.
+List of files that should not be put into the repository when deleted, but deleted in the normal way\&. Wildcards such as * and ? are supported\&.
 .RE
 .PP
 recycle:exclude_dir = LIST
 .RS 4
-List of directories whose files should not be put into the repository when deleted, but deleted in the normal way\. Wildcards such as * and ? are supported\.
+List of directories whose files should not be put into the repository when deleted, but deleted in the normal way\&. Wildcards such as * and ? are supported\&.
 .RE
 .PP
 recycle:noversions = LIST
 .RS 4
-Specifies a list of paths (wildcards such as * and ? are supported) for which no versioning should be used\. Only useful when recycle:versions is enabled\.
+Specifies a list of paths (wildcards such as * and ? are supported) for which no versioning should be used\&. Only useful when recycle:versions is enabled\&.
 .RE
 .SH "EXAMPLES"
 .PP
-Log operations on all shares using the LOCAL1 facility and NOTICE priority:
-.sp
-.RS 4
+Move files "deleted" on
+\fIshare\fR
+to
+\fI/data/share/\&.recycle\fR
+instead of deleting them:
+.sp
+.if n \{\
+.RS 4
+.\}
+.fam C
+.ps -1
 .nf
-        \fI[global]\fR
-        \fIvfs objects = recycle\fR
-        \fIrecycle:facility = LOCAL1\fR
-        \fIrecycle:priority = NOTICE\fR
-.fi
-.RE
+.if t \{\
+.sp -1
+.\}
+.BB lightgray adjust-for-leading-newline
+.sp -1
+
+        \fI[share]\fR
+        \m[blue]\fBpath = /data/share\fR\m[]
+        \m[blue]\fBvfs objects = recycle\fR\m[]
+        \m[blue]\fBrecycle:repository = \&.recycle\fR\m[]
+        \m[blue]\fBrecycle:keeptree = yes\fR\m[]
+        \m[blue]\fBrecycle:versions = yes\fR\m[]
+.EB lightgray adjust-for-leading-newline
+.if t \{\
+.sp 1
+.\}
+.fi
+.fam
+.ps +1
+.if n \{\
+.RE
+.\}
 .SH "VERSION"
 .PP
-This man page is correct for version 3\.0\.25 of the Samba suite\.
+This man page is correct for version 3\&.0\&.25 of the Samba suite\&.
 .SH "AUTHOR"
 .PP
-The original Samba software and related utilities were created by Andrew Tridgell\. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\.
+The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.