author | Melynda Hunter <melynda.hunter@oracle.com> |
Wed, 10 Apr 2013 16:22:00 -0700 | |
branch | s11u1-sru |
changeset 2564 | 0460071dd4dd |
parent 297 | 3940bc347ca8 |
child 1351 | 5c589218fa09 |
permissions | -rw-r--r-- |
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" |