author | Danek Duvall <danek.duvall@oracle.com> |
Mon, 07 Apr 2014 12:48:54 -0700 | |
changeset 1817 | ff42a83716c4 |
parent 1351 | 5c589218fa09 |
child 3835 | fff36af96643 |
permissions | -rw-r--r-- |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1 |
Remove groffisms from the man page. This changes "\(dq" to a double-quote |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2 |
character ("), "\(cq" to a single-quote character ('), and eliminates the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
3 |
use of "\&" except where it's needed at the beginning of the line. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
4 |
|
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
5 |
--- rsync-3.1.0/rsync.1.orig Sat Sep 28 20:01:03 2013 |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
6 |
+++ rsync-3.1.0/rsync.1 Mon Mar 17 15:51:13 2014 |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
7 |
@@ -35,11 +35,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
8 |
destination. Rsync is widely used for backups and mirroring and as an |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
9 |
improved copy command for everyday use. |
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 |
-Rsync finds files that need to be transferred using a \(dq\&quick check\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
12 |
+Rsync finds files that need to be transferred using a "quick check" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
13 |
algorithm (by default) that looks for files that have changed in size or |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
14 |
in last\-modified time. Any changes in the other preserved attributes (as |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
15 |
requested by options) are made on the destination file directly when the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
16 |
-quick check indicates that the file\(cq\&s data does not need to be updated. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
17 |
+quick check indicates that the file's data does not need to be updated. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
18 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
19 |
Some of the additional features of rsync are: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
20 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
21 |
@@ -73,17 +73,17 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
22 |
a host specification. Contacting an rsync daemon directly happens when the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
23 |
source or destination path contains a double colon (::) separator after a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
24 |
host specification, OR when an rsync:// URL is specified (see also the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
25 |
-\(dq\&USING RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& section for |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
26 |
+"USING RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION" section for |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
27 |
an exception to this latter rule). |
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 |
As a special case, if a single source arg is specified without a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
30 |
-destination, the files are listed in an output format similar to \(dq\&ls \-l\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
31 |
+destination, the files are listed in an output format similar to "ls \-l". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
32 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
33 |
As expected, if neither the source or destination path specify a remote |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
34 |
host, the copy occurs locally (see also the \fB\-\-list\-only\fP option). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
35 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
36 |
-Rsync refers to the local side as the \(dq\&client\(dq\& and the remote side as the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
37 |
-\(dq\&server\(dq\&. Don\(cq\&t confuse \(dq\&server\(dq\& with an rsync daemon \-\- a daemon is always a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
38 |
+Rsync refers to the local side as the "client" and the remote side as the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
39 |
+"server". Don't confuse "server" with an rsync daemon \-\- a daemon is always a |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
40 |
server, but a server can be either a daemon or a remote\-shell spawned process. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
41 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
42 |
.SH "SETUP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
43 |
@@ -129,7 +129,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
44 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
45 |
This would recursively transfer all files from the directory src/bar on the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
46 |
machine foo into the /data/tmp/bar directory on the local machine. The |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
47 |
-files are transferred in \(dq\&archive\(dq\& mode, which ensures that symbolic |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
48 |
+files are transferred in "archive" mode, which ensures that symbolic |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
49 |
links, devices, attributes, permissions, ownerships, etc. are preserved |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
50 |
in the transfer. Additionally, compression will be used to reduce the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
51 |
size of data portions of the transfer. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
52 |
@@ -141,8 +141,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
53 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
54 |
A trailing slash on the source changes this behavior to avoid creating an |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
55 |
additional directory level at the destination. You can think of a trailing |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
56 |
-/ on a source as meaning \(dq\© the contents of this directory\(dq\& as opposed |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
57 |
-to \(dq\© the directory by name\(dq\&, but in both cases the attributes of the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
58 |
+/ on a source as meaning "copy the contents of this directory" as opposed |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
59 |
+to "copy the directory by name", but in both cases the attributes of the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
60 |
containing directory are transferred to the containing directory on the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
61 |
destination. In other words, each of the following commands copies the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
62 |
files in the same way, including their setting of the attributes of |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
63 |
@@ -156,9 +156,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
64 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
65 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
66 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
67 |
-Note also that host and module references don\(cq\&t require a trailing slash to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
68 |
+Note also that host and module references don't require a trailing slash to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
69 |
copy the contents of the default directory. For example, both of these |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
70 |
-copy the remote directory\(cq\&s contents into \(dq\&/dest\(dq\&: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
71 |
+copy the remote directory's contents into "/dest": |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
72 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
73 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
74 |
\f(CWrsync \-av host: /dest\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
75 |
@@ -169,7 +169,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
76 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
77 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
78 |
You can also use rsync in local\-only mode, where both the source and |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
79 |
-destination don\(cq\&t have a \(cq\&:\(cq\& in the name. In this case it behaves like |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
80 |
+destination don't have a ':' in the name. In this case it behaves like |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
81 |
an improved copy command. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
82 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
83 |
Finally, you can list all the (listable) modules available from a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
84 |
@@ -202,9 +202,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
85 |
examples: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
86 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
87 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
88 |
-\f(CWrsync \-av host:'\&dir1/file1 dir2/file2'\& /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
89 |
+\f(CWrsync \-av host:'dir1/file1 dir2/file2' /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
90 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
91 |
-\f(CWrsync host::'\&modname/dir1/file1 modname/dir2/file2'\& /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
92 |
+\f(CWrsync host::'modname/dir1/file1 modname/dir2/file2' /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
93 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
94 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
95 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
96 |
@@ -212,12 +212,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
97 |
not as easy to use as the first method. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
98 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
99 |
If you need to transfer a filename that contains whitespace, you can either |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
100 |
-specify the \fB\-\-protect\-args\fP (\fB\-s\fP) option, or you\(cq\&ll need to escape |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
101 |
+specify the \fB\-\-protect\-args\fP (\fB\-s\fP) option, or you'll need to escape |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
102 |
the whitespace in a way that the remote shell will understand. For |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
103 |
instance: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
104 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
105 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
106 |
-\f(CWrsync \-av host:'\&file\e name\e with\e spaces'\& /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
107 |
+\f(CWrsync \-av host:'file\e name\e with\e spaces' /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
108 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
109 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
110 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
111 |
@@ -237,7 +237,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
112 |
you either use a double colon :: instead of a single colon to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
113 |
separate the hostname from the path, or you use an rsync:// URL. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
114 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
115 |
-the first word of the \(dq\&path\(dq\& is actually a module name. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
116 |
+the first word of the "path" is actually a module name. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
117 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
118 |
the remote daemon may print a message of the day when you |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
119 |
connect. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
120 |
@@ -251,7 +251,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
121 |
you must not specify the \fB\-\-rsh\fP (\fB\-e\fP) option. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
122 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
123 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
124 |
-An example that copies all the files in a remote module named \(dq\&src\(dq\&: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
125 |
+An example that copies all the files in a remote module named "src": |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
126 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
127 |
.nf |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
128 |
rsync \-av host::src /dest |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
129 |
@@ -269,18 +269,18 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
130 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
131 |
You may establish the connection via a web proxy by setting the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
132 |
environment variable RSYNC_PROXY to a hostname:port pair pointing to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
133 |
-your web proxy. Note that your web proxy\(cq\&s configuration must support |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
134 |
+your web proxy. Note that your web proxy's configuration must support |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
135 |
proxy connections to port 873. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
136 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
137 |
You may also establish a daemon connection using a program as a proxy by |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
138 |
setting the environment variable RSYNC_CONNECT_PROG to the commands you |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
139 |
wish to run in place of making a direct socket connection. The string may |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
140 |
-contain the escape \(dq\&%H\(dq\& to represent the hostname specified in the rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
141 |
-command (so use \(dq\&%%\(dq\& if you need a single \(dq\&%\(dq\& in your string). For |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
142 |
+contain the escape "%H" to represent the hostname specified in the rsync |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
143 |
+command (so use "%%" if you need a single "%" in your string). For |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
144 |
example: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
145 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
146 |
.nf |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
147 |
- export RSYNC_CONNECT_PROG='\&ssh proxyhost nc %H 873'\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
148 |
+ export RSYNC_CONNECT_PROG='ssh proxyhost nc %H 873' |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
149 |
rsync \-av targethost1::module/src/ /dest/ |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
150 |
rsync \-av rsync:://targethost2/module/src/ /dest/ |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
151 |
.fi |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
152 |
@@ -297,16 +297,16 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
153 |
named modules) without actually allowing any new socket connections into a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
154 |
system (other than what is already required to allow remote\-shell access). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
155 |
Rsync supports connecting to a host using a remote shell and then spawning |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
156 |
-a single\-use \(dq\&daemon\(dq\& server that expects to read its config file in the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
157 |
+a single\-use "daemon" server that expects to read its config file in the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
158 |
home dir of the remote user. This can be useful if you want to encrypt a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
159 |
-daemon\-style transfer\(cq\&s data, but since the daemon is started up fresh by |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
160 |
+daemon\-style transfer's data, but since the daemon is started up fresh by |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
161 |
the remote user, you may not be able to use features such as chroot or |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
162 |
change the uid used by the daemon. (For another way to encrypt a daemon |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
163 |
transfer, consider using ssh to tunnel a local port to a remote machine and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
164 |
configure a normal rsync daemon on that remote host to only allow |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
165 |
-connections from \(dq\&localhost\(dq\&.) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
166 |
+connections from "localhost".) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
167 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
168 |
-From the user\(cq\&s perspective, a daemon transfer via a remote\-shell |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
169 |
+From the user's perspective, a daemon transfer via a remote\-shell |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
170 |
connection uses nearly the same command\-line syntax as a normal |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
171 |
rsync\-daemon transfer, with the only exception being that you must |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
172 |
explicitly set the remote shell program on the command\-line with the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
173 |
@@ -321,19 +321,23 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
174 |
If you need to specify a different remote\-shell user, keep in mind that the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
175 |
user@ prefix in front of the host is specifying the rsync\-user value (for a |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
176 |
module that requires user\-based authentication). This means that you must |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
177 |
-give the \(cq\&\-l user\(cq\& option to ssh when specifying the remote\-shell, as in |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
178 |
+give the '\-l user' option to ssh when specifying the remote\-shell, as in |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
179 |
this example that uses the short version of the \fB\-\-rsh\fP option: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
180 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
181 |
.nf |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
182 |
- rsync \-av \-e \(dq\&ssh \-l ssh\-user\(dq\& rsync\-user@host::module /dest |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
183 |
+ rsync \-av \-e "ssh \-l ssh\-user" rsync\-user@host::module /dest |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
184 |
.fi |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
185 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
186 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
187 |
-The \(dq\&ssh\-user\(dq\& will be used at the ssh level; the \(dq\&rsync\-user\(dq\& will be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
188 |
-used to log\-in to the \(dq\&module\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
189 |
+The "ssh\-user" will be used at the ssh level; the "rsync\-user" will be |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
190 |
+used to log\-in to the "module". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
191 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
192 |
.SH "STARTING AN RSYNC DAEMON TO ACCEPT CONNECTIONS" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
193 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
194 |
+.PP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
195 |
+WARNING: Daemon mode does not participate in the core Solaris security |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
196 |
+policies, including Authentication, limit of privileges, Audit and Audit |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
197 |
+of any subprocessing. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
198 |
.PP |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
199 |
In order to connect to an rsync daemon, the remote system needs to have a |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
200 |
daemon already running (or it needs to have configured something like inetd |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
201 |
@@ -343,7 +347,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
202 |
file for the daemon, and it contains the full details for how to run the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
203 |
daemon (including stand\-alone and inetd configurations). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
204 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
205 |
-If you\(cq\&re using one of the remote\-shell transports for the transfer, there is |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
206 |
+If you're using one of the remote\-shell transports for the transfer, there is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
207 |
no need to manually start an rsync daemon. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
208 |
.PP |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
209 |
.SH "SORTED TRANSFER ORDER" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
210 |
@@ -357,7 +361,7 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
211 |
.PP |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
212 |
If you need a particular file to be transferred prior to another, either |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
213 |
separate the files into different rsync calls, or consider using |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
214 |
-\fB\-\-delay\-updates\fP (which doesn\(cq\&t affect the sorted transfer order, but |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
215 |
+\fB\-\-delay\-updates\fP (which doesn't affect the sorted transfer order, but |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
216 |
does make the final file\-updating phase happen much more rapidly). |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
217 |
.PP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
218 |
.SH "EXAMPLES" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
219 |
@@ -365,7 +369,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
220 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
221 |
Here are some examples of how I use rsync. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
222 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
223 |
-To backup my wife\(cq\&s home directory, which consists of large MS Word |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
224 |
+To backup my wife's home directory, which consists of large MS Word |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
225 |
files and mail folders, I use a cron job that runs |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
226 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
227 |
.RS |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
228 |
@@ -374,7 +378,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
229 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
230 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
231 |
each night over a PPP connection to a duplicate directory on my machine |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
232 |
-\(dq\&arvidsjaur\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
233 |
+"arvidsjaur". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
234 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
235 |
To synchronize my samba source trees I use the following Makefile |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
236 |
targets: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
237 |
@@ -381,7 +385,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
238 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
239 |
.nf |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
240 |
get: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
241 |
- rsync \-avuzb \-\-exclude '\&*~'\& samba:samba/ . |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
242 |
+ rsync \-avuzb \-\-exclude '*~' samba:samba/ . |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
243 |
put: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
244 |
rsync \-Cavuzb . samba:samba/ |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
245 |
sync: get put |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
246 |
@@ -390,12 +394,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
247 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
248 |
this allows me to sync with a CVS directory at the other end of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
249 |
connection. I then do CVS operations on the remote machine, which saves a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
250 |
-lot of time as the remote CVS protocol isn\(cq\&t very efficient. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
251 |
+lot of time as the remote CVS protocol isn't very efficient. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
252 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
253 |
-I mirror a directory between my \(dq\&old\(dq\& and \(dq\&new\(dq\& ftp sites with the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
254 |
+I mirror a directory between my "old" and "new" ftp sites with the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
255 |
command: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
256 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
257 |
-\f(CWrsync \-az \-e ssh \-\-delete ~ftp/pub/samba nimbus:\(dq\&~ftp/pub/tridge\(dq\&\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
258 |
+\f(CWrsync \-az \-e ssh \-\-delete ~ftp/pub/samba nimbus:"~ftp/pub/tridge"\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
259 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
260 |
This is launched from cron every few hours. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
261 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
262 |
@@ -417,7 +421,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
263 |
\-\-no\-OPTION turn off an implied OPTION (e.g. \-\-no\-D) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
264 |
\-r, \-\-recursive recurse into directories |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
265 |
\-R, \-\-relative use relative path names |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
266 |
- \-\-no\-implied\-dirs don'\&t send implied dirs with \-\-relative |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
267 |
+ \-\-no\-implied\-dirs don't send implied dirs with \-\-relative |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
268 |
\-b, \-\-backup make backups (see \-\-suffix & \-\-backup\-dir) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
269 |
\-\-backup\-dir=DIR make backups into hierarchy based in DIR |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
270 |
\-\-suffix=SUFFIX backup suffix (default ~ w/o \-\-backup\-dir) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
271 |
@@ -428,7 +432,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
272 |
\-d, \-\-dirs transfer directories without recursing |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
273 |
\-l, \-\-links copy symlinks as symlinks |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
274 |
\-L, \-\-copy\-links transform symlink into referent file/dir |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
275 |
- \-\-copy\-unsafe\-links only \(dq\&unsafe\(dq\& symlinks are transformed |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
276 |
+ \-\-copy\-unsafe\-links only "unsafe" symlinks are transformed |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
277 |
\-\-safe\-links ignore symlinks that point outside the tree |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
278 |
\-\-munge\-links munge symlinks to make them safer |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
279 |
\-k, \-\-copy\-dirlinks transform symlink to dir into referent dir |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
280 |
@@ -453,7 +457,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
281 |
\-\-preallocate allocate dest files before writing |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
282 |
\-n, \-\-dry\-run perform a trial run with no changes made |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
283 |
\-W, \-\-whole\-file copy files whole (w/o delta\-xfer algorithm) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
284 |
- \-x, \-\-one\-file\-system don'\&t cross filesystem boundaries |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
285 |
+ \-x, \-\-one\-file\-system don't cross filesystem boundaries |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
286 |
\-B, \-\-block\-size=SIZE force a fixed checksum block\-size |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
287 |
\-e, \-\-rsh=COMMAND specify the remote shell to use |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
288 |
\-\-rsync\-path=PROGRAM specify the rsync to run on remote machine |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
289 |
@@ -471,20 +475,20 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
290 |
\-\-delete\-missing\-args delete missing source args from destination |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
291 |
\-\-ignore\-errors delete even if there are I/O errors |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
292 |
\-\-force force deletion of dirs even if not empty |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
293 |
- \-\-max\-delete=NUM don'\&t delete more than NUM files |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
294 |
- \-\-max\-size=SIZE don'\&t transfer any file larger than SIZE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
295 |
- \-\-min\-size=SIZE don'\&t transfer any file smaller than SIZE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
296 |
+ \-\-max\-delete=NUM don't delete more than NUM files |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
297 |
+ \-\-max\-size=SIZE don't transfer any file larger than SIZE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
298 |
+ \-\-min\-size=SIZE don't transfer any file smaller than SIZE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
299 |
\-\-partial keep partially transferred files |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
300 |
\-\-partial\-dir=DIR put a partially transferred file into DIR |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
301 |
\-\-delay\-updates put all updated files into place at end |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
302 |
\-m, \-\-prune\-empty\-dirs prune empty directory chains from file\-list |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
303 |
- \-\-numeric\-ids don'\&t map uid/gid values by user/group name |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
304 |
+ \-\-numeric\-ids don't map uid/gid values by user/group name |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
305 |
\-\-usermap=STRING custom username mapping |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
306 |
\-\-groupmap=STRING custom groupname mapping |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
307 |
\-\-chown=USER:GROUP simple username/groupname mapping |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
308 |
\-\-timeout=SECONDS set I/O timeout in seconds |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
309 |
\-\-contimeout=SECONDS set daemon connection timeout in seconds |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
310 |
- \-I, \-\-ignore\-times don'\&t skip files that match size and time |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
311 |
+ \-I, \-\-ignore\-times don't skip files that match size and time |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
312 |
\-\-size\-only skip files that match in size |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
313 |
\-\-modify\-window=NUM compare mod\-times with reduced accuracy |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
314 |
\-T, \-\-temp\-dir=DIR create temporary files in directory DIR |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
315 |
@@ -497,11 +501,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
316 |
\-\-skip\-compress=LIST skip compressing files with suffix in LIST |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
317 |
\-C, \-\-cvs\-exclude auto\-ignore files in the same way CVS does |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
318 |
\-f, \-\-filter=RULE add a file\-filtering RULE |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
319 |
- \-F same as \-\-filter='\&dir\-merge /.rsync\-filter'\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
320 |
- repeated: \-\-filter='\&\- .rsync\-filter'\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
321 |
+ \-F same as \-\-filter='dir\-merge /.rsync\-filter' |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
322 |
+ repeated: \-\-filter='\- .rsync\-filter' |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
323 |
\-\-exclude=PATTERN exclude files matching PATTERN |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
324 |
\-\-exclude\-from=FILE read exclude patterns from FILE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
325 |
- \-\-include=PATTERN don'\&t exclude files matching PATTERN |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
326 |
+ \-\-include=PATTERN don't exclude files matching PATTERN |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
327 |
\-\-include\-from=FILE read include patterns from FILE |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
328 |
\-\-files\-from=FILE read list of source\-file names from FILE |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
329 |
\-0, \-\-from0 all *from/filter files are delimited by 0s |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
330 |
@@ -519,7 +523,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
331 |
\-i, \-\-itemize\-changes output a change\-summary for all updates |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
332 |
\-M, \-\-remote\-option=OPTION send OPTION to the remote side only |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
333 |
\-\-out\-format=FORMAT output updates using the specified FORMAT |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
334 |
- \-\-log\-file=FILE log what we'\&re doing to the specified FILE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
335 |
+ \-\-log\-file=FILE log what we're doing to the specified FILE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
336 |
\-\-log\-file\-format=FMT log updates using the specified FMT |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
337 |
\-\-password\-file=FILE read daemon\-access password from FILE |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
338 |
\-\-list\-only list the files instead of copying them |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
339 |
@@ -548,8 +552,8 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
340 |
\-M, \-\-dparam=OVERRIDE override global daemon config parameter |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
341 |
\-\-no\-detach do not detach from the parent |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
342 |
\-\-port=PORT listen on alternate port number |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
343 |
- \-\-log\-file=FILE override the \(dq\&log file\(dq\& setting |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
344 |
- \-\-log\-file\-format=FMT override the \(dq\&log format\(dq\& setting |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
345 |
+ \-\-log\-file=FILE override the "log file" setting |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
346 |
+ \-\-log\-file\-format=FMT override the "log format" setting |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
347 |
\-\-sockopts=OPTIONS specify custom TCP options |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
348 |
\-v, \-\-verbose increase verbosity |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
349 |
\-4, \-\-ipv4 prefer IPv4 |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
350 |
@@ -567,11 +571,11 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
351 |
Some options only have a long variant, not a short. If the option takes a |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
352 |
parameter, the parameter is only listed after the long variant, even though it |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
353 |
must also be specified for the short. When specifying a parameter, you can |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
354 |
-either use the form \-\-option=param or replace the \(cq\&=\(cq\& with whitespace. The |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
355 |
-parameter may need to be quoted in some manner for it to survive the shell\(cq\&s |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
356 |
+either use the form \-\-option=param or replace the '=' with whitespace. The |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
357 |
+parameter may need to be quoted in some manner for it to survive the shell's |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
358 |
command\-line parsing. Keep in mind that a leading tilde (~) in a filename is |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
359 |
substituted by your shell, so \-\-option=~/foo will not change the tilde into |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
360 |
-your home directory (remove the \(cq\&=\(cq\& for that). |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
361 |
+your home directory (remove the '=' for that). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
362 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
363 |
.IP "\fB\-\-help\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
364 |
Print a short help page describing the options |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
365 |
@@ -615,7 +619,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
366 |
.fi |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
367 |
|
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
368 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
369 |
-Note that \fB\-\-info=name\fP\(cq\&s output is affected by the \fB\-\-out\-format\fP and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
370 |
+Note that \fB\-\-info=name\fP's output is affected by the \fB\-\-out\-format\fP and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
371 |
\fB\-\-itemize\-changes\fP (\fB\-i\fP) options. See those options for more |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
372 |
information on what is output and when. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
373 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
374 |
@@ -670,7 +674,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
375 |
This option affects the information that is output |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
376 |
by the client at the start of a daemon transfer. This suppresses the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
377 |
message\-of\-the\-day (MOTD) text, but it also affects the list of modules |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
378 |
-that the daemon sends in response to the \(dq\&rsync host::\(dq\& request (due to |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
379 |
+that the daemon sends in response to the "rsync host::" request (due to |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
380 |
a limitation in the rsync protocol), so omit this option if you want to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
381 |
request the list of modules from the daemon. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
382 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
383 |
@@ -677,11 +681,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
384 |
.IP "\fB\-I, \-\-ignore\-times\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
385 |
Normally rsync will skip any files that are |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
386 |
already the same size and have the same modification timestamp. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
387 |
-This option turns off this \(dq\&quick check\(dq\& behavior, causing all files to |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
388 |
+This option turns off this "quick check" behavior, causing all files to |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
389 |
be updated. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
390 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
391 |
.IP "\fB\-\-size\-only\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
392 |
-This modifies rsync\(cq\&s \(dq\&quick check\(dq\& algorithm for |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
393 |
+This modifies rsync's "quick check" algorithm for |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
394 |
finding files that need to be transferred, changing it from the default of |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
395 |
transferring files with either a changed size or a changed last\-modified |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
396 |
time to just looking for files that have changed in size. This is useful |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
397 |
@@ -700,7 +704,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
398 |
.IP "\fB\-c, \-\-checksum\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
399 |
This changes the way rsync checks if the files have |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
400 |
been changed and are in need of a transfer. Without this option, rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
401 |
-uses a \(dq\&quick check\(dq\& that (by default) checks if each file\(cq\&s size and time |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
402 |
+uses a "quick check" that (by default) checks if each file's size and time |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
403 |
of last modification match between the sender and receiver. This option |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
404 |
changes this to compare a 128\-bit checksum for each file that has a |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
405 |
matching size. Generating the checksums means that both sides will expend |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
406 |
@@ -711,7 +715,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
407 |
The sending side generates its checksums while it is doing the file\-system |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
408 |
scan that builds the list of the available files. The receiver generates |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
409 |
its checksums when it is scanning for changed files, and will checksum any |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
410 |
-file that has the same size as the corresponding sender\(cq\&s file: files with |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
411 |
+file that has the same size as the corresponding sender's file: files with |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
412 |
either a changed size or a changed checksum are selected for transfer. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
413 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
414 |
Note that rsync always verifies that each \fItransferred\fP file was |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
415 |
@@ -718,7 +722,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
416 |
correctly reconstructed on the receiving side by checking a whole\-file |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
417 |
checksum that is generated as the file is transferred, but that |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
418 |
automatic after\-the\-transfer verification has nothing to do with this |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
419 |
-option\(cq\&s before\-the\-transfer \(dq\&Does this file need to be updated?\(dq\& check. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
420 |
+option's before\-the\-transfer "Does this file need to be updated?" check. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
421 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
422 |
For protocol 30 and beyond (first supported in 3.0.0), the checksum used is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
423 |
MD5. For older protocols, the checksum used is MD4. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
424 |
@@ -736,14 +740,14 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
425 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
426 |
.IP "\-\-no\-OPTION" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
427 |
You may turn off one or more implied options by prefixing |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
428 |
-the option name with \(dq\&no\-\(dq\&. Not all options may be prefixed with a \(dq\&no\-\(dq\&: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
429 |
+the option name with "no\-". Not all options may be prefixed with a "no\-": |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
430 |
only options that are implied by other options (e.g. \fB\-\-no\-D\fP, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
431 |
\fB\-\-no\-perms\fP) or have different defaults in various circumstances |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
432 |
(e.g. \fB\-\-no\-whole\-file\fP, \fB\-\-no\-blocking\-io\fP, \fB\-\-no\-dirs\fP). You may |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
433 |
-specify either the short or the long option name after the \(dq\&no\-\(dq\& prefix |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
434 |
+specify either the short or the long option name after the "no\-" prefix |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
435 |
(e.g. \fB\-\-no\-R\fP is the same as \fB\-\-no\-relative\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
436 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
437 |
-For example: if you want to use \fB\-a\fP (\fB\-\-archive\fP) but don\(cq\&t want |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
438 |
+For example: if you want to use \fB\-a\fP (\fB\-\-archive\fP) but don't want |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
439 |
\fB\-o\fP (\fB\-\-owner\fP), instead of converting \fB\-a\fP into \fB\-rlptgD\fP, you |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
440 |
could specify \fB\-a \-\-no\-o\fP (or \fB\-a \-\-no\-owner\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
441 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
442 |
@@ -799,16 +803,16 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
443 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
444 |
then a file named /tmp/foo/bar/baz.c would be created on the remote |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
445 |
machine, preserving its full path. These extra path elements are called |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
446 |
-\(dq\&implied directories\(dq\& (i.e. the \(dq\&foo\(dq\& and the \(dq\&foo/bar\(dq\& directories in the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
447 |
+"implied directories" (i.e. the "foo" and the "foo/bar" directories in the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
448 |
above example). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
449 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
450 |
Beginning with rsync 3.0.0, rsync always sends these implied directories as |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
451 |
real directories in the file list, even if a path element is really a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
452 |
symlink on the sending side. This prevents some really unexpected |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
453 |
-behaviors when copying the full path of a file that you didn\(cq\&t realize had |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
454 |
+behaviors when copying the full path of a file that you didn't realize had |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
455 |
a symlink in its path. If you want to duplicate a server\-side symlink, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
456 |
include both the symlink via its path, and referent directory via its real |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
457 |
-path. If you\(cq\&re dealing with an older rsync on the sending side, you may |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
458 |
+path. If you're dealing with an older rsync on the sending side, you may |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
459 |
need to use the \fB\-\-no\-implied\-dirs\fP option. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
460 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
461 |
It is also possible to limit the amount of path information that is sent as |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
462 |
@@ -822,7 +826,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
463 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
464 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
465 |
That would create /tmp/bar/baz.c on the remote machine. (Note that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
466 |
-dot must be followed by a slash, so \(dq\&/foo/.\(dq\& would not be abbreviated.) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
467 |
+dot must be followed by a slash, so "/foo/." would not be abbreviated.) |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
468 |
For older rsync versions, you would need to use a chdir to limit the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
469 |
source path. For example, when pushing files: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
470 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
471 |
@@ -832,12 +836,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
472 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
473 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
474 |
(Note that the parens put the two commands into a sub\-shell, so that the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
475 |
-\(dq\&cd\(dq\& command doesn\(cq\&t remain in effect for future commands.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
476 |
-If you\(cq\&re pulling files from an older rsync, use this idiom (but only |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
477 |
+"cd" command doesn't remain in effect for future commands.) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
478 |
+If you're pulling files from an older rsync, use this idiom (but only |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
479 |
for a non\-daemon transfer): |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
480 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
481 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
482 |
-\f(CW rsync \-avR \-\-rsync\-path=\(dq\&cd /foo; rsync\(dq\& \e \fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
483 |
+\f(CW rsync \-avR \-\-rsync\-path="cd /foo; rsync" \e \fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
484 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
485 |
\f(CW remote:bar/baz.c /tmp/\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
486 |
.RE |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
487 |
@@ -854,13 +858,13 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
488 |
the receiving side. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
489 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
490 |
For instance, if a command\-line arg or a files\-from entry told rsync to |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
491 |
-transfer the file \(dq\&path/foo/file\(dq\&, the directories \(dq\&path\(dq\& and \(dq\&path/foo\(dq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
492 |
-are implied when \fB\-\-relative\fP is used. If \(dq\&path/foo\(dq\& is a symlink to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
493 |
-\(dq\&bar\(dq\& on the destination system, the receiving rsync would ordinarily |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
494 |
-delete \(dq\&path/foo\(dq\&, recreate it as a directory, and receive the file into |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
495 |
+transfer the file "path/foo/file", the directories "path" and "path/foo" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
496 |
+are implied when \fB\-\-relative\fP is used. If "path/foo" is a symlink to |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
497 |
+"bar" on the destination system, the receiving rsync would ordinarily |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
498 |
+delete "path/foo", recreate it as a directory, and receive the file into |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
499 |
the new directory. With \fB\-\-no\-implied\-dirs\fP, the receiving rsync updates |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
500 |
-\(dq\&path/foo/file\(dq\& using the existing path elements, which means that the file |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
501 |
-ends up being created in \(dq\&path/bar\(dq\&. Another way to accomplish this link |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
502 |
+"path/foo/file" using the existing path elements, which means that the file |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
503 |
+ends up being created in "path/bar". Another way to accomplish this link |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
504 |
preservation is to use the \fB\-\-keep\-dirlinks\fP option (which will also |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
505 |
affect symlinks to directories in the rest of the transfer). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
506 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
507 |
@@ -874,15 +878,15 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
508 |
backup file goes and what (if any) suffix gets appended using the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
509 |
\fB\-\-backup\-dir\fP and \fB\-\-suffix\fP options. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
510 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
511 |
-Note that if you don\(cq\&t specify \fB\-\-backup\-dir\fP, (1) the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
512 |
+Note that if you don't specify \fB\-\-backup\-dir\fP, (1) the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
513 |
\fB\-\-omit\-dir\-times\fP option will be implied, and (2) if \fB\-\-delete\fP is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
514 |
-also in effect (without \fB\-\-delete\-excluded\fP), rsync will add a \(dq\&protect\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
515 |
+also in effect (without \fB\-\-delete\-excluded\fP), rsync will add a "protect" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
516 |
filter\-rule for the backup suffix to the end of all your existing excludes |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
517 |
-(e.g. \fB\-f \(dq\&P *~\(dq\&\fP). This will prevent previously backed\-up files from being |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
518 |
+(e.g. \fB\-f "P *~"\fP). This will prevent previously backed\-up files from being |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
519 |
deleted. Note that if you are supplying your own filter rules, you may |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
520 |
need to manually insert your own exclude/protect rule somewhere higher up |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
521 |
in the list so that it has a high enough priority to be effective (e.g., if |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
522 |
-your rules specify a trailing inclusion/exclusion of \(cq\&*\(cq\&, the auto\-added |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
523 |
+your rules specify a trailing inclusion/exclusion of '*', the auto\-added |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
524 |
rule would never be reached). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
525 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
526 |
.IP "\fB\-\-backup\-dir=DIR\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
527 |
@@ -895,8 +899,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
528 |
.IP |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
529 |
Note that if you specify a relative path, the backup directory will be |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
530 |
relative to the destination directory, so you probably want to specify |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
531 |
-either an absolute path or a path that starts with \(dq\&../\(dq\&. If an rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
532 |
-daemon is the receiver, the backup dir cannot go outside the module\(cq\&s path |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
533 |
+either an absolute path or a path that starts with "../". If an rsync |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
534 |
+daemon is the receiver, the backup dir cannot go outside the module's path |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
535 |
hierarchy, so take extra care not to delete it or copy into it. |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
536 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
537 |
.IP "\fB\-\-suffix=SUFFIX\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
538 |
@@ -908,7 +912,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
539 |
This forces rsync to skip any files which exist on |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
540 |
the destination and have a modified time that is newer than the source |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
541 |
file. (If an existing destination file has a modification time equal to the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
542 |
-source file\(cq\&s, it will be updated if the sizes are different.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
543 |
+source file's, it will be updated if the sizes are different.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
544 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
545 |
Note that this does not affect the copying of symlinks or other special |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
546 |
files. Also, a difference of file format between the sender and receiver |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
547 |
@@ -917,8 +921,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
548 |
where the destination has a file, the transfer would occur regardless of |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
549 |
the timestamps. |
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 |
-This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
552 |
-data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
553 |
+This option is a transfer rule, not an exclude, so it doesn't affect the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
554 |
+data that goes into the file\-lists, and thus it doesn't affect deletions. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
555 |
It just limits the files that the receiver requests to be transferred. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
556 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
557 |
.IP "\fB\-\-inplace\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
558 |
@@ -934,13 +938,13 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
559 |
Hard links are not broken. This means the new data will be visible |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
560 |
through other hard links to the destination file. Moreover, attempts to |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
561 |
copy differing source files onto a multiply\-linked destination file will |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
562 |
-result in a \(dq\&tug of war\(dq\& with the destination data changing back and forth. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
563 |
+result in a "tug of war" with the destination data changing back and forth. |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
564 |
.IP o |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
565 |
In\-use binaries cannot be updated (either the OS will prevent this from |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
566 |
happening, or binaries that attempt to swap\-in their data will misbehave or |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
567 |
crash). |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
568 |
.IP o |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
569 |
-The file\(cq\&s data will be in an inconsistent state during the transfer |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
570 |
+The file's data will be in an inconsistent state during the transfer |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
571 |
and will be left that way if the transfer is interrupted or if an update |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
572 |
fails. |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
573 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
574 |
@@ -948,7 +952,7 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
575 |
can update any file, a normal user needs to be granted write permission for |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
576 |
the open of the file for writing to be successful. |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
577 |
.IP o |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
578 |
-The efficiency of rsync\(cq\&s delta\-transfer algorithm may be reduced if |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
579 |
+The efficiency of rsync's delta\-transfer algorithm may be reduced if |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
580 |
some data in the destination file is overwritten before it can be copied to |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
581 |
a position later in the file. This does not apply if you use \fB\-\-backup\fP, |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
582 |
since rsync is smart enough to use the backup file as the basis file for the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
583 |
@@ -975,12 +979,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
584 |
the receiving side is identical with the start of the file on the sending |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
585 |
side. If a file needs to be transferred and its size on the receiver is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
586 |
the same or longer than the size on the sender, the file is skipped. This |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
587 |
-does not interfere with the updating of a file\(cq\&s non\-content attributes |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
588 |
+does not interfere with the updating of a file's non\-content attributes |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
589 |
(e.g. permissions, ownership, etc.) when the file does not need to be |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
590 |
transferred, nor does it affect the updating of any non\-regular files. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
591 |
Implies \fB\-\-inplace\fP, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
592 |
but does not conflict with \fB\-\-sparse\fP (since it is always extending a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
593 |
-file\(cq\&s length). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
594 |
+file's length). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
595 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
596 |
.IP "\fB\-\-append\-verify\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
597 |
This works just like the \fB\-\-append\fP option, but |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
598 |
@@ -996,9 +1000,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
599 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
600 |
.IP "\fB\-d, \-\-dirs\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
601 |
Tell the sending side to include any directories that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
602 |
-are encountered. Unlike \fB\-\-recursive\fP, a directory\(cq\&s contents are not copied |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
603 |
-unless the directory name specified is \(dq\&.\(dq\& or ends with a trailing slash |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
604 |
-(e.g. \(dq\&.\(dq\&, \(dq\&dir/.\(dq\&, \(dq\&dir/\(dq\&, etc.). Without this option or the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
605 |
+are encountered. Unlike \fB\-\-recursive\fP, a directory's contents are not copied |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
606 |
+unless the directory name specified is "." or ends with a trailing slash |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
607 |
+(e.g. ".", "dir/.", "dir/", etc.). Without this option or the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
608 |
\fB\-\-recursive\fP option, rsync will skip all directories it encounters (and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
609 |
output a message to that effect for each one). If you specify both |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
610 |
\fB\-\-dirs\fP and \fB\-\-recursive\fP, \fB\-\-recursive\fP takes precedence. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
611 |
@@ -1005,12 +1009,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
612 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
613 |
The \fB\-\-dirs\fP option is implied by the \fB\-\-files\-from\fP option |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
614 |
or the \fB\-\-list\-only\fP option (including an implied |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
615 |
-\fB\-\-list\-only\fP usage) if \fB\-\-recursive\fP wasn\(cq\&t specified (so that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
616 |
+\fB\-\-list\-only\fP usage) if \fB\-\-recursive\fP wasn't specified (so that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
617 |
directories are seen in the listing). Specify \fB\-\-no\-dirs\fP (or \fB\-\-no\-d\fP) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
618 |
if you want to turn this off. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
619 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
620 |
There is also a backward\-compatibility helper option, \fB\-\-old\-dirs\fP (or |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
621 |
-\fB\-\-old\-d\fP) that tells rsync to use a hack of \(dq\&\-r \-\-exclude=\(cq\&/*/*\(cq\&\(dq\& to get |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
622 |
+\fB\-\-old\-d\fP) that tells rsync to use a hack of "\-r \-\-exclude='/*/*'" to get |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
623 |
an older rsync to list a single directory without recursing. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
624 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
625 |
.IP "\fB\-l, \-\-links\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
626 |
@@ -1022,7 +1026,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
627 |
they point to (the referent) is copied, rather than the symlink. In older |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
628 |
versions of rsync, this option also had the side\-effect of telling the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
629 |
receiving side to follow symlinks, such as symlinks to directories. In a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
630 |
-modern rsync such as this one, you\(cq\&ll need to specify \fB\-\-keep\-dirlinks\fP (\fB\-K\fP) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
631 |
+modern rsync such as this one, you'll need to specify \fB\-\-keep\-dirlinks\fP (\fB\-K\fP) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
632 |
to get this extra behavior. The only exception is when sending files to |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
633 |
an rsync that is too old to understand \fB\-K\fP \-\- in that case, the \fB\-L\fP option |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
634 |
will still have the side\-effect of \fB\-K\fP on that older receiving rsync. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
635 |
@@ -1044,11 +1048,11 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
636 |
This option tells rsync to (1) modify all symlinks on |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
637 |
the receiving side in a way that makes them unusable but recoverable (see |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
638 |
below), or (2) to unmunge symlinks on the sending side that had been stored in |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
639 |
-a munged state. This is useful if you don\(cq\&t quite trust the source of the data |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
640 |
+a munged state. This is useful if you don't quite trust the source of the data |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
641 |
to not try to slip in a symlink to a unexpected place. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
642 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
643 |
The way rsync disables the use of symlinks is to prefix each one with the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
644 |
-string \(dq\&/rsyncd\-munged/\(dq\&. This prevents the links from being used as long as |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
645 |
+string "/rsyncd\-munged/". This prevents the links from being used as long as |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
646 |
that directory does not exist. When this option is enabled, rsync will refuse |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
647 |
to run if that path is a directory or a symlink to a directory. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
648 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
649 |
@@ -1057,13 +1061,13 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
650 |
transfer, the client side is the sender.) |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
651 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
652 |
This option has no affect on a daemon, since the daemon configures whether it |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
653 |
-wants munged symlinks via its \(dq\&munge symlinks\(dq\& parameter. See also the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
654 |
-\(dq\&munge\-symlinks\(dq\& perl script in the support directory of the source code. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
655 |
+wants munged symlinks via its "munge symlinks" parameter. See also the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
656 |
+"munge\-symlinks" perl script in the support directory of the source code. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
657 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
658 |
.IP "\fB\-k, \-\-copy\-dirlinks\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
659 |
This option causes the sending side to treat |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
660 |
a symlink to a directory as though it were a real directory. This is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
661 |
-useful if you don\(cq\&t want symlinks to non\-directories to be affected, as |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
662 |
+useful if you don't want symlinks to non\-directories to be affected, as |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
663 |
they would be using \fB\-\-copy\-links\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
664 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
665 |
Without this option, if the sending side has replaced a directory with a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
666 |
@@ -1086,20 +1090,20 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
667 |
.IP |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
668 |
This works because rsync calls \fBlstat\fP(2) on the source arg as given, and the |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
669 |
trailing slash makes \fBlstat\fP(2) follow the symlink, giving rise to a directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
670 |
-in the file\-list which overrides the symlink found during the scan of \(dq\&src/./\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
671 |
+in the file\-list which overrides the symlink found during the scan of "src/./". |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
672 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
673 |
.IP "\fB\-K, \-\-keep\-dirlinks\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
674 |
This option causes the receiving side to treat |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
675 |
a symlink to a directory as though it were a real directory, but only if it |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
676 |
matches a real directory from the sender. Without this option, the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
677 |
-receiver\(cq\&s symlink would be deleted and replaced with a real directory. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
678 |
+receiver's symlink would be deleted and replaced with a real directory. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
679 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
680 |
-For example, suppose you transfer a directory \(dq\&foo\(dq\& that contains a file |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
681 |
-\(dq\&file\(dq\&, but \(dq\&foo\(dq\& is a symlink to directory \(dq\&bar\(dq\& on the receiver. Without |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
682 |
-\fB\-\-keep\-dirlinks\fP, the receiver deletes symlink \(dq\&foo\(dq\&, recreates it as a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
683 |
+For example, suppose you transfer a directory "foo" that contains a file |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
684 |
+"file", but "foo" is a symlink to directory "bar" on the receiver. Without |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
685 |
+\fB\-\-keep\-dirlinks\fP, the receiver deletes symlink "foo", recreates it as a |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
686 |
directory, and receives the file into the new directory. With |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
687 |
-\fB\-\-keep\-dirlinks\fP, the receiver keeps the symlink and \(dq\&file\(dq\& ends up in |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
688 |
-\(dq\&bar\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
689 |
+\fB\-\-keep\-dirlinks\fP, the receiver keeps the symlink and "file" ends up in |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
690 |
+"bar". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
691 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
692 |
One note of caution: if you use \fB\-\-keep\-dirlinks\fP, you must trust all |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
693 |
the symlinks in the copy! If it is possible for an untrusted user to |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
694 |
@@ -1167,10 +1171,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
695 |
permissions, though the \fB\-\-executability\fP option might change just |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
696 |
the execute permission for the file. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
697 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
698 |
-New files get their \(dq\&normal\(dq\& permission bits set to the source |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
699 |
-file\(cq\&s permissions masked with the receiving directory\(cq\&s default |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
700 |
-permissions (either the receiving process\(cq\&s umask, or the permissions |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
701 |
-specified via the destination directory\(cq\&s default ACL), and |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
702 |
+New files get their "normal" permission bits set to the source |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
703 |
+file's permissions masked with the receiving directory's default |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
704 |
+permissions (either the receiving process's umask, or the permissions |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
705 |
+specified via the destination directory's default ACL), and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
706 |
their special permission bits disabled except in the case where a new |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
707 |
directory inherits a setgid bit from its parent directory. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
708 |
.RE |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
709 |
@@ -1177,7 +1181,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
710 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
711 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
712 |
Thus, when \fB\-\-perms\fP and \fB\-\-executability\fP are both disabled, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
713 |
-rsync\(cq\&s behavior is the same as that of other file\-copy utilities, |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
714 |
+rsync's behavior is the same as that of other file\-copy utilities, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
715 |
such as \fBcp\fP(1) and \fBtar\fP(1). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
716 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
717 |
In summary: to give destination files (both old and new) the source |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
718 |
@@ -1184,7 +1188,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
719 |
permissions, use \fB\-\-perms\fP. To give new files the destination\-default |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
720 |
permissions (while leaving existing files unchanged), make sure that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
721 |
\fB\-\-perms\fP option is off and use \fB\-\-chmod=ugo=rwX\fP (which ensures that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
722 |
-all non\-masked bits get enabled). If you\(cq\&d care to make this latter |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
723 |
+all non\-masked bits get enabled). If you'd care to make this latter |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
724 |
behavior easier to type, you could define a popt alias for it, such as |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
725 |
putting this line in the file ~/.popt (the following defines the \fB\-Z\fP option, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
726 |
and includes \-\-no\-g to use the default group of the destination dir): |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
727 |
@@ -1202,13 +1206,13 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
728 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
729 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
730 |
(Caveat: make sure that \fB\-a\fP does not follow \fB\-Z\fP, or it will re\-enable |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
731 |
-the two \(dq\&\-\-no\-*\(dq\& options mentioned above.) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
732 |
+the two "\-\-no\-*" options mentioned above.) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
733 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
734 |
-The preservation of the destination\(cq\&s setgid bit on newly\-created |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
735 |
+The preservation of the destination's setgid bit on newly\-created |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
736 |
directories when \fB\-\-perms\fP is off was added in rsync 2.6.7. Older rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
737 |
versions erroneously preserved the three special permission bits for |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
738 |
newly\-created files when \fB\-\-perms\fP was off, while overriding the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
739 |
-destination\(cq\&s setgid bit setting on a newly\-created directory. Default ACL |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
740 |
+destination's setgid bit setting on a newly\-created directory. Default ACL |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
741 |
observance was added to the ACL patch for rsync 2.6.7, so older (or |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
742 |
non\-ACL\-enabled) rsyncs use the umask even if default ACLs are present. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
743 |
(Keep in mind that it is the version of the receiving rsync that affects |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
744 |
@@ -1218,17 +1222,17 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
745 |
This option causes rsync to preserve the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
746 |
executability (or non\-executability) of regular files when \fB\-\-perms\fP is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
747 |
not enabled. A regular file is considered to be executable if at least one |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
748 |
-\(cq\&x\(cq\& is turned on in its permissions. When an existing destination file\(cq\&s |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
749 |
+'x' is turned on in its permissions. When an existing destination file's |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
750 |
executability differs from that of the corresponding source file, rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
751 |
-modifies the destination file\(cq\&s permissions as follows: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
752 |
+modifies the destination file's permissions as follows: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
753 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
754 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
755 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
756 |
-To make a file non\-executable, rsync turns off all its \(cq\&x\(cq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
757 |
+To make a file non\-executable, rsync turns off all its 'x' |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
758 |
permissions. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
759 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
760 |
-To make a file executable, rsync turns on each \(cq\&x\(cq\& permission that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
761 |
-has a corresponding \(cq\&r\(cq\& permission enabled. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
762 |
+To make a file executable, rsync turns on each 'x' permission that |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
763 |
+has a corresponding 'r' permission enabled. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
764 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
765 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
766 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
767 |
@@ -1254,11 +1258,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
768 |
.IP |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
769 |
Note that this option does not copy rsyncs special xattr values (e.g. those |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
770 |
used by \fB\-\-fake\-super\fP) unless you repeat the option (e.g. \-XX). This |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
771 |
-\(dq\© all xattrs\(dq\& mode cannot be used with \fB\-\-fake\-super\fP. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
772 |
+"copy all xattrs" mode cannot be used with \fB\-\-fake\-super\fP. |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
773 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
774 |
.IP "\fB\-\-chmod\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
775 |
This option tells rsync to apply one or more |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
776 |
-comma\-separated \(dq\&chmod\(dq\& modes to the permission of the files in the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
777 |
+comma\-separated "chmod" modes to the permission of the files in the |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
778 |
transfer. The resulting value is treated as though it were the permissions |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
779 |
that the sending side supplied for the file, which means that this option |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
780 |
can seem to have no effect on existing files if \fB\-\-perms\fP is not enabled. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
781 |
@@ -1265,8 +1269,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
782 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
783 |
In addition to the normal parsing rules specified in the \fBchmod\fP(1) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
784 |
manpage, you can specify an item that should only apply to a directory by |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
785 |
-prefixing it with a \(cq\&D\(cq\&, or specify an item that should only apply to a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
786 |
-file by prefixing it with a \(cq\&F\(cq\&. For example, the following will ensure |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
787 |
+prefixing it with a 'D', or specify an item that should only apply to a |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
788 |
+file by prefixing it with a 'F'. For example, the following will ensure |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
789 |
that all directories get marked set\-gid, that no files are other\-writable, |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
790 |
that both are user\-writable and group\-writable, and that both have |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
791 |
consistent executability across all bits: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
792 |
@@ -1333,8 +1337,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
793 |
option is not used, the optimization that excludes files that have not been |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
794 |
modified cannot be effective; in other words, a missing \fB\-t\fP or \fB\-a\fP will |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
795 |
cause the next transfer to behave as if it used \fB\-I\fP, causing all files to be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
796 |
-updated (though rsync\(cq\&s delta\-transfer algorithm will make the update fairly efficient |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
797 |
-if the files haven\(cq\&t actually changed, you\(cq\&re much better off using \fB\-t\fP). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
798 |
+updated (though rsync's delta\-transfer algorithm will make the update fairly efficient |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
799 |
+if the files haven't actually changed, you're much better off using \fB\-t\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
800 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
801 |
.IP "\fB\-O, \-\-omit\-dir\-times\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
802 |
This tells rsync to omit directories when |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
803 |
@@ -1348,12 +1352,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
804 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
805 |
.IP "\fB\-\-super\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
806 |
This tells the receiving side to attempt super\-user |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
807 |
-activities even if the receiving rsync wasn\(cq\&t run by the super\-user. These |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
808 |
+activities even if the receiving rsync wasn't run by the super\-user. These |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
809 |
activities include: preserving users via the \fB\-\-owner\fP option, preserving |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
810 |
-all groups (not just the current user\(cq\&s groups) via the \fB\-\-groups\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
811 |
+all groups (not just the current user's groups) via the \fB\-\-groups\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
812 |
option, and copying devices via the \fB\-\-devices\fP option. This is useful |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
813 |
for systems that allow such activities without being the super\-user, and |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
814 |
-also for ensuring that you will get errors if the receiving side isn\(cq\&t |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
815 |
+also for ensuring that you will get errors if the receiving side isn't |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
816 |
being run as the super\-user. To turn off super\-user activities, the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
817 |
super\-user can use \fB\-\-no\-super\fP. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
818 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
819 |
@@ -1361,10 +1365,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
820 |
When this option is enabled, rsync simulates |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
821 |
super\-user activities by saving/restoring the privileged attributes via |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
822 |
special extended attributes that are attached to each file (as needed). This |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
823 |
-includes the file\(cq\&s owner and group (if it is not the default), the file\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
824 |
+includes the file's owner and group (if it is not the default), the file's |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
825 |
device info (device & special files are created as empty text files), and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
826 |
-any permission bits that we won\(cq\&t allow to be set on the real file (e.g. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
827 |
-the real file gets u\-s,g\-s,o\-t for safety) or that would limit the owner\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
828 |
+any permission bits that we won't allow to be set on the real file (e.g. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
829 |
+the real file gets u\-s,g\-s,o\-t for safety) or that would limit the owner's |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
830 |
access (since the real super\-user can always access/change a file, the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
831 |
files we create can always be accessed/changed by the creating user). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
832 |
This option also handles ACLs (if \fB\-\-acls\fP was specified) and non\-user |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
833 |
@@ -1390,18 +1394,18 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
834 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
835 |
This option is overridden by both \fB\-\-super\fP and \fB\-\-no\-super\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
836 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
837 |
-See also the \(dq\&fake super\(dq\& setting in the daemon\(cq\&s rsyncd.conf file. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
838 |
+See also the "fake super" setting in the daemon's rsyncd.conf file. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
839 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
840 |
.IP "\fB\-S, \-\-sparse\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
841 |
Try to handle sparse files efficiently so they take |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
842 |
-up less space on the destination. Conflicts with \fB\-\-inplace\fP because it\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
843 |
+up less space on the destination. Conflicts with \fB\-\-inplace\fP because it's |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
844 |
not possible to overwrite data in a sparse fashion. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
845 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
846 |
.IP "\fB\-\-preallocate\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
847 |
This tells the receiver to allocate each destination |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
848 |
file to its eventual size before writing data to the file. Rsync will only use |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
849 |
-the real filesystem\-level preallocation support provided by Linux\(cq\&s |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
850 |
-\fBfallocate\fP(2) system call or Cygwin\(cq\&s \fBposix_fallocate\fP(3), not the slow |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
851 |
+the real filesystem\-level preallocation support provided by Linux's |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
852 |
+\fBfallocate\fP(2) system call or Cygwin's \fBposix_fallocate\fP(3), not the slow |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
853 |
glibc implementation that writes a zero byte into each block. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
854 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
855 |
Without this option, larger files may not be entirely contiguous on the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
856 |
@@ -1410,7 +1414,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
857 |
etc.), this option may have no positive effect at all. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
858 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
859 |
.IP "\fB\-n, \-\-dry\-run\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
860 |
-This makes rsync perform a trial run that doesn\(cq\&t |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
861 |
+This makes rsync perform a trial run that doesn't |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
862 |
make any changes (and produces mostly the same output as a real run). It |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
863 |
is most commonly used in combination with the \fB\-v, \-\-verbose\fP and/or |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
864 |
\fB\-i, \-\-itemize\-changes\fP options to see what an rsync command is going |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
865 |
@@ -1418,29 +1422,29 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
866 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
867 |
The output of \fB\-\-itemize\-changes\fP is supposed to be exactly the same on a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
868 |
dry run and a subsequent real run (barring intentional trickery and system |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
869 |
-call failures); if it isn\(cq\&t, that\(cq\&s a bug. Other output should be mostly |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
870 |
+call failures); if it isn't, that's a bug. Other output should be mostly |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
871 |
unchanged, but may differ in some areas. Notably, a dry run does not |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
872 |
send the actual data for file transfers, so \fB\-\-progress\fP has no effect, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
873 |
-the \(dq\&bytes sent\(dq\&, \(dq\&bytes received\(dq\&, \(dq\&literal data\(dq\&, and \(dq\&matched data\(dq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
874 |
-statistics are too small, and the \(dq\&speedup\(dq\& value is equivalent to a run |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
875 |
+the "bytes sent", "bytes received", "literal data", and "matched data" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
876 |
+statistics are too small, and the "speedup" value is equivalent to a run |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
877 |
where no file transfers were needed. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
878 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
879 |
.IP "\fB\-W, \-\-whole\-file\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
880 |
-With this option rsync\(cq\&s delta\-transfer algorithm |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
881 |
+With this option rsync's delta\-transfer algorithm |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
882 |
is not used and the whole file is sent as\-is instead. The transfer may be |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
883 |
faster if this option is used when the bandwidth between the source and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
884 |
destination machines is higher than the bandwidth to disk (especially when the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
885 |
-\(dq\&disk\(dq\& is actually a networked filesystem). This is the default when both |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
886 |
+"disk" is actually a networked filesystem). This is the default when both |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
887 |
the source and destination are specified as local paths, but only if no |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
888 |
batch\-writing option is in effect. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
889 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
890 |
.IP "\fB\-x, \-\-one\-file\-system\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
891 |
This tells rsync to avoid crossing a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
892 |
-filesystem boundary when recursing. This does not limit the user\(cq\&s ability |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
893 |
-to specify items to copy from multiple filesystems, just rsync\(cq\&s recursion |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
894 |
+filesystem boundary when recursing. This does not limit the user's ability |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
895 |
+to specify items to copy from multiple filesystems, just rsync's recursion |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
896 |
through the hierarchy of each directory that the user specified, and also |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
897 |
the analogous recursion on the receiving side during deletion. Also keep |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
898 |
-in mind that rsync treats a \(dq\&bind\(dq\& mount to the same device as being on the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
899 |
+in mind that rsync treats a "bind" mount to the same device as being on the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
900 |
same filesystem. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
901 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
902 |
If this option is repeated, rsync omits all mount\-point directories from |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
903 |
@@ -1460,8 +1464,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
904 |
combined with the \fB\-\-ignore\-existing\fP option, no files will be updated |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
905 |
(which can be useful if all you want to do is delete extraneous files). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
906 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
907 |
-This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
908 |
-data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
909 |
+This option is a transfer rule, not an exclude, so it doesn't affect the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
910 |
+data that goes into the file\-lists, and thus it doesn't affect deletions. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
911 |
It just limits the files that the receiver requests to be transferred. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
912 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
913 |
.IP "\fB\-\-ignore\-existing\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
914 |
@@ -1469,8 +1473,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
915 |
already exist on the destination (this does \fInot\fP ignore existing |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
916 |
directories, or nothing would get done). See also \fB\-\-existing\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
917 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
918 |
-This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
919 |
-data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
920 |
+This option is a transfer rule, not an exclude, so it doesn't affect the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
921 |
+data that goes into the file\-lists, and thus it doesn't affect deletions. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
922 |
It just limits the files that the receiver requests to be transferred. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
923 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
924 |
This option can be useful for those doing backups using the \fB\-\-link\-dest\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
925 |
@@ -1477,7 +1481,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
926 |
option when they need to continue a backup run that got interrupted. Since |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
927 |
a \fB\-\-link\-dest\fP run is copied into a new directory hierarchy (when it is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
928 |
used properly), using \fB\-\-ignore existing\fP will ensure that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
929 |
-already\-handled files don\(cq\&t get tweaked (which avoids a change in |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
930 |
+already\-handled files don't get tweaked (which avoids a change in |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
931 |
permissions on the hard\-linked files). This does mean that this option |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
932 |
is only looking at the existing files in the destination hierarchy itself. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
933 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
934 |
@@ -1489,24 +1493,24 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
935 |
Note that you should only use this option on source files that are quiescent. |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
936 |
If you are using this to move files that show up in a particular directory over |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
937 |
to another host, make sure that the finished files get renamed into the source |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
938 |
-directory, not directly written into it, so that rsync can\(cq\&t possibly transfer |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
939 |
-a file that is not yet fully written. If you can\(cq\&t first write the files into |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
940 |
+directory, not directly written into it, so that rsync can't possibly transfer |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
941 |
+a file that is not yet fully written. If you can't first write the files into |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
942 |
a different directory, you should use a naming idiom that lets rsync avoid |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
943 |
-transferring files that are not yet finished (e.g. name the file \(dq\&foo.new\(dq\& when |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
944 |
-it is written, rename it to \(dq\&foo\(dq\& when it is done, and then use the option |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
945 |
-\fB\-\-exclude='\&*.new'\&\fP for the rsync transfer). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
946 |
+transferring files that are not yet finished (e.g. name the file "foo.new" when |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
947 |
+it is written, rename it to "foo" when it is done, and then use the option |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
948 |
+\fB\-\-exclude='*.new'\fP for the rsync transfer). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
949 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
950 |
Starting with 3.1.0, rsync will skip the sender\-side removal (and output an |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
951 |
-error) if the file\(cq\&s size or modify time has not stayed unchanged. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
952 |
+error) if the file's size or modify time has not stayed unchanged. |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
953 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
954 |
.IP "\fB\-\-delete\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
955 |
This tells rsync to delete extraneous files from the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
956 |
-receiving side (ones that aren\(cq\&t on the sending side), but only for the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
957 |
+receiving side (ones that aren't on the sending side), but only for the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
958 |
directories that are being synchronized. You must have asked rsync to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
959 |
-send the whole directory (e.g. \(dq\&dir\(dq\& or \(dq\&dir/\(dq\&) without using a wildcard |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
960 |
-for the directory\(cq\&s contents (e.g. \(dq\&dir/*\(dq\&) since the wildcard is expanded |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
961 |
+send the whole directory (e.g. "dir" or "dir/") without using a wildcard |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
962 |
+for the directory's contents (e.g. "dir/*") since the wildcard is expanded |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
963 |
by the shell and rsync thus gets a request to transfer individual files, not |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
964 |
-the files\(cq\& parent directory. Files that are excluded from the transfer are |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
965 |
+the files' parent directory. Files that are excluded from the transfer are |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
966 |
also excluded from being deleted unless you use the \fB\-\-delete\-excluded\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
967 |
option or mark the rules as only matching on the sending side (see the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
968 |
include/exclude modifiers in the FILTER RULES section). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
969 |
@@ -1563,7 +1567,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
970 |
computes the deletions in a separate pass after all updates are done). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
971 |
If the number of removed files overflows an internal buffer, a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
972 |
temporary file will be created on the receiving side to hold the names (it |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
973 |
-is removed while open, so you shouldn\(cq\&t see it during the transfer). If |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
974 |
+is removed while open, so you shouldn't see it during the transfer). If |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
975 |
the creation of the temporary file fails, rsync will try to fall back to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
976 |
using \fB\-\-delete\-after\fP (which it cannot do if \fB\-\-recursive\fP is doing an |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
977 |
incremental scan). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
978 |
@@ -1605,7 +1609,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
979 |
that, this option is independent of any other type of delete processing. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
980 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
981 |
The missing source files are represented by special file\-list entries which |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
982 |
-display as a \(dq\&*missing\(dq\& entry in the \fB\-\-list\-only\fP output. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
983 |
+display as a "*missing" entry in the \fB\-\-list\-only\fP output. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
984 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
985 |
.IP "\fB\-\-ignore\-errors\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
986 |
Tells \fB\-\-delete\fP to go ahead and delete files |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
987 |
@@ -1629,27 +1633,27 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
988 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
989 |
Beginning with version 3.0.0, you may specify \fB\-\-max\-delete=0\fP to be warned |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
990 |
about any extraneous files in the destination without removing any of them. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
991 |
-Older clients interpreted this as \(dq\&unlimited\(dq\&, so if you don\(cq\&t know what |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
992 |
+Older clients interpreted this as "unlimited", so if you don't know what |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
993 |
version the client is, you can use the less obvious \fB\-\-max\-delete=\-1\fP as |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
994 |
a backward\-compatible way to specify that no deletions be allowed (though |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
995 |
-really old versions didn\(cq\&t warn when the limit was exceeded). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
996 |
+really old versions didn't warn when the limit was exceeded). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
997 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
998 |
.IP "\fB\-\-max\-size=SIZE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
999 |
This tells rsync to avoid transferring any |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1000 |
file that is larger than the specified SIZE. The SIZE value can be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1001 |
suffixed with a string to indicate a size multiplier, and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1002 |
-may be a fractional value (e.g. \(dq\&\fB\-\-max\-size=1.5m\fP\(dq\&). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1003 |
+may be a fractional value (e.g. "\fB\-\-max\-size=1.5m\fP"). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1004 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1005 |
-This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1006 |
-data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1007 |
+This option is a transfer rule, not an exclude, so it doesn't affect the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1008 |
+data that goes into the file\-lists, and thus it doesn't affect deletions. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1009 |
It just limits the files that the receiver requests to be transferred. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1010 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1011 |
-The suffixes are as follows: \(dq\&K\(dq\& (or \(dq\&KiB\(dq\&) is a kibibyte (1024), |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1012 |
-\(dq\&M\(dq\& (or \(dq\&MiB\(dq\&) is a mebibyte (1024*1024), and \(dq\&G\(dq\& (or \(dq\&GiB\(dq\&) is a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1013 |
+The suffixes are as follows: "K" (or "KiB") is a kibibyte (1024), |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1014 |
+"M" (or "MiB") is a mebibyte (1024*1024), and "G" (or "GiB") is a |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1015 |
gibibyte (1024*1024*1024). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1016 |
-If you want the multiplier to be 1000 instead of 1024, use \(dq\&KB\(dq\&, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1017 |
-\(dq\&MB\(dq\&, or \(dq\&GB\(dq\&. (Note: lower\-case is also accepted for all values.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1018 |
-Finally, if the suffix ends in either \(dq\&+1\(dq\& or \(dq\&\-1\(dq\&, the value will |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1019 |
+If you want the multiplier to be 1000 instead of 1024, use "KB", |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1020 |
+"MB", or "GB". (Note: lower\-case is also accepted for all values.) |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1021 |
+Finally, if the suffix ends in either "+1" or "\-1", the value will |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1022 |
be offset by one byte in the indicated direction. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1023 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1024 |
Examples: \-\-max\-size=1.5mb\-1 is 1499999 bytes, and \-\-max\-size=2g+1 is |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1025 |
@@ -1667,7 +1671,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1026 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1027 |
.IP "\fB\-B, \-\-block\-size=BLOCKSIZE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1028 |
This forces the block size used in |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1029 |
-rsync\(cq\&s delta\-transfer algorithm to a fixed value. It is normally selected based on |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1030 |
+rsync's delta\-transfer algorithm to a fixed value. It is normally selected based on |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1031 |
the size of each file being updated. See the technical report for details. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1032 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1033 |
.IP "\fB\-e, \-\-rsh=COMMAND\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1034 |
@@ -1680,8 +1684,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1035 |
remote shell \fICOMMAND\fP will be used to run an rsync daemon on the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1036 |
remote host, and all data will be transmitted through that remote |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1037 |
shell connection, rather than through a direct socket connection to a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1038 |
-running rsync daemon on the remote host. See the section \(dq\&USING |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1039 |
-RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& above. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1040 |
+running rsync daemon on the remote host. See the section "USING |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1041 |
+RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION" above. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1042 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1043 |
Command\-line arguments are permitted in COMMAND provided that COMMAND is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1044 |
presented to rsync as a single argument. You must use spaces (not tabs |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1045 |
@@ -1693,9 +1697,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1046 |
shell is parsing and which quotes rsync is parsing). Some examples: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1047 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1048 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1049 |
-\f(CW \-e '\&ssh \-p 2234'\&\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1050 |
+\f(CW \-e 'ssh \-p 2234'\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1051 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1052 |
-\f(CW \-e '\&ssh \-o \(dq\&ProxyCommand nohup ssh firewall nc \-w1 %h %p\(dq\&'\&\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1053 |
+\f(CW \-e 'ssh \-o "ProxyCommand nohup ssh firewall nc \-w1 %h %p"'\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1054 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1055 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1056 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1057 |
@@ -1711,9 +1715,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1058 |
.IP "\fB\-\-rsync\-path=PROGRAM\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1059 |
Use this to specify what program is to be run |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1060 |
on the remote machine to start\-up rsync. Often used when rsync is not in |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1061 |
-the default remote\-shell\(cq\&s path (e.g. \-\-rsync\-path=/usr/local/bin/rsync). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1062 |
+the default remote\-shell's path (e.g. \-\-rsync\-path=/usr/local/bin/rsync). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1063 |
Note that PROGRAM is run with the help of a shell, so it can be any |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1064 |
-program, script, or command sequence you\(cq\&d care to run, so long as it does |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1065 |
+program, script, or command sequence you'd care to run, so long as it does |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1066 |
not corrupt the standard\-in & standard\-out that rsync is using to |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1067 |
communicate. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1068 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1069 |
@@ -1721,7 +1725,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1070 |
machine for use with the \fB\-\-relative\fP option. For instance: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1071 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1072 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1073 |
-\f(CW rsync \-avR \-\-rsync\-path=\(dq\&cd /a/b && rsync\(dq\& host:c/d /e/\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1074 |
+\f(CW rsync \-avR \-\-rsync\-path="cd /a/b && rsync" host:c/d /e/\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1075 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1076 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1077 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1078 |
@@ -1754,8 +1758,8 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1079 |
option. If that option is off, any spaces in your remote options will be split |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1080 |
by the remote shell unless you take steps to protect them. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1081 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1082 |
-When performing a local transfer, the \(dq\&local\(dq\& side is the sender and the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1083 |
-\(dq\&remote\(dq\& side is the receiver. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1084 |
+When performing a local transfer, the "local" side is the sender and the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1085 |
+"remote" side is the receiver. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1086 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1087 |
Note some versions of the popt option\-parsing library have a bug in them that |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1088 |
prevents you from using an adjacent arg with an equal in it next to a short |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1089 |
@@ -1764,7 +1768,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1090 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1091 |
.IP "\fB\-C, \-\-cvs\-exclude\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1092 |
This is a useful shorthand for excluding a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1093 |
-broad range of files that you often don\(cq\&t want to transfer between |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1094 |
+broad range of files that you often don't want to transfer between |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1095 |
systems. It uses a similar algorithm to CVS to determine if |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1096 |
a file should be ignored. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1097 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1098 |
@@ -1786,10 +1790,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1099 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1100 |
Finally, any file is ignored if it is in the same directory as a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1101 |
\&.cvsignore file and matches one of the patterns listed therein. Unlike |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1102 |
-rsync\(cq\&s filter/exclude files, these patterns are split on whitespace. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1103 |
+rsync's filter/exclude files, these patterns are split on whitespace. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1104 |
See the \fBcvs\fP(1) manual for more information. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1105 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1106 |
-If you\(cq\&re combining \fB\-C\fP with your own \fB\-\-filter\fP rules, you should |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1107 |
+If you're combining \fB\-C\fP with your own \fB\-\-filter\fP rules, you should |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1108 |
note that these CVS excludes are appended at the end of your own rules, |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1109 |
regardless of where the \fB\-C\fP was placed on the command\-line. This makes them |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1110 |
a lower priority than any rules you specified explicitly. If you want to |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1111 |
@@ -1796,7 +1800,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1112 |
control where these CVS excludes get inserted into your filter rules, you |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1113 |
should omit the \fB\-C\fP as a command\-line option and use a combination of |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1114 |
\fB\-\-filter=:C\fP and \fB\-\-filter=\-C\fP (either on your command\-line or by |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1115 |
-putting the \(dq\&:C\(dq\& and \(dq\&\-C\(dq\& rules into a filter file with your other rules). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1116 |
+putting the ":C" and "\-C" rules into a filter file with your other rules). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1117 |
The first option turns on the per\-directory scanning for the .cvsignore |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1118 |
file. The second option does a one\-time import of the CVS excludes |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1119 |
mentioned above. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1120 |
@@ -1819,7 +1823,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1121 |
your command. The first time it is used is a shorthand for this rule: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1122 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1123 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1124 |
-\f(CW \-\-filter='\&dir\-merge /.rsync\-filter'\&\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1125 |
+\f(CW \-\-filter='dir\-merge /.rsync\-filter'\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1126 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1127 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1128 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1129 |
@@ -1829,7 +1833,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1130 |
rule: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1131 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1132 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1133 |
-\f(CW \-\-filter='\&exclude .rsync\-filter'\&\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1134 |
+\f(CW \-\-filter='exclude .rsync\-filter'\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1135 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1136 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1137 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1138 |
@@ -1848,7 +1852,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1139 |
.IP "\fB\-\-exclude\-from=FILE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1140 |
This option is related to the \fB\-\-exclude\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1141 |
option, but it specifies a FILE that contains exclude patterns (one per line). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1142 |
-Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1143 |
+Blank lines in the file and lines starting with ';' or '#' are ignored. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1144 |
If \fIFILE\fP is \fB\-\fP, the list will be read from standard input. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1145 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1146 |
.IP "\fB\-\-include=PATTERN\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1147 |
@@ -1861,7 +1865,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1148 |
.IP "\fB\-\-include\-from=FILE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1149 |
This option is related to the \fB\-\-include\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1150 |
option, but it specifies a FILE that contains include patterns (one per line). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1151 |
-Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1152 |
+Blank lines in the file and lines starting with ';' or '#' are ignored. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1153 |
If \fIFILE\fP is \fB\-\fP, the list will be read from standard input. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1154 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1155 |
.IP "\fB\-\-files\-from=FILE\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1156 |
@@ -1880,7 +1884,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1157 |
specified in the list on the destination rather than noisily skipping |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1158 |
them (use \fB\-\-no\-dirs\fP or \fB\-\-no\-d\fP if you want to turn that off). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1159 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1160 |
-The \fB\-\-archive\fP (\fB\-a\fP) option\(cq\&s behavior does not imply \fB\-\-recursive\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1161 |
+The \fB\-\-archive\fP (\fB\-a\fP) option's behavior does not imply \fB\-\-recursive\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1162 |
(\fB\-r\fP), so specify it explicitly, if you want it. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1163 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1164 |
These side\-effects change the default state of rsync, so the position |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1165 |
@@ -1891,7 +1895,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1166 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1167 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1168 |
The filenames that are read from the FILE are all relative to the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1169 |
-source dir \-\- any leading slashes are removed and no \(dq\&..\(dq\& references are |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1170 |
+source dir \-\- any leading slashes are removed and no ".." references are |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1171 |
allowed to go higher than the source dir. For example, take this |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1172 |
command: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1173 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1174 |
@@ -1900,12 +1904,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1175 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1176 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1177 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1178 |
-If /tmp/foo contains the string \(dq\&bin\(dq\& (or even \(dq\&/bin\(dq\&), the /usr/bin |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1179 |
+If /tmp/foo contains the string "bin" (or even "/bin"), the /usr/bin |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1180 |
directory will be created as /backup/bin on the remote host. If it |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1181 |
-contains \(dq\&bin/\(dq\& (note the trailing slash), the immediate contents of |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1182 |
+contains "bin/" (note the trailing slash), the immediate contents of |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1183 |
the directory would also be sent (without needing to be explicitly |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1184 |
mentioned in the file \-\- this began in version 2.6.4). In both cases, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1185 |
-if the \fB\-r\fP option was enabled, that dir\(cq\&s entire hierarchy would |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1186 |
+if the \fB\-r\fP option was enabled, that dir's entire hierarchy would |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1187 |
also be transferred (keep in mind that \fB\-r\fP needs to be specified |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1188 |
explicitly with \fB\-\-files\-from\fP, since it is not implied by \fB\-a\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1189 |
Also note |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1190 |
@@ -1914,10 +1918,10 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1191 |
force the duplication of the source\-spec path (/usr in this case). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1192 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1193 |
In addition, the \fB\-\-files\-from\fP file can be read from the remote host |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1194 |
-instead of the local host if you specify a \(dq\&host:\(dq\& in front of the file |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1195 |
+instead of the local host if you specify a "host:" in front of the file |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1196 |
(the host must match one end of the transfer). As a short\-cut, you can |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1197 |
-specify just a prefix of \(dq\&:\(dq\& to mean \(dq\&use the remote end of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1198 |
-transfer\(dq\&. For example: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1199 |
+specify just a prefix of ":" to mean "use the remote end of the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1200 |
+transfer". For example: |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1201 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1202 |
.RS |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1203 |
\f(CW rsync \-a \-\-files\-from=:/path/file\-list src:/ /tmp/copy\fP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1204 |
@@ -1925,12 +1929,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1205 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1206 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1207 |
This would copy all the files specified in the /path/file\-list file that |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1208 |
-was located on the remote \(dq\&src\(dq\& host. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1209 |
+was located on the remote "src" host. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1210 |
.IP |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1211 |
If the \fB\-\-iconv\fP and \fB\-\-protect\-args\fP options are specified and the |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1212 |
\fB\-\-files\-from\fP filenames are being sent from one host to another, the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1213 |
-filenames will be translated from the sending host\(cq\&s charset to the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1214 |
-receiving host\(cq\&s charset. |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1215 |
+filenames will be translated from the sending host's charset to the |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1216 |
+receiving host's charset. |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1217 |
.IP |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1218 |
NOTE: sorting the list of files in the \-\-files\-from input helps rsync to be |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1219 |
more efficient, as it will avoid re\-visiting the path elements that are shared |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1220 |
@@ -1940,7 +1944,7 @@ |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
1221 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1222 |
.IP "\fB\-0, \-\-from0\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1223 |
This tells rsync that the rules/filenames it reads from a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1224 |
-file are terminated by a null (\(cq\&\e0\(cq\&) character, not a NL, CR, or CR+LF. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1225 |
+file are terminated by a null ('\e0') character, not a NL, CR, or CR+LF. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1226 |
This affects \fB\-\-exclude\-from\fP, \fB\-\-include\-from\fP, \fB\-\-files\-from\fP, and any |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1227 |
merged files specified in a \fB\-\-filter\fP rule. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1228 |
It does not affect \fB\-\-cvs\-exclude\fP (since all names read from a .cvsignore |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1229 |
@@ -1963,7 +1967,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1230 |
by default, otherwise it will be disabled by default. Either state is |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1231 |
overridden by a manually specified positive or negative version of this option |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1232 |
(note that \fB\-\-no\-s\fP and \fB\-\-no\-protect\-args\fP are the negative versions). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1233 |
-Since this option was first introduced in 3.0.0, you\(cq\&ll need to make sure it\(cq\&s |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1234 |
+Since this option was first introduced in 3.0.0, you'll need to make sure it's |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1235 |
disabled if you ever need to interact with a remote rsync that is older than |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1236 |
that. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1237 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1238 |
@@ -1995,9 +1999,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1239 |
If you are using this option for reasons other than a shortage of disk |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1240 |
space, you may wish to combine it with the \fB\-\-delay\-updates\fP option, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1241 |
which will ensure that all copied files get put into subdirectories in the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1242 |
-destination hierarchy, awaiting the end of the transfer. If you don\(cq\&t |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1243 |
+destination hierarchy, awaiting the end of the transfer. If you don't |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1244 |
have enough room to duplicate all the arriving files on the destination |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1245 |
-partition, another way to tell rsync that you aren\(cq\&t overly concerned |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1246 |
+partition, another way to tell rsync that you aren't overly concerned |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1247 |
about disk space is to use the \fB\-\-partial\-dir\fP option with a relative |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1248 |
path; because this tells rsync that it is OK to stash off a copy of a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1249 |
single file in a subdir in the destination hierarchy, rsync will use the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1250 |
@@ -2025,7 +2029,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1251 |
the destination machine as an additional hierarchy to compare destination |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1252 |
files against doing transfers (if the files are missing in the destination |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1253 |
directory). If a file is found in \fIDIR\fP that is identical to the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1254 |
-sender\(cq\&s file, the file will NOT be transferred to the destination |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1255 |
+sender's file, the file will NOT be transferred to the destination |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1256 |
directory. This is useful for creating a sparse backup of just files that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1257 |
have changed from an earlier backup. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1258 |
This option is typically used to copy into an empty (or newly created) |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1259 |
@@ -2074,10 +2078,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1260 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1261 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1262 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1263 |
-If file\(cq\&s aren\(cq\&t linking, double\-check their attributes. Also check if some |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1264 |
-attributes are getting forced outside of rsync\(cq\&s control, such a mount option |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1265 |
+If file's aren't linking, double\-check their attributes. Also check if some |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1266 |
+attributes are getting forced outside of rsync's control, such a mount option |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1267 |
that squishes root to a single user, or mounts a removable drive with generic |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1268 |
-ownership (such as OS X\(cq\&s \(dq\&Ignore ownership on this volume\(dq\& option). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1269 |
+ownership (such as OS X's "Ignore ownership on this volume" option). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1270 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1271 |
Beginning in version 2.6.4, multiple \fB\-\-link\-dest\fP directories may be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1272 |
provided, which will cause rsync to search the list in the order specified |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1273 |
@@ -2134,11 +2138,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1274 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1275 |
Simple character\-class matching is supported: each must consist of a list |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1276 |
of letters inside the square brackets (e.g. no special classes, such as |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1277 |
-\(dq\&[:alpha:]\(dq\&, are supported, and \(cq\&\-\(cq\& has no special meaning). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1278 |
+"[:alpha:]", are supported, and '\-' has no special meaning). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1279 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1280 |
The characters asterisk (*) and question\-mark (?) have no special meaning. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1281 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1282 |
-Here\(cq\&s an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1283 |
+Here's an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1284 |
matches 2 suffixes): |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1285 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1286 |
.nf |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1287 |
@@ -2196,8 +2200,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1288 |
If a user or group has no name on the source system or it has no match |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1289 |
on the destination system, then the numeric ID |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1290 |
from the source system is used instead. See also the comments on the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1291 |
-\(dq\&use chroot\(dq\& setting in the rsyncd.conf manpage for information on how |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1292 |
-the chroot setting affects rsync\(cq\&s ability to look up the names of the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1293 |
+"use chroot" setting in the rsyncd.conf manpage for information on how |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1294 |
+the chroot setting affects rsync's ability to look up the names of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1295 |
users and groups and what you can do about it. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1296 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1297 |
.IP "\fB\-\-usermap=STRING, \-\-groupmap=STRING\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1298 |
@@ -2207,9 +2211,9 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1299 |
values separated by commas. Any matching \fBFROM\fP value from the sender is |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1300 |
replaced with a \fBTO\fP value from the receiver. You may specify usernames |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1301 |
or user IDs for the \fBFROM\fP and \fBTO\fP values, and the \fBFROM\fP value may |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1302 |
-also be a wild\-card string, which will be matched against the sender\(cq\&s |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1303 |
+also be a wild\-card string, which will be matched against the sender's |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1304 |
names (wild\-cards do NOT match against ID numbers, though see below for |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1305 |
-why a \(cq\&*\(cq\& matches everything). You may instead specify a range of ID |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1306 |
+why a '*' matches everything). You may instead specify a range of ID |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1307 |
numbers via an inclusive range: LOW\-HIGH. For example: |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1308 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1309 |
.nf |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1310 |
@@ -2221,15 +2225,15 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1311 |
all your user mappings using a single \fB\-\-usermap\fP option, and/or all |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1312 |
your group mappings using a single \fB\-\-groupmap\fP option. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1313 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1314 |
-Note that the sender\(cq\&s name for the 0 user and group are not transmitted |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1315 |
+Note that the sender's name for the 0 user and group are not transmitted |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1316 |
to the receiver, so you should either match these values using a 0, or use |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1317 |
-the names in effect on the receiving side (typically \(dq\&root\(dq\&). All other |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1318 |
+the names in effect on the receiving side (typically "root"). All other |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1319 |
\fBFROM\fP names match those in use on the sending side. All \fBTO\fP names |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1320 |
match those in use on the receiving side. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1321 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1322 |
Any IDs that do not have a name on the sending side are treated as having an |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1323 |
empty name for the purpose of matching. This allows them to be matched via |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1324 |
-a \(dq\&*\(dq\& or using an empty name. For instance: |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1325 |
+a "*" or using an empty name. For instance: |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1326 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1327 |
.nf |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1328 |
\-\-usermap=:nobody \-\-groupmap=*:nobody |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1329 |
@@ -2256,8 +2260,8 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1330 |
the omitted user/group will occur. If GROUP is empty, the trailing colon may |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1331 |
be omitted, but if USER is empty, a leading colon must be supplied. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1332 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1333 |
-If you specify \(dq\&\-\-chown=foo:bar, this is exactly the same as specifying |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1334 |
-\(dq\&\-\-usermap=*:foo \-\-groupmap=*:bar\(dq\&, only easier. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1335 |
+If you specify "\-\-chown=foo:bar, this is exactly the same as specifying |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1336 |
+"\-\-usermap=*:foo \-\-groupmap=*:bar", only easier. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1337 |
.IP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1338 |
.IP "\fB\-\-timeout=TIMEOUT\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1339 |
This option allows you to set a maximum I/O |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1340 |
@@ -2307,18 +2311,18 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1341 |
as a single letter for the mode, and use upper or lower case. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1342 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1343 |
The main use of this option is to change Full buffering to Line buffering |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1344 |
-when rsync\(cq\&s output is going to a file or pipe. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1345 |
+when rsync's output is going to a file or pipe. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1346 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1347 |
.IP "\fB\-i, \-\-itemize\-changes\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1348 |
Requests a simple itemized list of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1349 |
changes that are being made to each file, including attribute changes. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1350 |
-This is exactly the same as specifying \fB\-\-out\-format='\&%i %n%L'\&\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1351 |
+This is exactly the same as specifying \fB\-\-out\-format='%i %n%L'\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1352 |
If you repeat the option, unchanged files will also be output, but only |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1353 |
if the receiving rsync is at least version 2.6.7 (you can use \fB\-vv\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1354 |
with older versions of rsync, but that also turns on the output of other |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1355 |
verbose messages). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1356 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1357 |
-The \(dq\&%i\(dq\& escape has a cryptic output that is 11 letters long. The general |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1358 |
+The "%i" escape has a cryptic output that is 11 letters long. The general |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1359 |
format is like the string \fBYXcstpoguax\fP, where \fBY\fP is replaced by the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1360 |
type of update being done, \fBX\fP is replaced by the file\-type, and the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1361 |
other letters represent attributes that may be output if they are being |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1362 |
@@ -2344,7 +2348,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1363 |
have attributes that are being modified). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1364 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1365 |
A \fB*\fP means that the rest of the itemized\-output area contains |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1366 |
-a message (e.g. \(dq\&deleting\(dq\&). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1367 |
+a message (e.g. "deleting"). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1368 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1369 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1370 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1371 |
@@ -2354,10 +2358,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1372 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1373 |
The other letters in the string above are the actual letters that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1374 |
will be output if the associated attribute for the item is being updated or |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1375 |
-a \(dq\&.\(dq\& for no change. Three exceptions to this are: (1) a newly created |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1376 |
-item replaces each letter with a \(dq\&+\(dq\&, (2) an identical item replaces the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1377 |
+a "." for no change. Three exceptions to this are: (1) a newly created |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1378 |
+item replaces each letter with a "+", (2) an identical item replaces the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1379 |
dots with spaces, and (3) an unknown attribute replaces each letter with |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1380 |
-a \(dq\&?\(dq\& (this can happen when talking to an older rsync). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1381 |
+a "?" (this can happen when talking to an older rsync). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1382 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1383 |
The attribute that is associated with each letter is as follows: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1384 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1385 |
@@ -2373,21 +2377,21 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1386 |
by the file transfer. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1387 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1388 |
A \fBt\fP means the modification time is different and is being updated |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1389 |
-to the sender\(cq\&s value (requires \fB\-\-times\fP). An alternate value of \fBT\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1390 |
+to the sender's value (requires \fB\-\-times\fP). An alternate value of \fBT\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1391 |
means that the modification time will be set to the transfer time, which happens |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1392 |
when a file/symlink/device is updated without \fB\-\-times\fP and when a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1393 |
-symlink is changed and the receiver can\(cq\&t set its time. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1394 |
+symlink is changed and the receiver can't set its time. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1395 |
(Note: when using an rsync 3.0.0 client, you might see the \fBs\fP flag combined |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1396 |
with \fBt\fP instead of the proper \fBT\fP flag for this time\-setting failure.) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1397 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1398 |
A \fBp\fP means the permissions are different and are being updated to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1399 |
-the sender\(cq\&s value (requires \fB\-\-perms\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1400 |
+the sender's value (requires \fB\-\-perms\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1401 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1402 |
An \fBo\fP means the owner is different and is being updated to the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1403 |
-sender\(cq\&s value (requires \fB\-\-owner\fP and super\-user privileges). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1404 |
+sender's value (requires \fB\-\-owner\fP and super\-user privileges). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1405 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1406 |
A \fBg\fP means the group is different and is being updated to the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1407 |
-sender\(cq\&s value (requires \fB\-\-group\fP and the authority to set the group). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1408 |
+sender's value (requires \fB\-\-group\fP and the authority to set the group). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1409 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1410 |
The \fBu\fP slot is reserved for future use. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1411 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1412 |
@@ -2397,8 +2401,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1413 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1414 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1415 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1416 |
-One other output is possible: when deleting files, the \(dq\&%i\(dq\& will output |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1417 |
-the string \(dq\&*deleting\(dq\& for each item that is being removed (assuming that |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1418 |
+One other output is possible: when deleting files, the "%i" will output |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1419 |
+the string "*deleting" for each item that is being removed (assuming that |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1420 |
you are talking to a recent enough rsync that it logs deletions instead of |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1421 |
outputting them as a verbose message). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1422 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1423 |
@@ -2406,10 +2410,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1424 |
This allows you to specify exactly what the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1425 |
rsync client outputs to the user on a per\-update basis. The format is a |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1426 |
text string containing embedded single\-character escape sequences prefixed |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1427 |
-with a percent (%) character. A default format of \(dq\&%n%L\(dq\& is assumed if |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1428 |
+with a percent (%) character. A default format of "%n%L" is assumed if |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1429 |
either \fB\-\-info=name\fP or \fB\-v\fP is specified (this tells you just the name |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1430 |
of the file and, if the item is a link, where it points). For a full list |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1431 |
-of the possible escape characters, see the \(dq\&log format\(dq\& setting in the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1432 |
+of the possible escape characters, see the "log format" setting in the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1433 |
rsyncd.conf manpage. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1434 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1435 |
Specifying the \fB\-\-out\-format\fP option implies the \fB\-\-info=name\fP option, |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1436 |
@@ -2419,11 +2423,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1437 |
the string (e.g. if the \fB\-\-itemize\-changes\fP option was used), the logging |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1438 |
of names increases to mention any item that is changed in any way (as long |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1439 |
as the receiving side is at least 2.6.4). See the \fB\-\-itemize\-changes\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1440 |
-option for a description of the output of \(dq\&%i\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1441 |
+option for a description of the output of "%i". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1442 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1443 |
-Rsync will output the out\-format string prior to a file\(cq\&s transfer unless |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1444 |
+Rsync will output the out\-format string prior to a file's transfer unless |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1445 |
one of the transfer\-statistic escapes is requested, in which case the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1446 |
-logging is done at the end of the file\(cq\&s transfer. When this late logging |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1447 |
+logging is done at the end of the file's transfer. When this late logging |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1448 |
is in effect and \fB\-\-progress\fP is also specified, rsync will also output |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1449 |
the name of the file being transferred prior to its progress information |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1450 |
(followed, of course, by the out\-format output). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1451 |
@@ -2433,10 +2437,10 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1452 |
to a file. This is similar to the logging that a daemon does, but can be |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1453 |
requested for the client side and/or the server side of a non\-daemon |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1454 |
transfer. If specified as a client option, transfer logging will be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1455 |
-enabled with a default format of \(dq\&%i %n%L\(dq\&. See the \fB\-\-log\-file\-format\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1456 |
+enabled with a default format of "%i %n%L". See the \fB\-\-log\-file\-format\fP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1457 |
option if you wish to override this. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1458 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1459 |
-Here\(cq\&s a example command that requests the remote side to log what is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1460 |
+Here's a example command that requests the remote side to log what is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1461 |
happening: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1462 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1463 |
.nf |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1464 |
@@ -2452,15 +2456,15 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1465 |
per\-update logging is put into the file specified by the \fB\-\-log\-file\fP option |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1466 |
(which must also be specified for this option to have any effect). If you |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1467 |
specify an empty string, updated files will not be mentioned in the log file. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1468 |
-For a list of the possible escape characters, see the \(dq\&log format\(dq\& setting |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1469 |
+For a list of the possible escape characters, see the "log format" setting |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1470 |
in the rsyncd.conf manpage. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1471 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1472 |
The default FORMAT used if \fB\-\-log\-file\fP is specified and this option is not |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1473 |
-is \(cq\&%i %n%L\(cq\&. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1474 |
+is '%i %n%L'. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1475 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1476 |
.IP "\fB\-\-stats\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1477 |
This tells rsync to print a verbose set of statistics |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1478 |
-on the file transfer, allowing you to tell how effective rsync\(cq\&s delta\-transfer |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1479 |
+on the file transfer, allowing you to tell how effective rsync's delta\-transfer |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1480 |
algorithm is for your data. This option is equivalent to \fB\-\-info=stats2\fP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1481 |
if combined with 0 or 1 \fB\-v\fP options, or \fB\-\-info=stats3\fP if combined |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1482 |
with 2 or more \fB\-v\fP options. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1483 |
@@ -2468,18 +2472,18 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1484 |
The current statistics are as follows: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1485 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1486 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1487 |
-\fBNumber of files\fP is the count of all \(dq\&files\(dq\& (in the generic |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1488 |
+\fBNumber of files\fP is the count of all "files" (in the generic |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1489 |
sense), which includes directories, symlinks, etc. The total count will |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1490 |
be followed by a list of counts by filetype (if the total is non\-zero). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1491 |
-For example: \(dq\&(reg: 5, dir: 3, link: 2, dev: 1, special: 1)\(dq\& lists the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1492 |
+For example: "(reg: 5, dir: 3, link: 2, dev: 1, special: 1)" lists the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1493 |
totals for regular files, directories, symlinks, devices, and special |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1494 |
files. If any of value is 0, it is completely omitted from the list. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1495 |
.IP o |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1496 |
-\fBNumber of created files\fP is the count of how many \(dq\&files\(dq\& (generic |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1497 |
+\fBNumber of created files\fP is the count of how many "files" (generic |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1498 |
sense) were created (as opposed to updated). The total count will be |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1499 |
followed by a list of counts by filetype (if the total is non\-zero). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1500 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1501 |
-\fBNumber of deleted files\fP is the count of how many \(dq\&files\(dq\& (generic |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1502 |
+\fBNumber of deleted files\fP is the count of how many "files" (generic |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1503 |
sense) were created (as opposed to updated). The total count will be |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1504 |
followed by a list of counts by filetype (if the total is non\-zero). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1505 |
Note that this line is only output if deletions are in effect, and only |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1506 |
@@ -2486,9 +2490,9 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1507 |
if protocol 31 is being used (the default for rsync 3.1.x). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1508 |
.IP o |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1509 |
\fBNumber of regular files transferred\fP is the count of normal files |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1510 |
-that were updated via rsync\(cq\&s delta\-transfer algorithm, which does not |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1511 |
+that were updated via rsync's delta\-transfer algorithm, which does not |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1512 |
include dirs, symlinks, etc. Note that rsync 3.1.0 added the word |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1513 |
-\(dq\®ular\(dq\& into this heading. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1514 |
+"regular" into this heading. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1515 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1516 |
\fBTotal file size\fP is the total sum of all file sizes in the transfer. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1517 |
This does not count any size for directories or special files, but does |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1518 |
@@ -2519,8 +2523,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1519 |
from the client side to the server side. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1520 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1521 |
\fBTotal bytes received\fP is the count of all non\-message bytes that |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1522 |
-rsync received by the client side from the server side. \(dq\&Non\-message\(dq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1523 |
-bytes means that we don\(cq\&t count the bytes for a verbose message that the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1524 |
+rsync received by the client side from the server side. "Non\-message" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1525 |
+bytes means that we don't count the bytes for a verbose message that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1526 |
server sent to us, which makes the stats more consistent. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1527 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1528 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1529 |
@@ -2527,14 +2531,14 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1530 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1531 |
.IP "\fB\-8, \-\-8\-bit\-output\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1532 |
This tells rsync to leave all high\-bit characters |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1533 |
-unescaped in the output instead of trying to test them to see if they\(cq\&re |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1534 |
+unescaped in the output instead of trying to test them to see if they're |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1535 |
valid in the current locale and escaping the invalid ones. All control |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1536 |
-characters (but never tabs) are always escaped, regardless of this option\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1537 |
+characters (but never tabs) are always escaped, regardless of this option's |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1538 |
setting. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1539 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1540 |
The escape idiom that started in 2.6.7 is to output a literal backslash (\e) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1541 |
and a hash (#), followed by exactly 3 octal digits. For example, a newline |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1542 |
-would output as \(dq\&\e#012\(dq\&. A literal backslash that is in a filename is not |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1543 |
+would output as "\e#012". A literal backslash that is in a filename is not |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1544 |
escaped unless it is followed by a hash and 3 digits (0\-9). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1545 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1546 |
.IP "\fB\-h, \-\-human\-readable\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1547 |
@@ -2556,7 +2560,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1548 |
Backward compatibility note: versions of rsync prior to 3.1.0 do not support |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1549 |
human\-readable level 1, and they default to level 0. Thus, specifying one or |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1550 |
two \fB\-h\fP options will behave in a comparable manner in old and new versions |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1551 |
-as long as you didn\(cq\&t specify a \fB\-\-no\-h\fP option prior to one or more \fB\-h\fP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1552 |
+as long as you didn't specify a \fB\-\-no\-h\fP option prior to one or more \fB\-h\fP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1553 |
options. See the \fB\-\-list\-only\fP option for one difference. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1554 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1555 |
.IP "\fB\-\-partial\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1556 |
@@ -2577,12 +2581,12 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1557 |
Note that if \fB\-\-whole\-file\fP is specified (or implied), any partial\-dir |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1558 |
file that is found for a file that is being updated will simply be removed |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1559 |
(since |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1560 |
-rsync is sending files without using rsync\(cq\&s delta\-transfer algorithm). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1561 |
+rsync is sending files without using rsync's delta\-transfer algorithm). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1562 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1563 |
Rsync will create the \fIDIR\fP if it is missing (just the last dir \-\- not |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1564 |
the whole path). This makes it easy to use a relative path (such as |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1565 |
-\(dq\&\fB\-\-partial\-dir=.rsync\-partial\fP\(dq\&) to have rsync create the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1566 |
-partial\-directory in the destination file\(cq\&s directory when needed, and then |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1567 |
+"\fB\-\-partial\-dir=.rsync\-partial\fP") to have rsync create the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1568 |
+partial\-directory in the destination file's directory when needed, and then |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1569 |
remove it again when the partial file is deleted. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1570 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1571 |
If the partial\-dir value is not an absolute path, rsync will add an exclude |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1572 |
@@ -2590,21 +2594,21 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1573 |
sending of any partial\-dir files that may exist on the sending side, and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1574 |
will also prevent the untimely deletion of partial\-dir items on the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1575 |
receiving side. An example: the above \fB\-\-partial\-dir\fP option would add |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1576 |
-the equivalent of \(dq\&\fB\-f '\&\-p .rsync\-partial/'\&\fP\(dq\& at the end of any other |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1577 |
+the equivalent of "\fB\-f '\-p .rsync\-partial/'\fP" at the end of any other |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1578 |
filter rules. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1579 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1580 |
If you are supplying your own exclude rules, you may need to add your own |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1581 |
exclude/hide/protect rule for the partial\-dir because (1) the auto\-added |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1582 |
rule may be ineffective at the end of your other rules, or (2) you may wish |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1583 |
-to override rsync\(cq\&s exclude choice. For instance, if you want to make |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1584 |
+to override rsync's exclude choice. For instance, if you want to make |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1585 |
rsync clean\-up any left\-over partial\-dirs that may be lying around, you |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1586 |
-should specify \fB\-\-delete\-after\fP and add a \(dq\&risk\(dq\& filter rule, e.g. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1587 |
-\fB\-f '\&R .rsync\-partial/'\&\fP. (Avoid using \fB\-\-delete\-before\fP or |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1588 |
-\fB\-\-delete\-during\fP unless you don\(cq\&t need rsync to use any of the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1589 |
+should specify \fB\-\-delete\-after\fP and add a "risk" filter rule, e.g. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1590 |
+\fB\-f 'R .rsync\-partial/'\fP. (Avoid using \fB\-\-delete\-before\fP or |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1591 |
+\fB\-\-delete\-during\fP unless you don't need rsync to use any of the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1592 |
left\-over partial\-dir data during the current run.) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1593 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1594 |
IMPORTANT: the \fB\-\-partial\-dir\fP should not be writable by other users or it |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1595 |
-is a security risk. E.g. AVOID \(dq\&/tmp\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1596 |
+is a security risk. E.g. AVOID "/tmp". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1597 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1598 |
You can also set the partial\-dir value the RSYNC_PARTIAL_DIR environment |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1599 |
variable. Setting this in the environment does not force \fB\-\-partial\fP to be |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1600 |
@@ -2617,7 +2621,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1601 |
specified (since \fB\-\-inplace\fP conflicts with \fB\-\-partial\-dir\fP), and (2) when |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1602 |
\fB\-\-delay\-updates\fP was specified (see below). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1603 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1604 |
-For the purposes of the daemon\-config\(cq\&s \(dq\&refuse options\(dq\& setting, |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1605 |
+For the purposes of the daemon\-config's "refuse options" setting, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1606 |
\fB\-\-partial\-dir\fP does \fInot\fP imply \fB\-\-partial\fP. This is so that a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1607 |
refusal of the \fB\-\-partial\fP option can be used to disallow the overwriting |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1608 |
of destination files with a partial transfer, while still allowing the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1609 |
@@ -2628,12 +2632,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1610 |
updated file into a holding directory until the end of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1611 |
transfer, at which time all the files are renamed into place in rapid |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1612 |
succession. This attempts to make the updating of the files a little more |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1613 |
-atomic. By default the files are placed into a directory named \(dq\&.~tmp~\(dq\& in |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1614 |
-each file\(cq\&s destination directory, but if you\(cq\&ve specified the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1615 |
+atomic. By default the files are placed into a directory named ".~tmp~" in |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1616 |
+each file's destination directory, but if you've specified the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1617 |
\fB\-\-partial\-dir\fP option, that directory will be used instead. See the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1618 |
comments in the \fB\-\-partial\-dir\fP section for a discussion of how this |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1619 |
-\(dq\&.~tmp~\(dq\& dir will be excluded from the transfer, and what you can do if |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1620 |
-you want rsync to cleanup old \(dq\&.~tmp~\(dq\& dirs that might be lying around. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1621 |
+".~tmp~" dir will be excluded from the transfer, and what you can do if |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1622 |
+you want rsync to cleanup old ".~tmp~" dirs that might be lying around. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1623 |
Conflicts with \fB\-\-inplace\fP and \fB\-\-append\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1624 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1625 |
This option uses more memory on the receiving side (one bit per file |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1626 |
@@ -2645,9 +2649,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1627 |
the updated files will be put into a single directory if the path is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1628 |
absolute) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1629 |
and (2) there are no mount points in the hierarchy (since the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1630 |
-delayed updates will fail if they can\(cq\&t be renamed into place). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1631 |
+delayed updates will fail if they can't be renamed into place). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1632 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1633 |
-See also the \(dq\&atomic\-rsync\(dq\& perl script in the \(dq\&support\(dq\& subdir for an |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1634 |
+See also the "atomic\-rsync" perl script in the "support" subdir for an |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1635 |
update algorithm that is even more atomic (it uses \fB\-\-link\-dest\fP and a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1636 |
parallel hierarchy of files). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1637 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1638 |
@@ -2671,26 +2675,26 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1639 |
this. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1640 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1641 |
You can prevent the pruning of certain empty directories from the file\-list |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1642 |
-by using a global \(dq\&protect\(dq\& filter. For instance, this option would ensure |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1643 |
-that the directory \(dq\&emptydir\(dq\& was kept in the file\-list: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1644 |
+by using a global "protect" filter. For instance, this option would ensure |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1645 |
+that the directory "emptydir" was kept in the file\-list: |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1646 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1647 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1648 |
-\-\-filter \(cq\&protect emptydir/\(cq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1649 |
+\-\-filter 'protect emptydir/' |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1650 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1651 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1652 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1653 |
-Here\(cq\&s an example that copies all .pdf files in a hierarchy, only creating |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1654 |
+Here's an example that copies all .pdf files in a hierarchy, only creating |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1655 |
the necessary destination directories to hold the .pdf files, and ensures |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1656 |
that any superfluous files and directories in the destination are removed |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1657 |
(note the hide filter of non\-directories being used instead of an exclude): |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1658 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1659 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1660 |
-rsync \-avm \-\-del \-\-include=\(cq\&*.pdf\(cq\& \-f \(cq\&hide,! */\(cq\& src/ dest |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1661 |
+rsync \-avm \-\-del \-\-include='*.pdf' \-f 'hide,! */' src/ dest |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1662 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1663 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1664 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1665 |
-If you didn\(cq\&t want to remove superfluous destination files, the more |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1666 |
-time\-honored options of \(dq\&\fB\-\-include='\&*/'\& \-\-exclude='\&*'\&\fP\(dq\& would work fine |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1667 |
+If you didn't want to remove superfluous destination files, the more |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1668 |
+time\-honored options of "\fB\-\-include='*/' \-\-exclude='*'\fP" would work fine |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1669 |
in place of the hide\-filter (if that is more natural to you). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1670 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1671 |
.IP "\fB\-\-progress\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1672 |
@@ -2699,7 +2703,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1673 |
something to watch. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1674 |
With a modern rsync this is the same as specifying |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1675 |
\fB\-\-info=flist2,name,progress\fP, but any user\-supplied settings for those |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1676 |
-info flags takes precedence (e.g. \(dq\&\-\-info=flist0 \-\-progress\(dq\&). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1677 |
+info flags takes precedence (e.g. "\-\-info=flist0 \-\-progress"). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1678 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1679 |
While rsync is transferring a regular file, it updates a progress line that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1680 |
looks like this: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1681 |
@@ -2710,12 +2714,12 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1682 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1683 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1684 |
In this example, the receiver has reconstructed 782448 bytes or 63% of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1685 |
-sender\(cq\&s file, which is being reconstructed at a rate of 110.64 kilobytes |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1686 |
+sender's file, which is being reconstructed at a rate of 110.64 kilobytes |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1687 |
per second, and the transfer will finish in 4 seconds if the current rate |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1688 |
is maintained until the end. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1689 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1690 |
-These statistics can be misleading if rsync\(cq\&s delta\-transfer algorithm is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1691 |
-in use. For example, if the sender\(cq\&s file consists of the basis file |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1692 |
+These statistics can be misleading if rsync's delta\-transfer algorithm is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1693 |
+in use. For example, if the sender's file consists of the basis file |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1694 |
followed by additional data, the reported rate will probably drop |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1695 |
dramatically when the receiver gets to the literal data, and the transfer |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1696 |
will probably take much longer to finish than the receiver estimated as it |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1697 |
@@ -2736,12 +2740,12 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1698 |
receiver to check (to see if they are up\-to\-date or not) remaining out of |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1699 |
the 396 total files in the file\-list. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1700 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1701 |
-In an incremental recursion scan, rsync won\(cq\&t know the total number of files |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1702 |
+In an incremental recursion scan, rsync won't know the total number of files |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1703 |
in the file\-list until it reaches the ends of the scan, but since it starts to |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1704 |
-transfer files during the scan, it will display a line with the text \(dq\&ir\-chk\(dq\& |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1705 |
-(for incremental recursion check) instead of \(dq\&to\-chk\(dq\& until the point that it |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1706 |
+transfer files during the scan, it will display a line with the text "ir\-chk" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1707 |
+(for incremental recursion check) instead of "to\-chk" until the point that it |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1708 |
knows the full size of the list, at which point it will switch to using |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1709 |
-\(dq\&to\-chk\(dq\&. Thus, seeing \(dq\&ir\-chk\(dq\& lets you know that the total count of files |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1710 |
+"to\-chk". Thus, seeing "ir\-chk" lets you know that the total count of files |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1711 |
in the file list is still going to increase (and each time it does, the count |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1712 |
of files left to check will increase by the number of the files added to the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1713 |
list). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1714 |
@@ -2755,7 +2759,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1715 |
on the whole transfer, rather than individual files. Use this flag without |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1716 |
outputting a filename (e.g. avoid \fB\-v\fP or specify \fB\-\-info=name0\fP if you |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1717 |
want to see how the transfer is doing without scrolling the screen with a |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1718 |
-lot of names. (You don\(cq\&t need to specify the \fB\-\-progress\fP option in |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1719 |
+lot of names. (You don't need to specify the \fB\-\-progress\fP option in |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1720 |
order to use \fB\-\-info=progress2\fP.) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1721 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1722 |
.IP "\fB\-\-password\-file=FILE\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1723 |
@@ -2766,10 +2770,10 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1724 |
readable or if a root\-run rsync command finds a non\-root\-owned file. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1725 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1726 |
This option does not supply a password to a remote shell transport such as |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1727 |
-ssh; to learn how to do that, consult the remote shell\(cq\&s documentation. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1728 |
+ssh; to learn how to do that, consult the remote shell's documentation. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1729 |
When accessing an rsync daemon using a remote shell as the transport, this |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1730 |
option only comes into effect after the remote shell finishes its |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1731 |
-authentication (i.e. if you have also specified a password in the daemon\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1732 |
+authentication (i.e. if you have also specified a password in the daemon's |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1733 |
config file). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1734 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1735 |
.IP "\fB\-\-list\-only\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1736 |
@@ -2799,17 +2803,17 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1737 |
Compatibility note: when requesting a remote listing of files from an rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1738 |
that is version 2.6.3 or older, you may encounter an error if you ask for a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1739 |
non\-recursive listing. This is because a file listing implies the \fB\-\-dirs\fP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1740 |
-option w/o \fB\-\-recursive\fP, and older rsyncs don\(cq\&t have that option. To |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1741 |
-avoid this problem, either specify the \fB\-\-no\-dirs\fP option (if you don\(cq\&t |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1742 |
-need to expand a directory\(cq\&s content), or turn on recursion and exclude |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1743 |
-the content of subdirectories: \fB\-r \-\-exclude='\&/*/*'\&\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1744 |
+option w/o \fB\-\-recursive\fP, and older rsyncs don't have that option. To |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1745 |
+avoid this problem, either specify the \fB\-\-no\-dirs\fP option (if you don't |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1746 |
+need to expand a directory's content), or turn on recursion and exclude |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1747 |
+the content of subdirectories: \fB\-r \-\-exclude='/*/*'\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1748 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1749 |
.IP "\fB\-\-bwlimit=RATE\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1750 |
This option allows you to specify the maximum transfer |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1751 |
rate for the data sent over the socket, specified in units per second. The |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1752 |
RATE value can be suffixed with a string to indicate a size multiplier, and may |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1753 |
-be a fractional value (e.g. \(dq\&\fB\-\-bwlimit=1.5m\fP\(dq\&). If no suffix is specified, |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1754 |
-the value will be assumed to be in units of 1024 bytes (as if \(dq\&K\(dq\& or \(dq\&KiB\(dq\& had |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1755 |
+be a fractional value (e.g. "\fB\-\-bwlimit=1.5m\fP"). If no suffix is specified, |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1756 |
+the value will be assumed to be in units of 1024 bytes (as if "K" or "KiB" had |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1757 |
been appended). See the \fB\-\-max\-size\fP option for a description of all the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1758 |
available suffixes. A value of zero specifies no limit. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1759 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1760 |
@@ -2818,7 +2822,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1761 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1762 |
Rsync writes data over the socket in blocks, and this option both limits the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1763 |
size of the blocks that rsync writes, and tries to keep the average transfer |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1764 |
-rate at the requested limit. Some \(dq\&burstiness\(dq\& may be seen where rsync writes |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1765 |
+rate at the requested limit. Some "burstiness" may be seen where rsync writes |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1766 |
out a block of data and then sleeps to bring the average rate into compliance. |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1767 |
.IP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1768 |
Due to the internal buffering of data, the \fB\-\-progress\fP option may not be an |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1769 |
@@ -2829,7 +2833,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1770 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1771 |
.IP "\fB\-\-write\-batch=FILE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1772 |
Record a file that can later be applied to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1773 |
-another identical destination with \fB\-\-read\-batch\fP. See the \(dq\&BATCH MODE\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1774 |
+another identical destination with \fB\-\-read\-batch\fP. See the "BATCH MODE" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1775 |
section for details, and also the \fB\-\-only\-write\-batch\fP option. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1776 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1777 |
.IP "\fB\-\-only\-write\-batch=FILE\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1778 |
@@ -2841,7 +2845,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1779 |
Note that you can feel free to write the batch directly to some portable |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1780 |
media: if this media fills to capacity before the end of the transfer, you |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1781 |
can just apply that partial transfer to the destination and repeat the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1782 |
-whole process to get the rest of the changes (as long as you don\(cq\&t mind a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1783 |
+whole process to get the rest of the changes (as long as you don't mind a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1784 |
partially updated destination system while the multi\-update cycle is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1785 |
happening). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1786 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1787 |
@@ -2848,13 +2852,13 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1788 |
Also note that you only save bandwidth when pushing changes to a remote |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1789 |
system because this allows the batched data to be diverted from the sender |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1790 |
into the batch file without having to flow over the wire to the receiver |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1791 |
-(when pulling, the sender is remote, and thus can\(cq\&t write the batch). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1792 |
+(when pulling, the sender is remote, and thus can't write the batch). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1793 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1794 |
.IP "\fB\-\-read\-batch=FILE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1795 |
Apply all of the changes stored in FILE, a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1796 |
file previously generated by \fB\-\-write\-batch\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1797 |
If \fIFILE\fP is \fB\-\fP, the batch data will be read from standard input. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1798 |
-See the \(dq\&BATCH MODE\(dq\& section for details. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1799 |
+See the "BATCH MODE" section for details. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1800 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1801 |
.IP "\fB\-\-protocol=NUM\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1802 |
Force an older protocol version to be used. This |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1803 |
@@ -2861,25 +2865,25 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1804 |
is useful for creating a batch file that is compatible with an older |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1805 |
version of rsync. For instance, if rsync 2.6.4 is being used with the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1806 |
\fB\-\-write\-batch\fP option, but rsync 2.6.3 is what will be used to run the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1807 |
-\fB\-\-read\-batch\fP option, you should use \(dq\&\-\-protocol=28\(dq\& when creating the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1808 |
+\fB\-\-read\-batch\fP option, you should use "\-\-protocol=28" when creating the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1809 |
batch file to force the older protocol version to be used in the batch |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1810 |
-file (assuming you can\(cq\&t upgrade the rsync on the reading system). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1811 |
+file (assuming you can't upgrade the rsync on the reading system). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1812 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1813 |
.IP "\fB\-\-iconv=CONVERT_SPEC\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1814 |
Rsync can convert filenames between character |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1815 |
-sets using this option. Using a CONVERT_SPEC of \(dq\&.\(dq\& tells rsync to look up |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1816 |
+sets using this option. Using a CONVERT_SPEC of "." tells rsync to look up |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1817 |
the default character\-set via the locale setting. Alternately, you can |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1818 |
fully specify what conversion to do by giving a local and a remote charset |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1819 |
separated by a comma in the order \fB\-\-iconv=LOCAL,REMOTE\fP, e.g. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1820 |
\fB\-\-iconv=utf8,iso88591\fP. This order ensures that the option |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1821 |
-will stay the same whether you\(cq\&re pushing or pulling files. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1822 |
-Finally, you can specify either \fB\-\-no\-iconv\fP or a CONVERT_SPEC of \(dq\&\-\(dq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1823 |
+will stay the same whether you're pushing or pulling files. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1824 |
+Finally, you can specify either \fB\-\-no\-iconv\fP or a CONVERT_SPEC of "\-" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1825 |
to turn off any conversion. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1826 |
The default setting of this option is site\-specific, and can also be |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1827 |
affected via the RSYNC_ICONV environment variable. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1828 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1829 |
For a list of what charset names your local iconv library supports, you can |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1830 |
-run \(dq\&iconv \-\-list\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1831 |
+run "iconv \-\-list". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1832 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1833 |
If you specify the \fB\-\-protect\-args\fP option (\fB\-s\fP), rsync will translate |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1834 |
the filenames you specify on the command\-line that are being sent to the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1835 |
@@ -2886,13 +2890,13 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1836 |
remote host. See also the \fB\-\-files\-from\fP option. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1837 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1838 |
Note that rsync does not do any conversion of names in filter files |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1839 |
-(including include/exclude files). It is up to you to ensure that you\(cq\&re |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1840 |
+(including include/exclude files). It is up to you to ensure that you're |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1841 |
specifying matching rules that can match on both sides of the transfer. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1842 |
For instance, you can specify extra include/exclude rules if there are |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1843 |
filename differences on the two sides that need to be accounted for. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1844 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1845 |
When you pass an \fB\-\-iconv\fP option to an rsync daemon that allows it, the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1846 |
-daemon uses the charset specified in its \(dq\&charset\(dq\& configuration parameter |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1847 |
+daemon uses the charset specified in its "charset" configuration parameter |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1848 |
regardless of the remote charset you actually pass. Thus, you may feel free to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1849 |
specify just the local charset for a daemon transfer (e.g. \fB\-\-iconv=utf8\fP). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1850 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1851 |
@@ -2909,7 +2913,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1852 |
.IP "\fB\-\-checksum\-seed=NUM\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1853 |
Set the checksum seed to the integer NUM. This 4 |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1854 |
byte checksum seed is included in each block and MD4 file checksum calculation |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1855 |
-(the more modern MD5 file checksums don\(cq\&t use a seed). By default the checksum |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1856 |
+(the more modern MD5 file checksums don't use a seed). By default the checksum |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1857 |
seed is generated by the server and defaults to the current |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1858 |
\f(CWtime()\fP |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1859 |
\&. This |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1860 |
@@ -2942,7 +2946,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1861 |
run as a daemon with the \fB\-\-daemon\fP option. The \fB\-\-address\fP option |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1862 |
allows you to specify a specific IP address (or hostname) to bind to. This |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1863 |
makes virtual hosting possible in conjunction with the \fB\-\-config\fP option. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1864 |
-See also the \(dq\&address\(dq\& global option in the rsyncd.conf manpage. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1865 |
+See also the "address" global option in the rsyncd.conf manpage. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1866 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1867 |
.IP "\fB\-\-bwlimit=RATE\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1868 |
This option allows you to specify the maximum transfer |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1869 |
@@ -2960,7 +2964,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1870 |
.IP "\fB\-M, \-\-dparam=OVERRIDE\fP" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1871 |
This option can be used to set a daemon\-config |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1872 |
parameter when starting up rsync in daemon mode. It is equivalent to adding |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1873 |
-the parameter at the end of the global settings prior to the first module\(cq\&s |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1874 |
+the parameter at the end of the global settings prior to the first module's |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1875 |
definition. The parameter names can be specified without spaces, if you so |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1876 |
desire. For instance: |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1877 |
.IP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1878 |
@@ -2974,7 +2978,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1879 |
rsync to not detach itself and become a background process. This |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1880 |
option is required when running as a service on Cygwin, and may also |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1881 |
be useful when rsync is supervised by a program such as |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1882 |
-\fBdaemontools\fP or AIX\(cq\&s \fBSystem Resource Controller\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1883 |
+\fBdaemontools\fP or AIX's \fBSystem Resource Controller\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1884 |
\fB\-\-no\-detach\fP is also recommended when rsync is run under a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1885 |
debugger. This option has no effect if rsync is run from inetd or |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1886 |
sshd. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1887 |
@@ -2981,18 +2985,18 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1888 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1889 |
.IP "\fB\-\-port=PORT\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1890 |
This specifies an alternate TCP port number for the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1891 |
-daemon to listen on rather than the default of 873. See also the \(dq\&port\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1892 |
+daemon to listen on rather than the default of 873. See also the "port" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1893 |
global option in the rsyncd.conf manpage. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1894 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1895 |
.IP "\fB\-\-log\-file=FILE\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1896 |
This option tells the rsync daemon to use the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1897 |
-given log\-file name instead of using the \(dq\&log file\(dq\& setting in the config |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1898 |
+given log\-file name instead of using the "log file" setting in the config |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1899 |
file. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1900 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1901 |
.IP "\fB\-\-log\-file\-format=FORMAT\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1902 |
This option tells the rsync daemon to use the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1903 |
-given FORMAT string instead of using the \(dq\&log format\(dq\& setting in the config |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1904 |
-file. It also enables \(dq\&transfer logging\(dq\& unless the string is empty, in which |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1905 |
+given FORMAT string instead of using the "log format" setting in the config |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1906 |
+file. It also enables "transfer logging" unless the string is empty, in which |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1907 |
case transfer logging is turned off. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1908 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1909 |
.IP "\fB\-\-sockopts\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1910 |
@@ -3002,8 +3006,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1911 |
.IP "\fB\-v, \-\-verbose\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1912 |
This option increases the amount of information the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1913 |
daemon logs during its startup phase. After the client connects, the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1914 |
-daemon\(cq\&s verbosity level will be controlled by the options that the client |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1915 |
-used and the \(dq\&max verbosity\(dq\& setting in the module\(cq\&s config section. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1916 |
+daemon's verbosity level will be controlled by the options that the client |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1917 |
+used and the "max verbosity" setting in the module's config section. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1918 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1919 |
.IP "\fB\-4, \-\-ipv4\fP or \fB\-6, \-\-ipv6\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1920 |
Tells rsync to prefer IPv4/IPv6 |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1921 |
@@ -3010,7 +3014,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1922 |
when creating the incoming sockets that the rsync daemon will use to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1923 |
listen for connections. One of these options may be required in older |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1924 |
versions of Linux to work around an IPv6 bug in the kernel (if you see |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1925 |
-an \(dq\&address already in use\(dq\& error when nothing else is using the port, |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1926 |
+an "address already in use" error when nothing else is using the port, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1927 |
try specifying \fB\-\-ipv6\fP or \fB\-\-ipv4\fP when starting the daemon). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1928 |
.IP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1929 |
If rsync was complied without support for IPv6, the \fB\-\-ipv6\fP option |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1930 |
@@ -3049,7 +3053,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1931 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1932 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1933 |
You have your choice of using either short or long RULE names, as described |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1934 |
-below. If you use a short\-named rule, the \(cq\&,\(cq\& separating the RULE from the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1935 |
+below. If you use a short\-named rule, the ',' separating the RULE from the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1936 |
MODIFIERS is optional. The PATTERN or FILENAME that follows (when present) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1937 |
must come after either a single space or an underscore (_). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1938 |
Here are the available rule prefixes: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1939 |
@@ -3077,15 +3081,15 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1940 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1941 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1942 |
When rules are being read from a file, empty lines are ignored, as are |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1943 |
-comment lines that start with a \(dq\&#\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1944 |
+comment lines that start with a "#". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1945 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1946 |
Note that the \fB\-\-include\fP/\fB\-\-exclude\fP command\-line options do not allow the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1947 |
full range of rule parsing as described above \-\- they only allow the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1948 |
-specification of include/exclude patterns plus a \(dq\&!\(dq\& token to clear the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1949 |
+specification of include/exclude patterns plus a "!" token to clear the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1950 |
list (and the normal comment parsing when rules are read from a file). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1951 |
If a pattern |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1952 |
-does not begin with \(dq\&\- \(dq\& (dash, space) or \(dq\&+ \(dq\& (plus, space), then the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1953 |
-rule will be interpreted as if \(dq\&+ \(dq\& (for an include option) or \(dq\&\- \(dq\& (for |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1954 |
+does not begin with "\- " (dash, space) or "+ " (plus, space), then the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1955 |
+rule will be interpreted as if "+ " (for an include option) or "\- " (for |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1956 |
an exclude option) were prefixed to the string. A \fB\-\-filter\fP option, on |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1957 |
the other hand, must always contain either a short or long rule name at the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1958 |
start of the rule. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1959 |
@@ -3098,8 +3102,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1960 |
.SH "INCLUDE/EXCLUDE PATTERN RULES" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1961 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1962 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1963 |
-You can include and exclude files by specifying patterns using the \(dq\&+\(dq\&, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1964 |
-\(dq\&\-\(dq\&, etc. filter rules (as introduced in the FILTER RULES section above). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1965 |
+You can include and exclude files by specifying patterns using the "+", |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1966 |
+"\-", etc. filter rules (as introduced in the FILTER RULES section above). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1967 |
The include/exclude rules each specify a pattern that is matched against |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1968 |
the names of the files that are going to be transferred. These patterns |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1969 |
can take several forms: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1970 |
@@ -3109,15 +3113,15 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1971 |
particular spot in the hierarchy of files, otherwise it is matched |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1972 |
against the end of the pathname. This is similar to a leading ^ in |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1973 |
regular expressions. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1974 |
-Thus \(dq\&/foo\(dq\& would match a name of \(dq\&foo\(dq\& at either the \(dq\&root of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1975 |
-transfer\(dq\& (for a global rule) or in the merge\-file\(cq\&s directory (for a |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1976 |
+Thus "/foo" would match a name of "foo" at either the "root of the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1977 |
+transfer" (for a global rule) or in the merge\-file's directory (for a |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1978 |
per\-directory rule). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1979 |
-An unqualified \(dq\&foo\(dq\& would match a name of \(dq\&foo\(dq\& anywhere in the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1980 |
+An unqualified "foo" would match a name of "foo" anywhere in the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1981 |
tree because the algorithm is applied recursively from the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1982 |
top down; it behaves as if each path component gets a turn at being the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1983 |
-end of the filename. Even the unanchored \(dq\&sub/foo\(dq\& would match at |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1984 |
-any point in the hierarchy where a \(dq\&foo\(dq\& was found within a directory |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1985 |
-named \(dq\&sub\(dq\&. See the section on ANCHORING INCLUDE/EXCLUDE PATTERNS for |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1986 |
+end of the filename. Even the unanchored "sub/foo" would match at |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1987 |
+any point in the hierarchy where a "foo" was found within a directory |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1988 |
+named "sub". See the section on ANCHORING INCLUDE/EXCLUDE PATTERNS for |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1989 |
a full discussion of how to specify a pattern that matches at the root |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1990 |
of the transfer. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1991 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1992 |
@@ -3126,44 +3130,44 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1993 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1994 |
rsync chooses between doing a simple string match and wildcard |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1995 |
matching by checking if the pattern contains one of these three wildcard |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1996 |
-characters: \(cq\&*\(cq\&, \(cq\&?\(cq\&, and \(cq\&[\(cq\& . |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
1997 |
+characters: '*', '?', and '[' . |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1998 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
1999 |
-a \(cq\&*\(cq\& matches any path component, but it stops at slashes. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2000 |
+a '*' matches any path component, but it stops at slashes. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2001 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2002 |
-use \(cq\&**\(cq\& to match anything, including slashes. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2003 |
+use '**' to match anything, including slashes. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2004 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2005 |
-a \(cq\&?\(cq\& matches any character except a slash (/). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2006 |
+a '?' matches any character except a slash (/). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2007 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2008 |
-a \(cq\&[\(cq\& introduces a character class, such as [a\-z] or [[:alpha:]]. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2009 |
+a '[' introduces a character class, such as [a\-z] or [[:alpha:]]. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2010 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2011 |
in a wildcard pattern, a backslash can be used to escape a wildcard |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2012 |
character, but it is matched literally when no wildcards are present. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2013 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2014 |
-if the pattern contains a / (not counting a trailing /) or a \(dq\&**\(dq\&, |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2015 |
+if the pattern contains a / (not counting a trailing /) or a "**", |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2016 |
then it is matched against the full pathname, including any leading |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2017 |
-directories. If the pattern doesn\(cq\&t contain a / or a \(dq\&**\(dq\&, then it is |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2018 |
+directories. If the pattern doesn't contain a / or a "**", then it is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2019 |
matched only against the final component of the filename. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2020 |
-(Remember that the algorithm is applied recursively so \(dq\&full filename\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2021 |
+(Remember that the algorithm is applied recursively so "full filename" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2022 |
can actually be any portion of a path from the starting directory on |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2023 |
down.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2024 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2025 |
-a trailing \(dq\&dir_name/***\(dq\& will match both the directory (as if |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2026 |
-\(dq\&dir_name/\(dq\& had been specified) and everything in the directory |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2027 |
-(as if \(dq\&dir_name/**\(dq\& had been specified). This behavior was added in |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2028 |
+a trailing "dir_name/***" will match both the directory (as if |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2029 |
+"dir_name/" had been specified) and everything in the directory |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2030 |
+(as if "dir_name/**" had been specified). This behavior was added in |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2031 |
version 2.6.7. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2032 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2033 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2034 |
Note that, when using the \fB\-\-recursive\fP (\fB\-r\fP) option (which is implied by |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2035 |
\fB\-a\fP), every subcomponent of every path is visited from the top down, so |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2036 |
-include/exclude patterns get applied recursively to each subcomponent\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2037 |
-full name (e.g. to include \(dq\&/foo/bar/baz\(dq\& the subcomponents \(dq\&/foo\(dq\& and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2038 |
-\(dq\&/foo/bar\(dq\& must not be excluded). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2039 |
+include/exclude patterns get applied recursively to each subcomponent's |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2040 |
+full name (e.g. to include "/foo/bar/baz" the subcomponents "/foo" and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2041 |
+"/foo/bar" must not be excluded). |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2042 |
The exclude patterns actually short\-circuit the directory traversal stage |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2043 |
when rsync finds the files to send. If a pattern excludes a particular |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2044 |
parent directory, it can render a deeper include pattern ineffectual |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2045 |
because rsync did not descend through that excluded section of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2046 |
-hierarchy. This is particularly important when using a trailing \(cq\&*\(cq\& rule. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2047 |
-For instance, this won\(cq\&t work: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2048 |
+hierarchy. This is particularly important when using a trailing '*' rule. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2049 |
+For instance, this won't work: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2050 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2051 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2052 |
\f(CW+ /some/path/this\-file\-will\-not\-be\-found\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2053 |
@@ -3175,11 +3179,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2054 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2055 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2056 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2057 |
-This fails because the parent directory \(dq\&some\(dq\& is excluded by the \(cq\&*\(cq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2058 |
-rule, so rsync never visits any of the files in the \(dq\&some\(dq\& or \(dq\&some/path\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2059 |
+This fails because the parent directory "some" is excluded by the '*' |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2060 |
+rule, so rsync never visits any of the files in the "some" or "some/path" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2061 |
directories. One solution is to ask for all directories in the hierarchy |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2062 |
-to be included by using a single rule: \(dq\&+ */\(dq\& (put it somewhere before the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2063 |
-\(dq\&\- *\(dq\& rule), and perhaps use the \fB\-\-prune\-empty\-dirs\fP option. Another |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2064 |
+to be included by using a single rule: "+ */" (put it somewhere before the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2065 |
+"\- *" rule), and perhaps use the \fB\-\-prune\-empty\-dirs\fP option. Another |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2066 |
solution is to add specific include rules for all |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2067 |
the parent dirs that need to be visited. For instance, this set of rules |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2068 |
works fine: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2069 |
@@ -3201,44 +3205,44 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2070 |
Here are some examples of exclude/include matching: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2071 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2072 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2073 |
-\(dq\&\- *.o\(dq\& would exclude all names matching *.o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2074 |
+"\- *.o" would exclude all names matching *.o |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2075 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2076 |
-\(dq\&\- /foo\(dq\& would exclude a file (or directory) named foo in the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2077 |
+"\- /foo" would exclude a file (or directory) named foo in the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2078 |
transfer\-root directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2079 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2080 |
-\(dq\&\- foo/\(dq\& would exclude any directory named foo |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2081 |
+"\- foo/" would exclude any directory named foo |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2082 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2083 |
-\(dq\&\- /foo/*/bar\(dq\& would exclude any file named bar which is at two |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2084 |
+"\- /foo/*/bar" would exclude any file named bar which is at two |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2085 |
levels below a directory named foo in the transfer\-root directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2086 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2087 |
-\(dq\&\- /foo/**/bar\(dq\& would exclude any file named bar two |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2088 |
+"\- /foo/**/bar" would exclude any file named bar two |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2089 |
or more levels below a directory named foo in the transfer\-root directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2090 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2091 |
-The combination of \(dq\&+ */\(dq\&, \(dq\&+ *.c\(dq\&, and \(dq\&\- *\(dq\& would include all |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2092 |
+The combination of "+ */", "+ *.c", and "\- *" would include all |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2093 |
directories and C source files but nothing else (see also the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2094 |
\fB\-\-prune\-empty\-dirs\fP option) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2095 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2096 |
-The combination of \(dq\&+ foo/\(dq\&, \(dq\&+ foo/bar.c\(dq\&, and \(dq\&\- *\(dq\& would include |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2097 |
+The combination of "+ foo/", "+ foo/bar.c", and "\- *" would include |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2098 |
only the foo directory and foo/bar.c (the foo directory must be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2099 |
-explicitly included or it would be excluded by the \(dq\&*\(dq\&) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2100 |
+explicitly included or it would be excluded by the "*") |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2101 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2102 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2103 |
-The following modifiers are accepted after a \(dq\&+\(dq\& or \(dq\&\-\(dq\&: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2104 |
+The following modifiers are accepted after a "+" or "\-": |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2105 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2106 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2107 |
A \fB/\fP specifies that the include/exclude rule should be matched |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2108 |
against the absolute pathname of the current item. For example, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2109 |
-\(dq\&\-/ /etc/passwd\(dq\& would exclude the passwd file any time the transfer |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2110 |
-was sending files from the \(dq\&/etc\(dq\& directory, and \(dq\&\-/ subdir/foo\(dq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2111 |
-would always exclude \(dq\&foo\(dq\& when it is in a dir named \(dq\&subdir\(dq\&, even |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2112 |
-if \(dq\&foo\(dq\& is at the root of the current transfer. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2113 |
+"\-/ /etc/passwd" would exclude the passwd file any time the transfer |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2114 |
+was sending files from the "/etc" directory, and "\-/ subdir/foo" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2115 |
+would always exclude "foo" when it is in a dir named "subdir", even |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2116 |
+if "foo" is at the root of the current transfer. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2117 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2118 |
A \fB!\fP specifies that the include/exclude should take effect if |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2119 |
-the pattern fails to match. For instance, \(dq\&\-! */\(dq\& would exclude all |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2120 |
+the pattern fails to match. For instance, "\-! */" would exclude all |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2121 |
non\-directories. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2122 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2123 |
A \fBC\fP is used to indicate that all the global CVS\-exclude rules |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2124 |
-should be inserted as excludes in place of the \(dq\&\-C\(dq\&. No arg should |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2125 |
+should be inserted as excludes in place of the "\-C". No arg should |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2126 |
follow. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2127 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2128 |
An \fBs\fP is used to indicate that the rule applies to the sending |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2129 |
@@ -3256,7 +3260,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2130 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2131 |
A \fBp\fP indicates that a rule is perishable, meaning that it is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2132 |
ignored in directories that are being deleted. For instance, the \fB\-C\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2133 |
-option\(cq\&s default rules that exclude things like \(dq\&CVS\(dq\& and \(dq\&*.o\(dq\& are |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2134 |
+option's default rules that exclude things like "CVS" and "*.o" are |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2135 |
marked as perishable, and will not prevent a directory that was removed |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2136 |
on the source from being deleted on the destination. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2137 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2138 |
@@ -3268,9 +3272,9 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2139 |
merge (.) or a dir\-merge (:) filter rule (as introduced in the FILTER RULES |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2140 |
section above). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2141 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2142 |
-There are two kinds of merged files \-\- single\-instance (\(cq\&.\(cq\&) and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2143 |
-per\-directory (\(cq\&:\(cq\&). A single\-instance merge file is read one time, and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2144 |
-its rules are incorporated into the filter list in the place of the \(dq\&.\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2145 |
+There are two kinds of merged files \-\- single\-instance ('.') and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2146 |
+per\-directory (':'). A single\-instance merge file is read one time, and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2147 |
+its rules are incorporated into the filter list in the place of the "." |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2148 |
rule. For per\-directory merge files, rsync will scan every directory that |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2149 |
it traverses for the named file, merging its contents when the file exists |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2150 |
into the current list of inherited rules. These per\-directory rule files |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2151 |
@@ -3277,7 +3281,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2152 |
must be created on the sending side because it is the sending side that is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2153 |
being scanned for the available files to transfer. These rule files may |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2154 |
also need to be transferred to the receiving side if you want them to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2155 |
-affect what files don\(cq\&t get deleted (see PER\-DIRECTORY RULES AND DELETE |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2156 |
+affect what files don't get deleted (see PER\-DIRECTORY RULES AND DELETE |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2157 |
below). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2158 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2159 |
Some examples: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2160 |
@@ -3306,12 +3310,12 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2161 |
patterns, with no other rule\-parsing except for in\-file comments. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2162 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2163 |
A \fBC\fP is a way to specify that the file should be read in a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2164 |
-CVS\-compatible manner. This turns on \(cq\&n\(cq\&, \(cq\&w\(cq\&, and \(cq\&\-\(cq\&, but also |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2165 |
+CVS\-compatible manner. This turns on 'n', 'w', and '\-', but also |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2166 |
allows the list\-clearing token (!) to be specified. If no filename is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2167 |
-provided, \(dq\&.cvsignore\(dq\& is assumed. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2168 |
+provided, ".cvsignore" is assumed. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2169 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2170 |
A \fBe\fP will exclude the merge\-file name from the transfer; e.g. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2171 |
-\(dq\&dir\-merge,e .rules\(dq\& is like \(dq\&dir\-merge .rules\(dq\& and \(dq\&\- .rules\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2172 |
+"dir\-merge,e .rules" is like "dir\-merge .rules" and "\- .rules". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2173 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2174 |
An \fBn\fP specifies that the rules are not inherited by subdirectories. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2175 |
.IP o |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2176 |
@@ -3318,15 +3322,15 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2177 |
A \fBw\fP specifies that the rules are word\-split on whitespace instead |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2178 |
of the normal line\-splitting. This also turns off comments. Note: the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2179 |
space that separates the prefix from the rule is treated specially, so |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2180 |
-\(dq\&\- foo + bar\(dq\& is parsed as two rules (assuming that prefix\-parsing wasn\(cq\&t |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2181 |
+"\- foo + bar" is parsed as two rules (assuming that prefix\-parsing wasn't |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2182 |
also disabled). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2183 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2184 |
-You may also specify any of the modifiers for the \(dq\&+\(dq\& or \(dq\&\-\(dq\& rules |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2185 |
+You may also specify any of the modifiers for the "+" or "\-" rules |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2186 |
(above) in order to have the rules that are read in from the file |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2187 |
default to having that modifier set (except for the \fB!\fP modifier, which |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2188 |
-would not be useful). For instance, \(dq\&merge,\-/ .excl\(dq\& would |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2189 |
+would not be useful). For instance, "merge,\-/ .excl" would |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2190 |
treat the contents of .excl as absolute\-path excludes, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2191 |
-while \(dq\&dir\-merge,s .filt\(dq\& and \(dq\&:sC\(dq\& would each make all their |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2192 |
+while "dir\-merge,s .filt" and ":sC" would each make all their |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2193 |
per\-directory rules apply only on the sending side. If the merge rule |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2194 |
specifies sides to affect (via the \fBs\fP or \fBr\fP modifier or both), |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2195 |
then the rules in the file must not specify sides (via a modifier or |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2196 |
@@ -3334,22 +3338,22 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2197 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2198 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2199 |
Per\-directory rules are inherited in all subdirectories of the directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2200 |
-where the merge\-file was found unless the \(cq\&n\(cq\& modifier was used. Each |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2201 |
-subdirectory\(cq\&s rules are prefixed to the inherited per\-directory rules |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2202 |
+where the merge\-file was found unless the 'n' modifier was used. Each |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2203 |
+subdirectory's rules are prefixed to the inherited per\-directory rules |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2204 |
from its parents, which gives the newest rules a higher priority than the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2205 |
inherited rules. The entire set of dir\-merge rules are grouped together in |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2206 |
the spot where the merge\-file was specified, so it is possible to override |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2207 |
dir\-merge rules via a rule that got specified earlier in the list of global |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2208 |
-rules. When the list\-clearing rule (\(dq\&!\(dq\&) is read from a per\-directory |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2209 |
+rules. When the list\-clearing rule ("!") is read from a per\-directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2210 |
file, it only clears the inherited rules for the current merge file. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2211 |
.PP |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2212 |
Another way to prevent a single rule from a dir\-merge file from being inherited is to |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2213 |
anchor it with a leading slash. Anchored rules in a per\-directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2214 |
-merge\-file are relative to the merge\-file\(cq\&s directory, so a pattern \(dq\&/foo\(dq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2215 |
-would only match the file \(dq\&foo\(dq\& in the directory where the dir\-merge filter |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2216 |
+merge\-file are relative to the merge\-file's directory, so a pattern "/foo" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2217 |
+would only match the file "foo" in the directory where the dir\-merge filter |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2218 |
file was found. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2219 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2220 |
-Here\(cq\&s an example filter file which you\(cq\&d specify via \fB\-\-filter=\(dq\&. file\(dq\&:\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2221 |
+Here's an example filter file which you'd specify via \fB\-\-filter=". file":\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2222 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2223 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2224 |
\f(CWmerge /home/user/.global\-filter\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2225 |
@@ -3366,7 +3370,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2226 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2227 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2228 |
This will merge the contents of the /home/user/.global\-filter file at the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2229 |
-start of the list and also turns the \(dq\&.rules\(dq\& filename into a per\-directory |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2230 |
+start of the list and also turns the ".rules" filename into a per\-directory |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2231 |
filter file. All rules read in prior to the start of the directory scan |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2232 |
follow the global anchoring rules (i.e. a leading slash matches at the root |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2233 |
of the transfer). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2234 |
@@ -3377,7 +3381,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2235 |
per\-directory file. For instance, here is a common filter (see \fB\-F\fP): |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2236 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2237 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2238 |
-\f(CW\-\-filter='\&: /.rsync\-filter'\&\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2239 |
+\f(CW\-\-filter=': /.rsync\-filter'\fP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2240 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2241 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2242 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2243 |
@@ -3385,7 +3389,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2244 |
directories from the root down through the parent directory of the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2245 |
transfer prior to the start of the normal directory scan of the file in |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2246 |
the directories that are sent as a part of the transfer. (Note: for an |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2247 |
-rsync daemon, the root is always the same as the module\(cq\&s \(dq\&path\(dq\&.) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2248 |
+rsync daemon, the root is always the same as the module's "path".) |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2249 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2250 |
Some examples of this pre\-scanning for per\-directory files: |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2251 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2252 |
@@ -3392,31 +3396,31 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2253 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2254 |
\f(CWrsync \-avF /src/path/ /dest/dir\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2255 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2256 |
-\f(CWrsync \-av \-\-filter='\&: ../../.rsync\-filter'\& /src/path/ /dest/dir\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2257 |
+\f(CWrsync \-av \-\-filter=': ../../.rsync\-filter' /src/path/ /dest/dir\fP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2258 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2259 |
-\f(CWrsync \-av \-\-filter='\&: .rsync\-filter'\& /src/path/ /dest/dir\fP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2260 |
+\f(CWrsync \-av \-\-filter=': .rsync\-filter' /src/path/ /dest/dir\fP |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2261 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2262 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2263 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2264 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2265 |
-The first two commands above will look for \(dq\&.rsync\-filter\(dq\& in \(dq\&/\(dq\& and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2266 |
-\(dq\&/src\(dq\& before the normal scan begins looking for the file in \(dq\&/src/path\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2267 |
+The first two commands above will look for ".rsync\-filter" in "/" and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2268 |
+"/src" before the normal scan begins looking for the file in "/src/path" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2269 |
and its subdirectories. The last command avoids the parent\-dir scan |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2270 |
-and only looks for the \(dq\&.rsync\-filter\(dq\& files in each directory that is |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2271 |
+and only looks for the ".rsync\-filter" files in each directory that is |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2272 |
a part of the transfer. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2273 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2274 |
-If you want to include the contents of a \(dq\&.cvsignore\(dq\& in your patterns, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2275 |
-you should use the rule \(dq\&:C\(dq\&, which creates a dir\-merge of the .cvsignore |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2276 |
+If you want to include the contents of a ".cvsignore" in your patterns, |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2277 |
+you should use the rule ":C", which creates a dir\-merge of the .cvsignore |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2278 |
file, but parsed in a CVS\-compatible manner. You can |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2279 |
-use this to affect where the \fB\-\-cvs\-exclude\fP (\fB\-C\fP) option\(cq\&s inclusion of the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2280 |
+use this to affect where the \fB\-\-cvs\-exclude\fP (\fB\-C\fP) option's inclusion of the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2281 |
per\-directory .cvsignore file gets placed into your rules by putting the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2282 |
-\(dq\&:C\(dq\& wherever you like in your filter rules. Without this, rsync would |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2283 |
+":C" wherever you like in your filter rules. Without this, rsync would |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2284 |
add the dir\-merge rule for the .cvsignore file at the end of all your other |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2285 |
rules (giving it a lower priority than your command\-line rules). For |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2286 |
example: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2287 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2288 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2289 |
-\f(CWcat <<EOT | rsync \-avC \-\-filter='\&. \-'\& a/ b\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2290 |
+\f(CWcat <<EOT | rsync \-avC \-\-filter='. \-' a/ b\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2291 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2292 |
\f(CW+ foo.o\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2293 |
.br |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2294 |
@@ -3426,7 +3430,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2295 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2296 |
\f(CWEOT\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2297 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2298 |
-\f(CWrsync \-avC \-\-include=foo.o \-f :C \-\-exclude='\&*.old'\& a/ b\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2299 |
+\f(CWrsync \-avC \-\-include=foo.o \-f :C \-\-exclude='*.old' a/ b\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2300 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2301 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2302 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2303 |
@@ -3437,25 +3441,25 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2304 |
that follow the :C instead of being subservient to all your rules. To |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2305 |
affect the other CVS exclude rules (i.e. the default list of exclusions, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2306 |
the contents of $HOME/.cvsignore, and the value of $CVSIGNORE) you should |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2307 |
-omit the \fB\-C\fP command\-line option and instead insert a \(dq\&\-C\(dq\& rule into |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2308 |
-your filter rules; e.g. \(dq\&\fB\-\-filter=\-C\fP\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2309 |
+omit the \fB\-C\fP command\-line option and instead insert a "\-C" rule into |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2310 |
+your filter rules; e.g. "\fB\-\-filter=\-C\fP". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2311 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2312 |
.SH "LIST\-CLEARING FILTER RULE" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2313 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2314 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2315 |
-You can clear the current include/exclude list by using the \(dq\&!\(dq\& filter |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2316 |
-rule (as introduced in the FILTER RULES section above). The \(dq\¤t\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2317 |
+You can clear the current include/exclude list by using the "!" filter |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2318 |
+rule (as introduced in the FILTER RULES section above). The "current" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2319 |
list is either the global list of rules (if the rule is encountered while |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2320 |
parsing the filter options) or a set of per\-directory rules (which are |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2321 |
inherited in their own sub\-list, so a subdirectory can use this to clear |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2322 |
-out the parent\(cq\&s rules). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2323 |
+out the parent's rules). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2324 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2325 |
.SH "ANCHORING INCLUDE/EXCLUDE PATTERNS" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2326 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2327 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2328 |
As mentioned earlier, global include/exclude patterns are anchored at the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2329 |
-\(dq\&root of the transfer\(dq\& (as opposed to per\-directory patterns, which are |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2330 |
-anchored at the merge\-file\(cq\&s directory). If you think of the transfer as |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2331 |
+"root of the transfer" (as opposed to per\-directory patterns, which are |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2332 |
+anchored at the merge\-file's directory). If you think of the transfer as |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2333 |
a subtree of names that are being sent from sender to receiver, the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2334 |
transfer\-root is where the tree starts to be duplicated in the destination |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2335 |
directory. This root governs where patterns that start with a / match. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2336 |
@@ -3466,8 +3470,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2337 |
changing how much of the file tree is duplicated on the destination |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2338 |
host). The following examples demonstrate this. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2339 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2340 |
-Let\(cq\&s say that we want to match two source files, one with an absolute |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2341 |
-path of \(dq\&/home/me/foo/bar\(dq\&, and one with a path of \(dq\&/home/you/bar/baz\(dq\&. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2342 |
+Let's say that we want to match two source files, one with an absolute |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2343 |
+path of "/home/me/foo/bar", and one with a path of "/home/you/bar/baz". |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2344 |
Here is how the various command choices differ for a 2\-source transfer: |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2345 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2346 |
.RS |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2347 |
@@ -3487,9 +3491,9 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2348 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2349 |
Example cmd: rsync \-a /home/me/ /home/you/ /dest |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2350 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2351 |
-+/\- pattern: /foo/bar (note missing \(dq\&me\(dq\&) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2352 |
++/\- pattern: /foo/bar (note missing "me") |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2353 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2354 |
-+/\- pattern: /bar/baz (note missing \(dq\&you\(dq\&) |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2355 |
++/\- pattern: /bar/baz (note missing "you") |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2356 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2357 |
Target file: /dest/foo/bar |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2358 |
.br |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2359 |
@@ -3528,7 +3532,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2360 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2361 |
The easiest way to see what name you should filter is to just |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2362 |
look at the output when using \fB\-\-verbose\fP and put a / in front of the name |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2363 |
-(use the \fB\-\-dry\-run\fP option if you\(cq\&re not yet ready to copy any files). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2364 |
+(use the \fB\-\-dry\-run\fP option if you're not yet ready to copy any files). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2365 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2366 |
.SH "PER\-DIRECTORY RULES AND DELETE" |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2367 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2368 |
@@ -3535,19 +3539,19 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2369 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2370 |
Without a delete option, per\-directory rules are only relevant on the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2371 |
sending side, so you can feel free to exclude the merge files themselves |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2372 |
-without affecting the transfer. To make this easy, the \(cq\&e\(cq\& modifier adds |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2373 |
+without affecting the transfer. To make this easy, the 'e' modifier adds |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2374 |
this exclude for you, as seen in these two equivalent commands: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2375 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2376 |
.RS |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2377 |
-\f(CWrsync \-av \-\-filter='\&: .excl'\& \-\-exclude=.excl host:src/dir /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2378 |
+\f(CWrsync \-av \-\-filter=': .excl' \-\-exclude=.excl host:src/dir /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2379 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2380 |
-\f(CWrsync \-av \-\-filter='\&:e .excl'\& host:src/dir /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2381 |
+\f(CWrsync \-av \-\-filter=':e .excl' host:src/dir /dest\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2382 |
.br |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2383 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2384 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2385 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2386 |
However, if you want to do a delete on the receiving side AND you want some |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2387 |
-files to be excluded from being deleted, you\(cq\&ll need to be sure that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2388 |
+files to be excluded from being deleted, you'll need to be sure that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2389 |
receiving side knows what files to exclude. The easiest way is to include |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2390 |
the per\-directory merge files in the transfer and use \fB\-\-delete\-after\fP, |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2391 |
because this ensures that the receiving side gets all the same exclude |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2392 |
@@ -3558,14 +3562,14 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2393 |
.RE |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2394 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2395 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2396 |
-However, if the merge files are not a part of the transfer, you\(cq\&ll need to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2397 |
+However, if the merge files are not a part of the transfer, you'll need to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2398 |
either specify some global exclude rules (i.e. specified on the command |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2399 |
-line), or you\(cq\&ll need to maintain your own per\-directory merge files on |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2400 |
+line), or you'll need to maintain your own per\-directory merge files on |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2401 |
the receiving side. An example of the first is this (assume that the |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2402 |
remote .rules files exclude themselves): |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2403 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2404 |
.nf |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2405 |
-rsync \-av \-\-filter=\(cq\&: .rules\(cq\& \-\-filter=\(cq\&. /my/extra.rules\(cq\& |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2406 |
+rsync \-av \-\-filter=': .rules' \-\-filter='. /my/extra.rules' |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2407 |
\-\-delete host:src/dir /dest |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2408 |
.fi |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2409 |
|
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2410 |
@@ -3578,12 +3582,12 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2411 |
In one final example, the remote side is excluding the .rsync\-filter |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2412 |
files from the transfer, but we want to use our own .rsync\-filter files |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2413 |
to control what gets deleted on the receiving side. To do this we must |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2414 |
-specifically exclude the per\-directory merge files (so that they don\(cq\&t get |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2415 |
+specifically exclude the per\-directory merge files (so that they don't get |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2416 |
deleted) and then put rules into the local files to control what else |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2417 |
should not get deleted. Like one of these commands: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2418 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2419 |
.nf |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2420 |
- rsync \-av \-\-filter='\&:e /.rsync\-filter'\& \-\-delete \e |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2421 |
+ rsync \-av \-\-filter=':e /.rsync\-filter' \-\-delete \e |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2422 |
host:src/dir /dest |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2423 |
rsync \-avFF \-\-delete host:src/dir /dest |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2424 |
.fi |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2425 |
@@ -3599,7 +3603,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2426 |
hosts. In order to do this using batch mode, rsync is run with the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2427 |
write\-batch option to apply the changes made to the source tree to one |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2428 |
of the destination trees. The write\-batch option causes the rsync |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2429 |
-client to store in a \(dq\&batch file\(dq\& all the information needed to repeat |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2430 |
+client to store in a "batch file" all the information needed to repeat |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2431 |
this operation against other, identical destination trees. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2432 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2433 |
Generating the batch file once saves having to perform the file |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2434 |
@@ -3614,7 +3618,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2435 |
using the information stored in the batch file. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2436 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2437 |
For your convenience, a script file is also created when the write\-batch |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2438 |
-option is used: it will be named the same as the batch file with \(dq\&.sh\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2439 |
+option is used: it will be named the same as the batch file with ".sh" |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2440 |
appended. This script file contains a command\-line suitable for updating a |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2441 |
destination tree using the associated batch file. It can be executed using |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2442 |
a Bourne (or Bourne\-like) shell, optionally passing in an alternate |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2443 |
@@ -3643,25 +3647,25 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2444 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2445 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2446 |
In these examples, rsync is used to update /adest/dir/ from /source/dir/ |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2447 |
-and the information to repeat this operation is stored in \(dq\&foo\(dq\& and |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2448 |
-\(dq\&foo.sh\(dq\&. The host \(dq\&remote\(dq\& is then updated with the batched data going |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2449 |
+and the information to repeat this operation is stored in "foo" and |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2450 |
+"foo.sh". The host "remote" is then updated with the batched data going |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2451 |
into the directory /bdest/dir. The differences between the two examples |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2452 |
reveals some of the flexibility you have in how you deal with batches: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2453 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2454 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2455 |
-The first example shows that the initial copy doesn\(cq\&t have to be |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2456 |
+The first example shows that the initial copy doesn't have to be |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2457 |
local \-\- you can push or pull data to/from a remote host using either the |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2458 |
remote\-shell syntax or rsync daemon syntax, as desired. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2459 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2460 |
-The first example uses the created \(dq\&foo.sh\(dq\& file to get the right |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2461 |
+The first example uses the created "foo.sh" file to get the right |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2462 |
rsync options when running the read\-batch command on the remote host. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2463 |
.IP o |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2464 |
The second example reads the batch data via standard input so that |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2465 |
-the batch file doesn\(cq\&t need to be copied to the remote machine first. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2466 |
+the batch file doesn't need to be copied to the remote machine first. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2467 |
This example avoids the foo.sh script because it needed to use a modified |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2468 |
\fB\-\-read\-batch\fP option, but you could edit the script file if you wished to |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2469 |
make use of it (just be sure that no other option is trying to use |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2470 |
-standard input, such as the \(dq\&\fB\-\-exclude\-from=\-\fP\(dq\& option). |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2471 |
+standard input, such as the "\fB\-\-exclude\-from=\-\fP" option). |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2472 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2473 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2474 |
Caveats: |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2475 |
@@ -3674,7 +3678,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2476 |
and then, if the file fails to verify, the update discarded with an |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2477 |
error. This means that it should be safe to re\-run a read\-batch operation |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2478 |
if the command got interrupted. If you wish to force the batched\-update to |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2479 |
-always be attempted regardless of the file\(cq\&s size and date, use the \fB\-I\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2480 |
+always be attempted regardless of the file's size and date, use the \fB\-I\fP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2481 |
option (when reading the batch). |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2482 |
If an error occurs, the destination tree will probably be in a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2483 |
partially updated state. In that case, rsync can |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2484 |
@@ -3690,7 +3694,7 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2485 |
older than that with newer versions will not work.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2486 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2487 |
When reading a batch file, rsync will force the value of certain options |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2488 |
-to match the data in the batch file if you didn\(cq\&t set them to the same |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2489 |
+to match the data in the batch file if you didn't set them to the same |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2490 |
as the batch\-writing command. Other options can (and should) be changed. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2491 |
For instance \fB\-\-write\-batch\fP changes to \fB\-\-read\-batch\fP, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2492 |
\fB\-\-files\-from\fP is dropped, and the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2493 |
@@ -3698,13 +3702,13 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2494 |
one of the \fB\-\-delete\fP options is specified. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2495 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2496 |
The code that creates the BATCH.sh file transforms any filter/include/exclude |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2497 |
-options into a single list that is appended as a \(dq\&here\(dq\& document to the |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2498 |
+options into a single list that is appended as a "here" document to the |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2499 |
shell script file. An advanced user can use this to modify the exclude |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2500 |
list if a change in what gets deleted by \fB\-\-delete\fP is desired. A normal |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2501 |
user can ignore this detail and just use the shell script as an easy way |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2502 |
to run the appropriate \fB\-\-read\-batch\fP command for the batched data. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2503 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2504 |
-The original batch mode in rsync was based on \(dq\&rsync+\(dq\&, but the latest |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2505 |
+The original batch mode in rsync was based on "rsync+", but the latest |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2506 |
version uses a new implementation. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2507 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2508 |
.SH "SYMBOLIC LINKS" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2509 |
@@ -3714,16 +3718,16 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2510 |
link in the source directory. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2511 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2512 |
By default, symbolic links are not transferred at all. A message |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2513 |
-\(dq\&skipping non\-regular\(dq\& file is emitted for any symlinks that exist. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2514 |
+"skipping non\-regular" file is emitted for any symlinks that exist. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2515 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2516 |
If \fB\-\-links\fP is specified, then symlinks are recreated with the same |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2517 |
target on the destination. Note that \fB\-\-archive\fP implies |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2518 |
\fB\-\-links\fP. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2519 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2520 |
-If \fB\-\-copy\-links\fP is specified, then symlinks are \(dq\&collapsed\(dq\& by |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2521 |
+If \fB\-\-copy\-links\fP is specified, then symlinks are "collapsed" by |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2522 |
copying their referent, rather than the symlink. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2523 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2524 |
-Rsync can also distinguish \(dq\&safe\(dq\& and \(dq\&unsafe\(dq\& symbolic links. An |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2525 |
+Rsync can also distinguish "safe" and "unsafe" symbolic links. An |
1351
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2526 |
example where this might be used is a web site mirror that wishes to |
5c589218fa09
15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents:
297
diff
changeset
|
2527 |
ensure that the rsync module that is copied does not include symbolic links to |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2528 |
\fB/etc/passwd\fP in the public section of the site. Using |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2529 |
@@ -3733,11 +3737,11 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2530 |
\fB\-\-links\fP for \fB\-\-safe\-links\fP to have any effect.) |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2531 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2532 |
Symbolic links are considered unsafe if they are absolute symlinks |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2533 |
-(start with \fB/\fP), empty, or if they contain enough \(dq\&..\(dq\& |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2534 |
+(start with \fB/\fP), empty, or if they contain enough ".." |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2535 |
components to ascend from the directory being copied. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2536 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2537 |
-Here\(cq\&s a summary of how the symlink options are interpreted. The list is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2538 |
-in order of precedence, so if your combination of options isn\(cq\&t mentioned, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2539 |
+Here's a summary of how the symlink options are interpreted. The list is |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2540 |
+in order of precedence, so if your combination of options isn't mentioned, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2541 |
use the first line that is a complete subset of your options: |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2542 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2543 |
.IP "\fB\-\-copy\-links\fP" |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2544 |
@@ -3763,8 +3767,8 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2545 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2546 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2547 |
rsync occasionally produces error messages that may seem a little |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2548 |
-cryptic. The one that seems to cause the most confusion is \(dq\&protocol |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2549 |
-version mismatch \-\- is your shell clean?\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2550 |
+cryptic. The one that seems to cause the most confusion is "protocol |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2551 |
+version mismatch \-\- is your shell clean?". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2552 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2553 |
This message is usually caused by your startup scripts or remote shell |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2554 |
facility producing unwanted garbage on the stream that rsync is using |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2555 |
@@ -3864,13 +3868,13 @@ |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2556 |
password allows you to run authenticated rsync connections to an rsync |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2557 |
daemon without user intervention. Note that this does not supply a |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2558 |
password to a remote shell transport such as ssh; to learn how to do that, |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2559 |
-consult the remote shell\(cq\&s documentation. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2560 |
+consult the remote shell's documentation. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2561 |
.IP "\fBUSER\fP or \fBLOGNAME\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2562 |
The USER or LOGNAME environment variables |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2563 |
are used to determine the default username sent to an rsync daemon. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2564 |
-If neither is set, the username defaults to \(dq\&nobody\(dq\&. |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2565 |
+If neither is set, the username defaults to "nobody". |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2566 |
.IP "\fBHOME\fP" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2567 |
-The HOME environment variable is used to find the user\(cq\&s |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2568 |
+The HOME environment variable is used to find the user's |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2569 |
default .cvsignore file. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2570 |
|
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2571 |
.PP |
1817
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2572 |
@@ -3945,7 +3949,7 @@ |
ff42a83716c4
18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents:
1351
diff
changeset
|
2573 |
gone\-but\-not\-forgotten compadre, J.W. Schultz. |
297
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2574 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2575 |
Thanks also to Richard Brent, Brendan Mackay, Bill Waite, Stephen Rothwell |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2576 |
-and David Bell. I\(cq\&ve probably missed some people, my apologies if I have. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2577 |
+and David Bell. I've probably missed some people, my apologies if I have. |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2578 |
.PP |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2579 |
.SH "AUTHOR" |
3940bc347ca8
7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents:
296
diff
changeset
|
2580 |