components/rsync/patches/rsyncd.conf.5.patch
author Mike Sullivan <Mike.Sullivan@Oracle.COM>
Wed, 29 Aug 2012 11:05:56 -0700
changeset 957 255465c5756f
parent 297 3940bc347ca8
child 1351 5c589218fa09
permissions -rw-r--r--
Close of build 04.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     1
--- rsync-3.0.8/rsyncd.conf.5.~1~	Sat Mar 26 14:37:52 2011
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     2
+++ rsync-3.0.8/rsyncd.conf.5	Mon Jun 13 22:07:54 2011
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     3
@@ -1,4 +1,4 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     4
-.TH "rsyncd.conf" "5" "26 Mar 2011" "" ""
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     5
+.TH "rsyncd.conf" "5" "8 May 2009" "" ""
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     6
 .SH "NAME"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     7
 rsyncd.conf \(em configuration file for rsync in daemon mode
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     8
 .SH "SYNOPSIS"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
     9
@@ -20,9 +20,9 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    10
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    11
 The file consists of modules and parameters. A module begins with the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    12
 name of the module in square brackets and continues until the next
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    13
-module begins. Modules contain parameters of the form \(dq\&name = value\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    14
+module begins. Modules contain parameters of the form \(lqname = value\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    15
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    16
-The file is line\-based \-\- that is, each newline\-terminated line represents
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    17
+The file is line-based \(em that is, each newline-terminated line represents
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    18
 either a comment, a module name or a parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    19
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    20
 Only the first equals sign in a parameter is significant. Whitespace before
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    21
@@ -34,7 +34,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    22
 Any line beginning with a hash (#) is ignored, as are lines containing
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    23
 only whitespace.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    24
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    25
-Any line ending in a \e is \(dq\&continued\(dq\& on the next line in the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    26
+Any line ending in a \e is \(lqcontinued\(rq on the next line in the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    27
 customary UNIX fashion.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    28
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    29
 The values following the equals sign in parameters are all either a string
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    30
@@ -53,9 +53,9 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    31
 file ownership.  Otherwise, it must just have permission to read and
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    32
 write the appropriate data, log, and lock files.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    33
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    34
-You can launch it either via inetd, as a stand\-alone daemon, or from
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    35
-an rsync client via a remote shell.  If run as a stand\-alone daemon then
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    36
-just run the command \(dq\&\fBrsync \-\-daemon\fP\(dq\& from a suitable startup script.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    37
+You can launch it either via inetd, as a stand-alone daemon, or from
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    38
+an rsync client via a remote shell.  If run as a stand-alone daemon then
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    39
+just run the command \(lq\fBrsync \-\-daemon\fP\(rq from a suitable startup script.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    40
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    41
 When run via inetd you should add a line like this to /etc/services:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    42
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    43
@@ -71,12 +71,12 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    44
 .fi 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    45
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    46
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    47
-Replace \(dq\&/usr/bin/rsync\(dq\& with the path to where you have rsync installed on
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    48
+Replace \(lq/usr/bin/rsync\(rq with the path to where you have rsync installed on
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    49
 your system.  You will then need to send inetd a HUP signal to tell it to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    50
 reread its config file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    51
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    52
 Note that you should \fBnot\fP send the rsync daemon a HUP signal to force
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    53
-it to reread the \f(CWrsyncd.conf\fP file. The file is re\-read on each client
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    54
+it to reread the \f(CWrsyncd.conf\fP file. The file is re-read on each client
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    55
 connection.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    56
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    57
 .SH "GLOBAL PARAMETERS"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    58
@@ -91,7 +91,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    59
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    60
 .IP "\fBmotd file\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    61
 This parameter allows you to specify a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    62
-\(dq\&message of the day\(dq\& to display to clients on each connect. This
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    63
+\(lqmessage of the day\(rq to display to clients on each connect. This
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    64
 usually contains site information and any legal notices. The default
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    65
 is no motd file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    66
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    67
@@ -103,12 +103,12 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    68
 .IP "\fBport\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    69
 You can override the default port the daemon will listen on
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    70
 by specifying this value (defaults to 873).  This is ignored if the daemon
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    71
-is being run by inetd, and is superseded by the \fB\-\-port\fP command\-line option.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    72
+is being run by inetd, and is superseded by the \fB\-\-port\fP command-line option.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    73
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    74
 .IP "\fBaddress\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    75
 You can override the default IP address the daemon
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    76
 will listen on by specifying this value.  This is ignored if the daemon is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    77
-being run by inetd, and is superseded by the \fB\-\-address\fP command\-line option.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    78
+being run by inetd, and is superseded by the \fB\-\-address\fP command-line option.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    79
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    80
 .IP "\fBsocket options\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    81
 This parameter can provide endless fun for people
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    82
@@ -119,7 +119,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    83
 system call for
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    84
 details on some of the options you may be able to set. By default no
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    85
 special socket options are set.  These settings can also be specified
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    86
-via the \fB\-\-sockopts\fP command\-line option.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    87
+via the \fB\-\-sockopts\fP command-line option.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    88
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    89
 .SH "MODULE PARAMETERS"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    90
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    91
@@ -139,44 +139,44 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    92
 of available modules. The default is no comment.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    93
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    94
 .IP "\fBpath\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    95
-This parameter specifies the directory in the daemon\(cq\&s
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    96
+This parameter specifies the directory in the daemon's
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    97
 filesystem to make available in this module.  You must specify this parameter
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    98
 for each module in \f(CWrsyncd.conf\fP.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    99
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   100
 .IP "\fBuse chroot\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   101
-If \(dq\&use chroot\(dq\& is true, the rsync daemon will chroot
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   102
-to the \(dq\&path\(dq\& before starting the file transfer with the client.  This has
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   103
+If \(lquse chroot\(rq is true, the rsync daemon will chroot
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   104
+to the \(lqpath\(rq before starting the file transfer with the client.  This has
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   105
 the advantage of extra protection against possible implementation security
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   106
-holes, but it has the disadvantages of requiring super\-user privileges,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   107
+holes, but it has the disadvantages of requiring super-user privileges,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   108
 of not being able to follow symbolic links that are either absolute or outside
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   109
 of the new root path, and of complicating the preservation of users and groups
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   110
 by name (see below).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   111
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   112
-As an additional safety feature, you can specify a dot\-dir in the module\(cq\&s
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   113
-\(dq\&path\(dq\& to indicate the point where the chroot should occur.  This allows rsync
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   114
-to run in a chroot with a non\-\(dq\&/\(dq\& path for the top of the transfer hierarchy.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   115
+As an additional safety feature, you can specify a dot-dir in the module's
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   116
+\(lqpath\(rq to indicate the point where the chroot should occur.  This allows rsync
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   117
+to run in a chroot with a non\-"/\(rq path for the top of the transfer hierarchy.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   118
 Doing this guards against unintended library loading (since those absolute
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   119
 paths will not be inside the transfer hierarchy unless you have used an unwise
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   120
 pathname), and lets you setup libraries for the chroot that are outside of the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   121
-transfer.  For example, specifying \(dq\&/var/rsync/./module1\(dq\& will chroot to the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   122
-\(dq\&/var/rsync\(dq\& directory and set the inside\-chroot path to \(dq\&/module1\(dq\&.  If you
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   123
-had omitted the dot\-dir, the chroot would have used the whole path, and the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   124
-inside\-chroot path would have been \(dq\&/\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   125
+transfer.  For example, specifying \(lq/var/rsync/./module1\(rq will chroot to the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   126
+\(lq/var/rsync\(rq directory and set the inside-chroot path to \(lq/module1\(rq.  If you
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   127
+had omitted the dot-dir, the chroot would have used the whole path, and the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   128
+inside-chroot path would have been \(lq/\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   129
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   130
-When \(dq\&use chroot\(dq\& is false or the inside\-chroot path is not \(dq\&/\(dq\&, rsync will:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   131
+When \(lquse chroot\(rq is false or the inside-chroot path is not \(lq/\(rq, rsync will:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   132
 (1) munge symlinks by
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   133
-default for security reasons (see \(dq\&munge symlinks\(dq\& for a way to turn this
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   134
+default for security reasons (see \(lqmunge symlinks\(rq for a way to turn this
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   135
 off, but only if you trust your users), (2) substitute leading slashes in
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   136
-absolute paths with the module\(cq\&s path (so that options such as
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   137
+absolute paths with the module's path (so that options such as
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   138
 \fB\-\-backup\-dir\fP, \fB\-\-compare\-dest\fP, etc. interpret an absolute path as
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   139
-rooted in the module\(cq\&s \(dq\&path\(dq\& dir), and (3) trim \(dq\&..\(dq\& path elements from
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   140
+rooted in the module's \(lqpath\(rq dir), and (3) trim \(lq..\(rq path elements from
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   141
 args if rsync believes they would escape the module hierarchy.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   142
-The default for \(dq\&use chroot\(dq\& is true, and is the safer choice (especially
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   143
-if the module is not read\-only).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   144
+The default for \(lquse chroot\(rq is true, and is the safer choice (especially
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   145
+if the module is not read-only).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   146
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   147
 When this parameter is enabled, rsync will not attempt to map users and groups
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   148
 by name (by default), but instead copy IDs as though \fB\-\-numeric\-ids\fP had
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   149
-been specified.  In order to enable name\-mapping, rsync needs to be able to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   150
+been specified.  In order to enable name-mapping, rsync needs to be able to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   151
 use the standard library functions for looking up names and IDs (i.e.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   152
 \f(CWgetpwuid()\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   153
 , 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   154
@@ -191,12 +191,12 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   155
 used by these library functions (traditionally /etc/passwd and
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   156
 /etc/group, but perhaps additional dynamic libraries as well).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   157
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   158
-If you copy the necessary resources into the module\(cq\&s chroot area, you
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   159
-should protect them through your OS\(cq\&s normal user/group or ACL settings (to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   160
-prevent the rsync module\(cq\&s user from being able to change them), and then
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   161
-hide them from the user\(cq\&s view via \(dq\&exclude\(dq\& (see how in the discussion of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   162
+If you copy the necessary resources into the module's chroot area, you
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   163
+should protect them through your OS's normal user/group or ACL settings (to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   164
+prevent the rsync module's user from being able to change them), and then
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   165
+hide them from the user's view via \(lqexclude\(rq (see how in the discussion of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   166
 that parameter).  At that point it will be safe to enable the mapping of users
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   167
-and groups by name using the \(dq\&numeric ids\(dq\& daemon parameter (see below).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   168
+and groups by name using the \(lqnumeric ids\(rq daemon parameter (see below).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   169
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   170
 Note also that you are free to setup custom user/group information in the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   171
 chroot area that is different from your normal system.  For example, you
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   172
@@ -205,12 +205,12 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   173
 .IP "\fBnumeric ids\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   174
 Enabling this parameter disables the mapping
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   175
 of users and groups by name for the current daemon module.  This prevents
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   176
-the daemon from trying to load any user/group\-related files or libraries.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   177
+the daemon from trying to load any user/group-related files or libraries.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   178
 This enabling makes the transfer behave as if the client had passed
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   179
-the \fB\-\-numeric\-ids\fP command\-line option.  By default, this parameter is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   180
-enabled for chroot modules and disabled for non\-chroot modules.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   181
+the \fB\-\-numeric\-ids\fP command-line option.  By default, this parameter is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   182
+enabled for chroot modules and disabled for non-chroot modules.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   183
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   184
-A chroot\-enabled module should not have this parameter enabled unless you\(cq\&ve
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   185
+A chroot-enabled module should not have this parameter enabled unless you've
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   186
 taken steps to ensure that the module has the necessary resources it needs
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   187
 to translate names, and that it is not possible for a user to change those
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   188
 resources.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   189
@@ -219,52 +219,52 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   190
 This parameter tells rsync to modify
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   191
 all incoming symlinks in a way that makes them unusable but recoverable
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   192
 (see below).  This should help protect your files from user trickery when
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   193
-your daemon module is writable.  The default is disabled when \(dq\&use chroot\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   194
-is on and the inside\-chroot path is \(dq\&/\(dq\&, otherwise it is enabled.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   195
+your daemon module is writable.  The default is disabled when \(lquse chroot\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   196
+is on and the inside-chroot path is \(lq/\(rq, otherwise it is enabled.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   197
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   198
-If you disable this parameter on a daemon that is not read\-only, there
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   199
+If you disable this parameter on a daemon that is not read-only, there
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   200
 are tricks that a user can play with uploaded symlinks to access
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   201
-daemon\-excluded items (if your module has any), and, if \(dq\&use chroot\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   202
+daemon-excluded items (if your module has any), and, if \(lquse chroot\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   203
 is off, rsync can even be tricked into showing or changing data that
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   204
-is outside the module\(cq\&s path (as access\-permissions allow).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   205
+is outside the module's path (as access-permissions allow).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   206
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   207
 The way rsync disables the use of symlinks is to prefix each one with
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   208
-the string \(dq\&/rsyncd\-munged/\(dq\&.  This prevents the links from being used
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   209
+the string \(lq/rsyncd-munged/\(rq.  This prevents the links from being used
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   210
 as long as that directory does not exist.  When this parameter is enabled,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   211
 rsync will refuse to run if that path is a directory or a symlink to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   212
-a directory.  When using the \(dq\&munge symlinks\(dq\& parameter in a chroot area
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   213
-that has an inside\-chroot path of \(dq\&/\(dq\&, you should add \(dq\&/rsyncd\-munged/\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   214
+a directory.  When using the \(lqmunge symlinks\(rq parameter in a chroot area
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   215
+that has an inside-chroot path of \(lq/\(rq, you should add \(lq/rsyncd-munged/\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   216
 to the exclude setting for the module so that
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   217
-a user can\(cq\&t try to create it.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   218
+a user can't try to create it.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   219
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   220
-Note:  rsync makes no attempt to verify that any pre\-existing symlinks in
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   221
-the module\(cq\&s hierarchy are as safe as you want them to be (unless, of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   222
+Note:  rsync makes no attempt to verify that any pre-existing symlinks in
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   223
+the module's hierarchy are as safe as you want them to be (unless, of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   224
 course, it just copied in the whole hierarchy).  If you setup an rsync
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   225
 daemon on a new area or locally add symlinks, you can manually protect your
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   226
-symlinks from being abused by prefixing \(dq\&/rsyncd\-munged/\(dq\& to the start of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   227
-every symlink\(cq\&s value.  There is a perl script in the support directory
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   228
-of the source code named \(dq\&munge\-symlinks\(dq\& that can be used to add or remove
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   229
+symlinks from being abused by prefixing \(lq/rsyncd-munged/\(rq to the start of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   230
+every symlink's value.  There is a perl script in the support directory
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   231
+of the source code named \(lqmunge-symlinks\(rq that can be used to add or remove
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   232
 this prefix from your symlinks.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   233
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   234
-When this parameter is disabled on a writable module and \(dq\&use chroot\(dq\& is off
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   235
-(or the inside\-chroot path is not \(dq\&/\(dq\&),
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   236
-incoming symlinks will be modified to drop a leading slash and to remove \(dq\&..\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   237
-path elements that rsync believes will allow a symlink to escape the module\(cq\&s
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   238
+When this parameter is disabled on a writable module and \(lquse chroot\(rq is off
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   239
+(or the inside-chroot path is not \(lq/\(rq),
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   240
+incoming symlinks will be modified to drop a leading slash and to remove \(lq..\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   241
+path elements that rsync believes will allow a symlink to escape the module's
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   242
 hierarchy.  There are tricky ways to work around this, though, so you had
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   243
 better trust your users if you choose this combination of parameters.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   244
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   245
 .IP "\fBcharset\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   246
 This specifies the name of the character set in which the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   247
-module\(cq\&s filenames are stored.  If the client uses an \fB\-\-iconv\fP option,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   248
-the daemon will use the value of the \(dq\&charset\(dq\& parameter regardless of the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   249
+module's filenames are stored.  If the client uses an \fB\-\-iconv\fP option,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   250
+the daemon will use the value of the \(lqcharset\(rq parameter regardless of the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   251
 character set the client actually passed.  This allows the daemon to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   252
 support charset conversion in a chroot module without extra files in the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   253
-chroot area, and also ensures that name\-translation is done in a consistent
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   254
-manner.  If the \(dq\&charset\(dq\& parameter is not set, the \fB\-\-iconv\fP option is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   255
-refused, just as if \(dq\&iconv\(dq\& had been specified via \(dq\&refuse options\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   256
+chroot area, and also ensures that name-translation is done in a consistent
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   257
+manner.  If the \(lqcharset\(rq parameter is not set, the \fB\-\-iconv\fP option is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   258
+refused, just as if \(lqiconv\(rq had been specified via \(lqrefuse options\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   259
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   260
 If you wish to force users to always use \fB\-\-iconv\fP for a particular
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   261
-module, add \(dq\&no\-iconv\(dq\& to the \(dq\&refuse options\(dq\& parameter.  Keep in mind
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   262
+module, add \(lqno-iconv\(rq to the \(lqrefuse options\(rq parameter.  Keep in mind
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   263
 that this will restrict access to your module to very new rsync clients.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   264
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   265
 .IP "\fBmax connections\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   266
@@ -273,21 +273,21 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   267
 Any clients connecting when the maximum has been reached will receive a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   268
 message telling them to try later.  The default is 0, which means no limit.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   269
 A negative value disables the module.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   270
-See also the \(dq\&lock file\(dq\& parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   271
+See also the \(lqlock file\(rq parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   272
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   273
 .IP "\fBlog file\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   274
-When the \(dq\&log file\(dq\& parameter is set to a non\-empty
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   275
+When the \(lqlog file\(rq parameter is set to a non-empty
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   276
 string, the rsync daemon will log messages to the indicated file rather
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   277
 than using syslog. This is particularly useful on systems (such as AIX)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   278
 where 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   279
 \f(CWsyslog()\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   280
-doesn\(cq\&t work for chrooted programs.  The file is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   281
+doesn't work for chrooted programs.  The file is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   282
 opened before 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   283
 \f(CWchroot()\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   284
 is called, allowing it to be placed outside
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   285
-the transfer.  If this value is set on a per\-module basis instead of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   286
+the transfer.  If this value is set on a per-module basis instead of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   287
 globally, the global log will still contain any authorization failures
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   288
-or config\-file error messages.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   289
+or config-file error messages.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   290
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   291
 If the daemon fails to open the specified file, it will fall back to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   292
 using syslog and output an error about the failure.  (Note that the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   293
@@ -300,19 +300,19 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   294
 defined on your system. Common names are auth, authpriv, cron, daemon,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   295
 ftp, kern, lpr, mail, news, security, syslog, user, uucp, local0,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   296
 local1, local2, local3, local4, local5, local6 and local7. The default
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   297
-is daemon.  This setting has no effect if the \(dq\&log file\(dq\& setting is a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   298
-non\-empty string (either set in the per\-modules settings, or inherited
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   299
+is daemon.  This setting has no effect if the \(lqlog file\(rq setting is a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   300
+non-empty string (either set in the per-modules settings, or inherited
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   301
 from the global settings).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   302
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   303
 .IP "\fBmax verbosity\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   304
 This parameter allows you to control
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   305
-the maximum amount of verbose information that you\(cq\&ll allow the daemon to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   306
+the maximum amount of verbose information that you'll allow the daemon to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   307
 generate (since the information goes into the log file). The default is 1,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   308
 which allows the client to request one level of verbosity.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   309
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   310
 .IP "\fBlock file\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   311
 This parameter specifies the file to use to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   312
-support the \(dq\&max connections\(dq\& parameter. The rsync daemon uses record
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   313
+support the \(lqmax connections\(rq parameter. The rsync daemon uses record
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   314
 locking on this file to ensure that the max connections limit is not
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   315
 exceeded for the modules sharing the lock file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   316
 The default is \f(CW/var/run/rsyncd.lock\fP.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   317
@@ -319,15 +319,15 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   318
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   319
 .IP "\fBread only\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   320
 This parameter determines whether clients
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   321
-will be able to upload files or not. If \(dq\&read only\(dq\& is true then any
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   322
-attempted uploads will fail. If \(dq\&read only\(dq\& is false then uploads will
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   323
+will be able to upload files or not. If \(lqread only\(rq is true then any
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   324
+attempted uploads will fail. If \(lqread only\(rq is false then uploads will
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   325
 be possible if file permissions on the daemon side allow them. The default
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   326
 is for all modules to be read only.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   327
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   328
 .IP "\fBwrite only\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   329
 This parameter determines whether clients
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   330
-will be able to download files or not. If \(dq\&write only\(dq\& is true then any
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   331
-attempted downloads will fail. If \(dq\&write only\(dq\& is false then downloads
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   332
+will be able to download files or not. If \(lqwrite only\(rq is true then any
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   333
+attempted downloads will fail. If \(lqwrite only\(rq is false then downloads
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   334
 will be possible if file permissions on the daemon side allow them.  The
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   335
 default is for this parameter to be disabled.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   336
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   337
@@ -340,19 +340,19 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   338
 .IP "\fBuid\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   339
 This parameter specifies the user name or user ID that
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   340
 file transfers to and from that module should take place as when the daemon
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   341
-was run as root. In combination with the \(dq\&gid\(dq\& parameter this determines what
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   342
+was run as root. In combination with the \(lqgid\(rq parameter this determines what
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   343
 file permissions are available. The default is uid \-2, which is normally
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   344
-the user \(dq\&nobody\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   345
+the user \(lqnobody\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   346
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   347
 .IP "\fBgid\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   348
 This parameter specifies the group name or group ID that
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   349
 file transfers to and from that module should take place as when the daemon
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   350
-was run as root. This complements the \(dq\&uid\(dq\& parameter. The default is gid \-2,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   351
-which is normally the group \(dq\&nobody\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   352
+was run as root. This complements the \(lquid\(rq parameter. The default is gid \-2,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   353
+which is normally the group \(lqnobody\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   354
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   355
 .IP "\fBfake super\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   356
-Setting \(dq\&fake super = yes\(dq\& for a module causes the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   357
-daemon side to behave as if the \fB\-\-fake\-super\fP command\-line option had
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   358
+Setting \(lqfake super = yes\(rq for a module causes the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   359
+daemon side to behave as if the \fB\-\-fake\-user\fP command-line option had
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   360
 been specified.  This allows the full attributes of a file to be stored
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   361
 without having to have the daemon actually running as root.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   362
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   363
@@ -360,7 +360,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   364
 The daemon has its own filter chain that determines what files
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   365
 it will let the client access.  This chain is not sent to the client and is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   366
 independent of any filters the client may have specified.  Files excluded by
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   367
-the daemon filter chain (\fBdaemon\-excluded\fP files) are treated as non\-existent
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   368
+the daemon filter chain (\fBdaemon-excluded\fP files) are treated as non-existent
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   369
 if the client tries to pull them, are skipped with an error message if the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   370
 client tries to push them (triggering exit code 23), and are never deleted from
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   371
 the module.  You can use daemon filters to prevent clients from downloading or
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   372
@@ -367,55 +367,55 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   373
 tampering with private administrative files, such as files you may add to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   374
 support uid/gid name translations.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   375
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   376
-The daemon filter chain is built from the \(dq\&filter\(dq\&, \(dq\&include from\(dq\&, \(dq\&include\(dq\&,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   377
-\(dq\&exclude from\(dq\&, and \(dq\&exclude\(dq\& parameters, in that order of priority.  Anchored
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   378
+The daemon filter chain is built from the \(lqfilter\(rq, \(lqinclude from\(rq, \(lqinclude\(rq,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   379
+\(lqexclude from\(rq, and \(lqexclude\(rq parameters, in that order of priority.  Anchored
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   380
 patterns are anchored at the root of the module.  To prevent access to an
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   381
-entire subtree, for example, \(dq\&/secret\(dq\&, you \fImust\fP exclude everything in the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   382
-subtree; the easiest way to do this is with a triple\-star pattern like
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   383
-\(dq\&/secret/***\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   384
+entire subtree, for example, \(lq/secret\(rq, you \fImust\fP exclude everything in the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   385
+subtree; the easiest way to do this is with a triple-star pattern like
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   386
+\(lq/secret/***\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   387
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   388
-The \(dq\&filter\(dq\& parameter takes a space\-separated list of daemon filter rules,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   389
+The \(lqfilter\(rq parameter takes a space-separated list of daemon filter rules,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   390
 though it is smart enough to know not to split a token at an internal space in
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   391
-a rule (e.g. \(dq\&\- /foo  \(em /bar\(dq\& is parsed as two rules).  You may specify one or
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   392
-more merge\-file rules using the normal syntax.  Only one \(dq\&filter\(dq\& parameter can
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   393
+a rule (e.g. \(lq\- /foo  \(em /bar\(rq is parsed as two rules).  You may specify one or
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   394
+more merge-file rules using the normal syntax.  Only one \(lqfilter\(rq parameter can
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   395
 apply to a given module in the config file, so put all the rules you want in a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   396
-single parameter.  Note that per\-directory merge\-file rules do not provide as
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   397
+single parameter.  Note that per-directory merge-file rules do not provide as
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   398
 much protection as global rules, but they can be used to make \fB\-\-delete\fP work
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   399
-better during a client download operation if the per\-dir merge files are
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   400
+better during a client download operation if the per-dir merge files are
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   401
 included in the transfer and the client requests that they be used.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   402
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   403
 .IP "\fBexclude\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   404
-This parameter takes a space\-separated list of daemon
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   405
+This parameter takes a space-separated list of daemon
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   406
 exclude patterns.  As with the client \fB\-\-exclude\fP option, patterns can be
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   407
-qualified with \(dq\&\- \(dq\& or \(dq\&+ \(dq\& to explicitly indicate exclude/include.  Only one
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   408
-\(dq\&exclude\(dq\& parameter can apply to a given module.  See the \(dq\&filter\(dq\& parameter
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   409
+qualified with \(lq\- \(rq or \(lq+ \(rq to explicitly indicate exclude/include.  Only one
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   410
+\(lqexclude\(rq parameter can apply to a given module.  See the \(lqfilter\(rq parameter
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   411
 for a description of how excluded files affect the daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   412
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   413
 .IP "\fBinclude\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   414
-Use an \(dq\&include\(dq\& to override the effects of the \(dq\&exclude\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   415
-parameter.  Only one \(dq\&include\(dq\& parameter can apply to a given module.  See the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   416
-\(dq\&filter\(dq\& parameter for a description of how excluded files affect the daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   417
+Use an \(lqinclude\(rq to override the effects of the \(lqexclude\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   418
+parameter.  Only one \(lqinclude\(rq parameter can apply to a given module.  See the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   419
+\(lqfilter\(rq parameter for a description of how excluded files affect the daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   420
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   421
 .IP "\fBexclude from\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   422
 This parameter specifies the name of a file
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   423
 on the daemon that contains daemon exclude patterns, one per line.  Only one
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   424
-\(dq\&exclude from\(dq\& parameter can apply to a given module; if you have multiple
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   425
-exclude\-from files, you can specify them as a merge file in the \(dq\&filter\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   426
-parameter.  See the \(dq\&filter\(dq\& parameter for a description of how excluded files
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   427
+\(lqexclude from\(rq parameter can apply to a given module; if you have multiple
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   428
+exclude-from files, you can specify them as a merge file in the \(lqfilter\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   429
+parameter.  See the \(lqfilter\(rq parameter for a description of how excluded files
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   430
 affect the daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   431
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   432
 .IP "\fBinclude from\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   433
-Analogue of \(dq\&exclude from\(dq\& for a file of daemon include
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   434
-patterns.  Only one \(dq\&include from\(dq\& parameter can apply to a given module.  See
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   435
-the \(dq\&filter\(dq\& parameter for a description of how excluded files affect the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   436
+Analogue of \(lqexclude from\(rq for a file of daemon include
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   437
+patterns.  Only one \(lqinclude from\(rq parameter can apply to a given module.  See
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   438
+the \(lqfilter\(rq parameter for a description of how excluded files affect the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   439
 daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   440
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   441
 .IP "\fBincoming chmod\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   442
 This parameter allows you to specify a set of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   443
-comma\-separated chmod strings that will affect the permissions of all
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   444
+comma-separated chmod strings that will affect the permissions of all
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   445
 incoming files (files that are being received by the daemon).  These
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   446
 changes happen after all other permission calculations, and this will
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   447
-even override destination\-default and/or existing permissions when the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   448
+even override destination-default and/or existing permissions when the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   449
 client does not specify \fB\-\-perms\fP.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   450
 See the description of the \fB\-\-chmod\fP rsync option and the \fBchmod\fP(1)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   451
 manpage for information on the format of this string.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   452
@@ -422,7 +422,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   453
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   454
 .IP "\fBoutgoing chmod\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   455
 This parameter allows you to specify a set of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   456
-comma\-separated chmod strings that will affect the permissions of all
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   457
+comma-separated chmod strings that will affect the permissions of all
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   458
 outgoing files (files that are being sent out from the daemon).  These
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   459
 changes happen first, making the sent permissions appear to be different
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   460
 than those stored in the filesystem itself.  For instance, you could
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   461
@@ -433,41 +433,41 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   462
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   463
 .IP "\fBauth users\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   464
 This parameter specifies a comma and
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   465
-space\-separated list of usernames that will be allowed to connect to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   466
+space-separated list of usernames that will be allowed to connect to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   467
 this module. The usernames do not need to exist on the local
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   468
 system. The usernames may also contain shell wildcard characters. If
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   469
-\(dq\&auth users\(dq\& is set then the client will be challenged to supply a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   470
+\(lqauth users\(rq is set then the client will be challenged to supply a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   471
 username and password to connect to the module. A challenge response
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   472
 authentication protocol is used for this exchange. The plain text
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   473
 usernames and passwords are stored in the file specified by the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   474
-\(dq\&secrets file\(dq\& parameter. The default is for all users to be able to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   475
-connect without a password (this is called \(dq\&anonymous rsync\(dq\&).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   476
+\(lqsecrets file\(rq parameter. The default is for all users to be able to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   477
+connect without a password (this is called \(lqanonymous rsync\(rq).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   478
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   479
-See also the section entitled \(dq\&USING RSYNC\-DAEMON FEATURES VIA A REMOTE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   480
-SHELL CONNECTION\(dq\& in \fBrsync\fP(1) for information on how handle an
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   481
-rsyncd.conf\-level username that differs from the remote\-shell\-level
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   482
+See also the \(lqCONNECTING TO AN RSYNC DAEMON OVER A REMOTE SHELL
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   483
+PROGRAM\(rq section in \fBrsync\fP(1) for information on how handle an
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   484
+rsyncd.conf\-level username that differs from the remote-shell-level
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   485
 username when using a remote shell to connect to an rsync daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   486
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   487
 .IP "\fBsecrets file\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   488
 This parameter specifies the name of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   489
 a file that contains the username:password pairs used for
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   490
-authenticating this module. This file is only consulted if the \(dq\&auth
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   491
-users\(dq\& parameter is specified. The file is line based and contains
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   492
+authenticating this module. This file is only consulted if the \(lqauth
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   493
+users\(rq parameter is specified. The file is line based and contains
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   494
 username:password pairs separated by a single colon. Any line starting
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   495
 with a hash (#) is considered a comment and is skipped. The passwords
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   496
 can contain any characters but be warned that many operating systems
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   497
 limit the length of passwords that can be typed at the client end, so
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   498
-you may find that passwords longer than 8 characters don\(cq\&t work.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   499
+you may find that passwords longer than 8 characters don't work.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   500
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   501
-There is no default for the \(dq\&secrets file\(dq\& parameter, you must choose a name
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   502
+There is no default for the \(lqsecrets file\(rq parameter, you must choose a name
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   503
 (such as \f(CW/etc/rsyncd.secrets\fP).  The file must normally not be readable
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   504
-by \(dq\&other\(dq\&; see \(dq\&strict modes\(dq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   505
+by \(lqother\(rq; see \(lqstrict modes\(rq.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   506
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   507
 .IP "\fBstrict modes\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   508
 This parameter determines whether or not
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   509
-the permissions on the secrets file will be checked.  If \(dq\&strict modes\(dq\& is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   510
+the permissions on the secrets file will be checked.  If \(lqstrict modes\(rq is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   511
 true, then the secrets file must not be readable by any user ID other
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   512
-than the one that the rsync daemon is running under.  If \(dq\&strict modes\(dq\& is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   513
+than the one that the rsync daemon is running under.  If \(lqstrict modes\(rq is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   514
 false, the check is not performed.  The default is true.  This parameter
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   515
 was added to accommodate rsync running on the Windows operating system.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   516
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   517
@@ -482,7 +482,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   518
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   519
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   520
 a dotted decimal IPv4 address of the form a.b.c.d, or an IPv6 address
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   521
-of the form a:b:c::d:e:f. In this case the incoming machine\(cq\&s IP address
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   522
+of the form a:b:c::d:e:f. In this case the incoming machine's IP address
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   523
 must match exactly.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   524
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   525
 an address/mask in the form ipaddr/n where ipaddr is the IP address
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   526
@@ -504,7 +504,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   527
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   528
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   529
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   530
-Note IPv6 link\-local addresses can have a scope in the address specification:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   531
+Note IPv6 link-local addresses can have a scope in the address specification:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   532
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   533
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   534
 \f(CW    fe80::1%link1\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   535
@@ -516,23 +516,23 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   536
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   537
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   538
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   539
-You can also combine \(dq\&hosts allow\(dq\& with a separate \(dq\&hosts deny\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   540
-parameter. If both parameters are specified then the \(dq\&hosts allow\(dq\& parameter is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   541
+You can also combine \(lqhosts allow\(rq with a separate \(lqhosts deny\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   542
+parameter. If both parameters are specified then the \(lqhosts allow\(rq parameter is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   543
 checked first and a match results in the client being able to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   544
-connect. The \(dq\&hosts deny\(dq\& parameter is then checked and a match means
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   545
+connect. The \(lqhosts deny\(rq parameter is then checked and a match means
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   546
 that the host is rejected. If the host does not match either the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   547
-\(dq\&hosts allow\(dq\& or the \(dq\&hosts deny\(dq\& patterns then it is allowed to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   548
+\(lqhosts allow\(rq or the \(lqhosts deny\(rq patterns then it is allowed to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   549
 connect.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   550
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   551
-The default is no \(dq\&hosts allow\(dq\& parameter, which means all hosts can connect.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   552
+The default is no \(lqhosts allow\(rq parameter, which means all hosts can connect.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   553
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   554
 .IP "\fBhosts deny\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   555
 This parameter allows you to specify a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   556
 list of patterns that are matched against a connecting clients
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   557
 hostname and IP address. If the pattern matches then the connection is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   558
-rejected. See the \(dq\&hosts allow\(dq\& parameter for more information.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   559
+rejected. See the \(lqhosts allow\(rq parameter for more information.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   560
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   561
-The default is no \(dq\&hosts deny\(dq\& parameter, which means all hosts can connect.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   562
+The default is no \(lqhosts deny\(rq parameter, which means all hosts can connect.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   563
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   564
 .IP "\fBignore errors\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   565
 This parameter tells rsyncd to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   566
@@ -546,32 +546,32 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   567
 .IP "\fBignore nonreadable\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   568
 This tells the rsync daemon to completely
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   569
 ignore files that are not readable by the user. This is useful for
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   570
-public archives that may have some non\-readable files among the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   571
-directories, and the sysadmin doesn\(cq\&t want those files to be seen at all.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   572
+public archives that may have some non-readable files among the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   573
+directories, and the sysadmin doesn't want those files to be seen at all.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   574
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   575
 .IP "\fBtransfer logging\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   576
-This parameter enables per\-file
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   577
+This parameter enables per-file
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   578
 logging of downloads and uploads in a format somewhat similar to that
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   579
 used by ftp daemons.  The daemon always logs the transfer at the end, so
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   580
 if a transfer is aborted, no mention will be made in the log file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   581
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   582
-If you want to customize the log lines, see the \(dq\&log format\(dq\& parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   583
+If you want to customize the log lines, see the \(lqlog format\(rq parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   584
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   585
 .IP "\fBlog format\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   586
 This parameter allows you to specify the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   587
 format used for logging file transfers when transfer logging is enabled.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   588
-The format is a text string containing embedded single\-character escape
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   589
+The format is a text string containing embedded single-character escape
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   590
 sequences prefixed with a percent (%) character.  An optional numeric
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   591
 field width may also be specified between the percent and the escape
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   592
-letter (e.g. \(dq\&\fB%\-50n %8l %07p\fP\(dq\&).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   593
+letter (e.g. \(lq\fB%\-50n %8l %07p\fP\(rq).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   594
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   595
-The default log format is \(dq\&%o %h [%a] %m (%u) %f %l\(dq\&, and a \(dq\&%t [%p] \(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   596
-is always prefixed when using the \(dq\&log file\(dq\& parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   597
+The default log format is \(lq%o %h [%a] %m (%u) %f %l\(rq, and a \(lq%t [%p] \(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   598
+is always prefixed when using the \(lqlog file\(rq parameter.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   599
 (A perl script that will summarize this default log format is included
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   600
-in the rsync source code distribution in the \(dq\&support\(dq\& subdirectory:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   601
+in the rsync source code distribution in the \(lqsupport\(rq subdirectory:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   602
 rsyncstats.)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   603
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   604
-The single\-character escapes that are understood are as follows:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   605
+The single-character escapes that are understood are as follows:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   606
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   607
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   608
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   609
@@ -583,9 +583,9 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   610
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   611
 %c the total size of the block checksums received for the basis file (only when sending)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   612
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   613
-%f the filename (long form on sender; no trailing \(dq\&/\(dq\&)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   614
+%f the filename (long form on sender; no trailing \(lq/\(rq)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   615
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   616
-%G the gid of the file (decimal) or \(dq\&DEFAULT\(dq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   617
+%G the gid of the file (decimal) or \(lqDEFAULT\(rq
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   618
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   619
 %h the remote host name
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   620
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   621
@@ -593,15 +593,15 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   622
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   623
 %l the length of the file in bytes
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   624
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   625
-%L the string \(dq\& \-> SYMLINK\(dq\&, \(dq\& => HARDLINK\(dq\&, or \(dq\&\(dq\& (where \fBSYMLINK\fP or \fBHARDLINK\fP is a filename)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   626
+%L the string \(lq \-> SYMLINK\(rq, \(lq => HARDLINK\(rq, or \(lq\(rq (where \fBSYMLINK\fP or \fBHARDLINK\fP is a filename)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   627
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   628
 %m the module name
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   629
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   630
-%M the last\-modified time of the file
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   631
+%M the last-modified time of the file
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   632
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   633
-%n the filename (short form; trailing \(dq\&/\(dq\& on dir)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   634
+%n the filename (short form; trailing \(lq/\(rq on dir)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   635
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   636
-%o the operation, which is \(dq\&send\(dq\&, \(dq\&recv\(dq\&, or \(dq\&del.\(dq\& (the latter includes the trailing period)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   637
+%o the operation, which is \(lqsend\(rq, \(lqrecv\(rq, or \(lqdel.\(rq (the latter includes the trailing period)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   638
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   639
 %p the process ID of this rsync session
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   640
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   641
@@ -615,7 +615,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   642
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   643
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   644
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   645
-For a list of what the characters mean that are output by \(dq\&%i\(dq\&, see the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   646
+For a list of what the characters mean that are output by \(lq%i\(rq, see the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   647
 \fB\-\-itemize\-changes\fP option in the rsync manpage.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   648
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   649
 Note that some of the logged output changes when talking with older
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   650
@@ -625,7 +625,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   651
 .IP "\fBtimeout\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   652
 This parameter allows you to override the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   653
 clients choice for I/O timeout for this module. Using this parameter you
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   654
-can ensure that rsync won\(cq\&t wait on a dead client forever. The timeout
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   655
+can ensure that rsync won't wait on a dead client forever. The timeout
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   656
 is specified in seconds. A value of zero means no timeout and is the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   657
 default. A good choice for anonymous rsync daemons may be 600 (giving
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   658
 a 10 minute timeout).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   659
@@ -632,10 +632,10 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   660
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   661
 .IP "\fBrefuse options\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   662
 This parameter allows you to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   663
-specify a space\-separated list of rsync command line options that will
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   664
+specify a space-separated list of rsync command line options that will
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   665
 be refused by your rsync daemon.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   666
-You may specify the full option name, its one\-letter abbreviation, or a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   667
-wild\-card string that matches multiple options.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   668
+You may specify the full option name, its one-letter abbreviation, or a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   669
+wild-card string that matches multiple options.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   670
 For example, this would refuse \fB\-\-checksum\fP (\fB\-c\fP) and all the various
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   671
 delete options:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   672
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   673
@@ -646,15 +646,15 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   674
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   675
 The reason the above refuses all delete options is that the options imply
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   676
 \fB\-\-delete\fP, and implied options are refused just like explicit options.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   677
-As an additional safety feature, the refusal of \(dq\&delete\(dq\& also refuses
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   678
-\fBremove\-source\-files\fP when the daemon is the sender; if you want the latter
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   679
-without the former, instead refuse \(dq\&delete\-*\(dq\& \-\- that refuses all the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   680
+As an additional safety feature, the refusal of \(lqdelete\(rq also refuses
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   681
+\fBremove-source-files\fP when the daemon is the sender; if you want the latter
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   682
+without the former, instead refuse \(lqdelete\-*\(rq \(em that refuses all the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   683
 delete modes without affecting \fB\-\-remove\-source\-files\fP.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   684
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   685
 When an option is refused, the daemon prints an error message and exits.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   686
 To prevent all compression when serving files,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   687
-you can use \(dq\&dont compress = *\(dq\& (see below)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   688
-instead of \(dq\&refuse options = compress\(dq\& to avoid returning an error to a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   689
+you can use \(lqdont compress = *\(rq (see below)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   690
+instead of \(lqrefuse options = compress\(rq to avoid returning an error to a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   691
 client that requests compression.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   692
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   693
 .IP "\fBdont compress\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   694
@@ -663,25 +663,25 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   695
 when pulling files from the daemon (no analogous parameter exists to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   696
 govern the pushing of files to a daemon).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   697
 Compression is expensive in terms of CPU usage, so it
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   698
-is usually good to not try to compress files that won\(cq\&t compress well,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   699
+is usually good to not try to compress files that won't compress well,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   700
 such as already compressed files.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   701
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   702
-The \(dq\&dont compress\(dq\& parameter takes a space\-separated list of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   703
-case\-insensitive wildcard patterns. Any source filename matching one
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   704
+The \(lqdont compress\(rq parameter takes a space-separated list of
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   705
+case-insensitive wildcard patterns. Any source filename matching one
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   706
 of the patterns will not be compressed during transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   707
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   708
 See the \fB\-\-skip\-compress\fP parameter in the \fBrsync\fP(1) manpage for the list
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   709
 of file suffixes that are not compressed by default.  Specifying a value
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   710
-for the \(dq\&dont compress\(dq\& parameter changes the default when the daemon is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   711
+for the \(lqdont compress\(rq parameter changes the default when the daemon is
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   712
 the sender.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   713
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   714
-.IP "\fBpre\-xfer exec\fP, \fBpost\-xfer exec\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   715
+.IP "\fBpre-xfer exec\fP, \fBpost-xfer exec\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   716
 You may specify a command to be run
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   717
-before and/or after the transfer.  If the \fBpre\-xfer exec\fP command fails, the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   718
+before and/or after the transfer.  If the \fBpre-xfer exec\fP command fails, the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   719
 transfer is aborted before it begins.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   720
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   721
 The following environment variables will be set, though some are
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   722
-specific to the pre\-xfer or the post\-xfer environment:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   723
+specific to the pre-xfer or the post-xfer environment:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   724
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   725
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   726
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   727
@@ -689,29 +689,29 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   728
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   729
 \fBRSYNC_MODULE_PATH\fP: The path configured for the module.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   730
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   731
-\fBRSYNC_HOST_ADDR\fP: The accessing host\(cq\&s IP address.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   732
+\fBRSYNC_HOST_ADDR\fP: The accessing host's IP address.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   733
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   734
-\fBRSYNC_HOST_NAME\fP: The accessing host\(cq\&s name.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   735
+\fBRSYNC_HOST_NAME\fP: The accessing host's name.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   736
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   737
-\fBRSYNC_USER_NAME\fP: The accessing user\(cq\&s name (empty if no user).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   738
+\fBRSYNC_USER_NAME\fP: The accessing user's name (empty if no user).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   739
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   740
 \fBRSYNC_PID\fP: A unique number for this transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   741
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   742
-\fBRSYNC_REQUEST\fP: (pre\-xfer only) The module/path info specified
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   743
+\fBRSYNC_REQUEST\fP: (pre-xfer only) The module/path info specified
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   744
 by the user (note that the user can specify multiple source files,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   745
-so the request can be something like \(dq\&mod/path1 mod/path2\(dq\&, etc.).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   746
+so the request can be something like \(lqmod/path1 mod/path2\(rq, etc.).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   747
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   748
-\fBRSYNC_ARG#\fP: (pre\-xfer only) The pre\-request arguments are set
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   749
-in these numbered values. RSYNC_ARG0 is always \(dq\&rsyncd\(dq\&, and the last
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   750
+\fBRSYNC_ARG#\fP: (pre-xfer only) The pre-request arguments are set
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   751
+in these numbered values. RSYNC_ARG0 is always \(lqrsyncd\(rq, and the last
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   752
 value contains a single period.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   753
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   754
-\fBRSYNC_EXIT_STATUS\fP: (post\-xfer only) the server side\(cq\&s exit value.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   755
+\fBRSYNC_EXIT_STATUS\fP: (post-xfer only) the server side's exit value.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   756
 This will be 0 for a successful run, a positive value for an error that the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   757
 server generated, or a \-1 if rsync failed to exit properly.  Note that an
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   758
 error that occurs on the client side does not currently get sent to the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   759
 server side, so this is not the final exit status for the whole transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   760
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   761
-\fBRSYNC_RAW_STATUS\fP: (post\-xfer only) the raw exit value from 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   762
+\fBRSYNC_RAW_STATUS\fP: (post-xfer only) the raw exit value from 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   763
 \f(CWwaitpid()\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   764
 \&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   765
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   766
@@ -719,7 +719,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   767
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   768
 Even though the commands can be associated with a particular module, they
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   769
 are run using the permissions of the user that started the daemon (not the
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   770
-module\(cq\&s uid/gid setting) without any chroot restrictions.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   771
+module's uid/gid setting) without any chroot restrictions.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   772
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   773
 .SH "AUTHENTICATION STRENGTH"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   774
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   775
@@ -726,8 +726,8 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   776
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   777
 The authentication protocol used in rsync is a 128 bit MD4 based
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   778
 challenge response system. This is fairly weak protection, though (with
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   779
-at least one brute\-force hash\-finding algorithm publicly available), so
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   780
-if you want really top\-quality security, then I recommend that you run
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   781
+at least one brute-force hash-finding algorithm publicly available), so
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   782
+if you want really top-quality security, then I recommend that you run
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   783
 rsync over ssh.  (Yes, a future version of rsync will switch over to a
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   784
 stronger hashing method.)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   785
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   786
@@ -822,7 +822,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   787
 .SH "VERSION"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   788
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   789
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   790
-This man page is current for version 3.0.8 of rsync.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   791
+This man page is current for version 3.0.6 of rsync.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   792
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   793
 .SH "CREDITS"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   794
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   795
@@ -838,7 +838,7 @@
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   796
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   797
 We would be delighted to hear from you if you like this program.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   798
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   799
-This program uses the zlib compression library written by Jean\-loup
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   800
+This program uses the zlib compression library written by Jean-loup
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   801
 Gailly and Mark Adler.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   802
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   803
 .SH "THANKS"