components/rsync/patches/rsync.1.patch
author Lukas Rovensky <Lukas.Rovensky@oracle.com>
Mon, 18 Jan 2016 07:29:54 -0800
changeset 5303 0f5e16a0a75d
parent 3835 fff36af96643
child 5826 9c90e4a8156c
child 6487 6e536698eac2
permissions -rw-r--r--
20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
     5
Add information about rsync not supporting NFSv4 ACLs.
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
     6
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
     7
--- rsync-3.1.1/rsync.1.orig	2016-01-18 06:37:45.403381738 -0800
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
     8
+++ rsync-3.1.1/rsync.1	2016-01-20 11:02:51.388263060 -0800
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
     9
@@ -35,11 +35,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    10
 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
    11
 improved copy command for everyday use.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    12
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    13
-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
    14
+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
    15
 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
    16
 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
    17
 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
    18
-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
    19
+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
    20
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    21
 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
    22
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
    23
@@ -73,17 +73,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    24
 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
    25
 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
    26
 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
    27
-\(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
    28
+"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
    29
 an exception to this latter rule).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    30
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    31
 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
    32
-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
    33
+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
    34
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    35
 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
    36
 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
    37
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    38
-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
    39
-\(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
    40
+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
    41
+"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
    42
 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
    43
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    44
 .SH "SETUP"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
    45
@@ -132,7 +132,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    46
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    47
 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
    48
 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
    49
-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
    50
+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
    51
 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
    52
 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
    53
 size of data portions of the transfer.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
    54
@@ -144,8 +144,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    55
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    56
 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
    57
 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
    58
-/ on a source as meaning \(dq\&copy 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
    59
-to \(dq\&copy 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
    60
+/ 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
    61
+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
    62
 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
    63
 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
    64
 files in the same way, including their setting of the attributes of
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
    65
@@ -159,9 +159,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    66
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    67
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    68
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    69
-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
    70
+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
    71
 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
    72
-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
    73
+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
    74
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    75
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    76
 \f(CWrsync \-av host: /dest\fP
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
    77
@@ -172,7 +172,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    78
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    79
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
    80
 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
    81
-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
    82
+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
    83
 an improved copy command.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    84
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    85
 Finally, you can list all the (listable) modules available from a
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
    86
@@ -205,9 +205,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    87
 examples:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    88
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    89
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    90
-\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
    91
+\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
    92
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    93
-\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
    94
+\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
    95
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    96
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    97
 .PP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
    98
@@ -215,12 +215,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
    99
 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
   100
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   101
 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
   102
-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
   103
+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
   104
 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
   105
 instance:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   106
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   107
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   108
-\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
   109
+\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
   110
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   111
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   112
 .PP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   113
@@ -240,7 +240,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   114
 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
   115
 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
   116
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   117
-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
   118
+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
   119
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   120
 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
   121
 connect.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   122
@@ -254,7 +254,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   123
 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
   124
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   125
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   126
-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
   127
+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
   128
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   129
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   130
     rsync \-av host::src /dest
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   131
@@ -272,18 +272,18 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   132
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   133
 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
   134
 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
   135
-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
   136
+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
   137
 proxy connections to port 873.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   138
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   139
 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
   140
 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
   141
 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
   142
-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
   143
-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
   144
+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
   145
+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
   146
 example:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   147
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   148
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   149
-  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
   150
+  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
   151
   rsync \-av targethost1::module/src/ /dest/
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   152
   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
   153
 .fi 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   154
@@ -300,16 +300,16 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   155
 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
   156
 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
   157
 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
   158
-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
   159
+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
   160
 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
   161
-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
   162
+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
   163
 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
   164
 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
   165
 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
   166
 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
   167
-connections from \(dq\&localhost\(dq\&.)
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   168
+connections from "localhost".)
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   169
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   170
-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
   171
+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
   172
 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
   173
 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
   174
 explicitly set the remote shell program on the command\-line with the
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   175
@@ -324,20 +324,24 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   176
 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
   177
 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
   178
 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
   179
-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
   180
+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
   181
 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
   182
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   183
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   184
-    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
   185
+    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
   186
 .fi 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   187
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   188
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   189
-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
   190
-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
   191
+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
   192
+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
   193
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   194
 .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
   195
 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   196
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   197
+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
   198
+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
   199
+of any subprocessing.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   200
+.PP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   201
 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
   202
 daemon already running (or it needs to have configured something like inetd
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   203
 to spawn an rsync daemon for incoming connections on a particular port).
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   204
@@ -346,7 +350,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   205
 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
   206
 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
   207
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   208
-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
   209
+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
   210
 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
   211
 .PP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   212
 .SH "SORTED TRANSFER ORDER"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   213
@@ -360,7 +364,7 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   214
 .PP 
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   215
 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
   216
 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
   217
-\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
   218
+\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
   219
 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
   220
 .PP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   221
 .SH "EXAMPLES"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   222
@@ -368,7 +372,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   223
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   224
 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
   225
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   226
-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
   227
+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
   228
 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
   229
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   230
 .RS 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   231
@@ -377,14 +381,14 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   232
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   233
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   234
 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
   235
-\(dq\&arvidsjaur\(dq\&.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   236
+"arvidsjaur".
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   237
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   238
 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
   239
 targets:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   240
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   241
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   242
     get:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   243
-            rsync \-avuzb \-\-exclude '\&*~'\& samba:samba/ .
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   244
+            rsync \-avuzb \-\-exclude '*~' samba:samba/ .
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   245
     put:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   246
             rsync \-Cavuzb . samba:samba/
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   247
     sync: get put
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   248
@@ -393,12 +397,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   249
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   250
 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
   251
 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
   252
-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
   253
+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
   254
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   255
-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
   256
+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
   257
 command:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   258
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   259
-\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
   260
+\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
   261
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   262
 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
   263
 .PP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   264
@@ -420,7 +424,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   265
      \-\-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
   266
  \-r, \-\-recursive             recurse into directories
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   267
  \-R, \-\-relative              use relative path names
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   268
-     \-\-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
   269
+     \-\-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
   270
  \-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
   271
      \-\-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
   272
      \-\-suffix=SUFFIX         backup suffix (default ~ w/o \-\-backup\-dir)
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   273
@@ -431,7 +435,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   274
  \-d, \-\-dirs                  transfer directories without recursing
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   275
  \-l, \-\-links                 copy symlinks as symlinks
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   276
  \-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
   277
-     \-\-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
   278
+     \-\-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
   279
      \-\-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
   280
      \-\-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
   281
  \-k, \-\-copy\-dirlinks         transform symlink to dir into referent dir
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   282
@@ -456,7 +460,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   283
      \-\-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
   284
  \-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
   285
  \-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
   286
- \-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
   287
+ \-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
   288
  \-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
   289
  \-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
   290
      \-\-rsync\-path=PROGRAM    specify the rsync to run on remote machine
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   291
@@ -474,20 +478,20 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   292
      \-\-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
   293
      \-\-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
   294
      \-\-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
   295
-     \-\-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
   296
-     \-\-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
   297
-     \-\-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
   298
+     \-\-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
   299
+     \-\-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
   300
+     \-\-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
   301
      \-\-partial               keep partially transferred files
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   302
      \-\-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
   303
      \-\-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
   304
  \-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
   305
-     \-\-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
   306
+     \-\-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
   307
      \-\-usermap=STRING        custom username mapping
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   308
      \-\-groupmap=STRING       custom groupname mapping
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   309
      \-\-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
   310
      \-\-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
   311
      \-\-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
   312
- \-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
   313
+ \-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
   314
      \-\-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
   315
      \-\-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
   316
  \-T, \-\-temp\-dir=DIR          create temporary files in directory DIR
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   317
@@ -500,11 +504,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   318
      \-\-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
   319
  \-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
   320
  \-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
   321
- \-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
   322
-                             repeated: \-\-filter='\&\- .rsync\-filter'\&
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   323
+ \-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
   324
+                             repeated: \-\-filter='\- .rsync\-filter'
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   325
      \-\-exclude=PATTERN       exclude files matching PATTERN
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   326
      \-\-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
   327
-     \-\-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
   328
+     \-\-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
   329
      \-\-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
   330
      \-\-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
   331
  \-0, \-\-from0                 all *from/filter files are delimited by 0s
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   332
@@ -522,7 +526,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   333
  \-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
   334
  \-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
   335
      \-\-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
   336
-     \-\-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
   337
+     \-\-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
   338
      \-\-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
   339
      \-\-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
   340
      \-\-list\-only             list the files instead of copying them
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   341
@@ -551,8 +555,8 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   342
  \-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
   343
      \-\-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
   344
      \-\-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
   345
-     \-\-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
   346
-     \-\-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
   347
+     \-\-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
   348
+     \-\-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
   349
      \-\-sockopts=OPTIONS      specify custom TCP options
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   350
  \-v, \-\-verbose               increase verbosity
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   351
  \-4, \-\-ipv4                  prefer IPv4
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   352
@@ -570,11 +574,11 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   353
 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
   354
 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
   355
 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
   356
-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
   357
-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
   358
+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
   359
+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
   360
 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
   361
 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
   362
-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
   363
+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
   364
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   365
 .IP "\fB\-\-help\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   366
 Print a short help page describing the options
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   367
@@ -601,11 +605,11 @@
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   368
 \fB\-\-info\fP and \fB\-\-debug\fP have a way to ask for help that tells you
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   369
 exactly what flags are set for each increase in verbosity.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   370
 .IP 
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   371
-However, do keep in mind that a daemon\(cq\&s \(dq\&max verbosity\(dq\& setting will limit how
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   372
+However, do keep in mind that a daemon's "max verbosity" setting will limit how
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   373
 high of a level the various individual flags can be set on the daemon side.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   374
 For instance, if the max is 2, then any info and/or debug flag that is set to
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   375
 a higher value than what would be set by \fB\-vv\fP will be downgraded to the
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   376
-\fB\-vv\fP level in the daemon\(cq\&s logging.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   377
+\fB\-vv\fP level in the daemon's logging.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   378
 .IP 
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   379
 .IP "\fB\-\-info=FLAGS\fP"
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   380
 This option lets you have fine\-grained control over the
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   381
@@ -624,14 +628,14 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   382
 .fi 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   383
 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   384
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   385
-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
   386
+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
   387
 \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
   388
 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
   389
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   390
 This option was added to 3.1.0, so an older rsync on the server side might
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   391
 reject your attempts at fine\-grained control (if one or more flags needed
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   392
 to be send to the server and the server was too old to understand them).
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   393
-See also the \(dq\&max verbosity\(dq\& caveat above when dealing with a daemon.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   394
+See also the "max verbosity" caveat above when dealing with a daemon.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   395
 .IP 
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   396
 .IP "\fB\-\-debug=FLAGS\fP"
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   397
 This option lets you have fine\-grained control over the debug
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   398
@@ -655,7 +659,7 @@
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   399
 This option was added to 3.1.0, so an older rsync on the server side might
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   400
 reject your attempts at fine\-grained control (if one or more flags needed
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   401
 to be send to the server and the server was too old to understand them).
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   402
-See also the \(dq\&max verbosity\(dq\& caveat above when dealing with a daemon.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   403
+See also the "max verbosity" caveat above when dealing with a daemon.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   404
 .IP 
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   405
 .IP "\fB\-\-msgs2stderr\fP"
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   406
 This option changes rsync to send all its output
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   407
@@ -681,18 +685,18 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   408
 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
   409
 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
   410
 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
   411
-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
   412
+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
   413
 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
   414
 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
   415
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   416
 .IP "\fB\-I, \-\-ignore\-times\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   417
 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
   418
 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
   419
-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
   420
+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
   421
 be updated.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   422
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   423
 .IP "\fB\-\-size\-only\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   424
-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
   425
+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
   426
 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
   427
 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
   428
 time to just looking for files that have changed in size.  This is useful
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   429
@@ -711,7 +715,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   430
 .IP "\fB\-c, \-\-checksum\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   431
 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
   432
 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
   433
-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
   434
+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
   435
 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
   436
 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
   437
 matching size.  Generating the checksums means that both sides will expend
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   438
@@ -722,14 +726,14 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   439
 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
   440
 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
   441
 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
   442
-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
   443
+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
   444
 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
   445
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   446
 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
   447
 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
   448
 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
   449
 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
   450
-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
   451
+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
   452
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   453
 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
   454
 MD5.  For older protocols, the checksum used is MD4.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   455
@@ -747,14 +751,14 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   456
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   457
 .IP "\-\-no\-OPTION"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   458
 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
   459
-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
   460
+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
   461
 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
   462
 \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
   463
 (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
   464
-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
   465
+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
   466
 (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
   467
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   468
-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
   469
+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
   470
 \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
   471
 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
   472
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   473
@@ -810,16 +814,16 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   474
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   475
 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
   476
 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
   477
-\(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
   478
+"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
   479
 above example).
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
 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
   482
 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
   483
 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
   484
-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
   485
+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
   486
 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
   487
 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
   488
-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
   489
+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
   490
 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
   491
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   492
 It is also possible to limit the amount of path information that is sent as
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   493
@@ -833,7 +837,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   494
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   495
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   496
 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
   497
-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
   498
+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
   499
 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
   500
 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
   501
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   502
@@ -843,12 +847,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   503
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   504
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   505
 (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
   506
-\(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
   507
-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
   508
+"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
   509
+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
   510
 for a non\-daemon transfer):
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   511
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   512
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   513
-\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
   514
+\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
   515
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   516
 \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
   517
 .RE
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   518
@@ -865,13 +869,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   519
 the receiving side.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   520
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   521
 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
   522
-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
   523
-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
   524
-\(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
   525
-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
   526
+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
   527
+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
   528
+"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
   529
+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
   530
 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
   531
-\(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
   532
-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
   533
+"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
   534
+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
   535
 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
   536
 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
   537
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   538
@@ -885,15 +889,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   539
 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
   540
 \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
   541
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   542
-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
   543
+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
   544
 \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
   545
-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
   546
+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
   547
 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
   548
-(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
   549
+(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
   550
 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
   551
 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
   552
 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
   553
-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
   554
+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
   555
 rule would never be reached).
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\-\-backup\-dir=DIR\fP"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   558
@@ -906,8 +910,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   559
 .IP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   560
 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
   561
 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
   562
-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
   563
-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
   564
+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
   565
+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
   566
 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
   567
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   568
 .IP "\fB\-\-suffix=SUFFIX\fP"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   569
@@ -919,7 +923,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   570
 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
   571
 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
   572
 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
   573
-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
   574
+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
   575
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   576
 Note that this does not affect the copying of dirs, symlinks, or other special
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   577
 files.  Also, a difference of file format between the sender and receiver
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   578
@@ -928,8 +932,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   579
 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
   580
 the timestamps.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   581
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   582
-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
   583
-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
   584
+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
   585
+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
   586
 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
   587
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   588
 .IP "\fB\-\-inplace\fP"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   589
@@ -945,13 +949,13 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   590
 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
   591
 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
   592
 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
   593
-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
   594
+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
   595
 .IP o 
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   596
 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
   597
 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
   598
 crash).
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   599
 .IP o 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   600
-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
   601
+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
   602
 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
   603
 fails.
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   604
 .IP o 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   605
@@ -959,7 +963,7 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   606
 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
   607
 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
   608
 .IP o 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   609
-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
   610
+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
   611
 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
   612
 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
   613
 since rsync is smart enough to use the backup file as the basis file for the
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   614
@@ -986,12 +990,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   615
 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
   616
 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
   617
 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
   618
-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
   619
+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
   620
 (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
   621
 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
   622
 Implies \fB\-\-inplace\fP,
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   623
 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
   624
-file\(cq\&s length).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   625
+file's length).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   626
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   627
 .IP "\fB\-\-append\-verify\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   628
 This works just like the \fB\-\-append\fP option, but
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   629
@@ -1007,21 +1011,21 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   630
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   631
 .IP "\fB\-d, \-\-dirs\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   632
 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
   633
-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
   634
-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
   635
-(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
   636
+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
   637
+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
   638
+(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
   639
 \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
   640
 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
   641
 \fB\-\-dirs\fP and \fB\-\-recursive\fP, \fB\-\-recursive\fP takes precedence.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   642
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   643
 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
   644
 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
   645
-\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
   646
+\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
   647
 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
   648
 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
   649
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   650
 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
   651
-\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
   652
+\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
   653
 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
   654
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   655
 .IP "\fB\-l, \-\-links\fP"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   656
@@ -1033,7 +1037,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   657
 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
   658
 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
   659
 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
   660
-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
   661
+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
   662
 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
   663
 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
   664
 will still have the side\-effect of \fB\-K\fP on that older receiving rsync.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   665
@@ -1055,11 +1059,11 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   666
 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
   667
 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
   668
 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
   669
-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
   670
+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
   671
 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
   672
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   673
 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
   674
-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
   675
+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
   676
 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
   677
 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
   678
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   679
@@ -1068,13 +1072,13 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   680
 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
   681
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   682
 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
   683
-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
   684
-\(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
   685
+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
   686
+"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
   687
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   688
 .IP "\fB\-k, \-\-copy\-dirlinks\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   689
 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
   690
 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
   691
-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
   692
+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
   693
 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
   694
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   695
 Without this option, if the sending side has replaced a directory with a
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   696
@@ -1097,20 +1101,20 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   697
 .IP 
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   698
 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
   699
 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
   700
-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
   701
+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
   702
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   703
 .IP "\fB\-K, \-\-keep\-dirlinks\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   704
 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
   705
 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
   706
 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
   707
-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
   708
+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
   709
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   710
-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
   711
-\(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
   712
-\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
   713
+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
   714
+"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
   715
+\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
   716
 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
   717
-\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
   718
-\(dq\&bar\(dq\&.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   719
+\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
   720
+"bar".
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   721
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   722
 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
   723
 the symlinks in the copy!  If it is possible for an untrusted user to
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   724
@@ -1178,24 +1182,24 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   725
 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
   726
 the execute permission for the file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   727
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   728
-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
   729
-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
   730
-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
   731
-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
   732
+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
   733
+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
   734
+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
   735
+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
   736
 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
   737
 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
   738
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   739
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   740
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   741
 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
   742
-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
   743
+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
   744
 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
   745
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   746
 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
   747
 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
   748
 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
   749
 \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
   750
-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
   751
+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
   752
 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
   753
 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
   754
 and includes \-\-no\-g to use the default group of the destination dir):
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   755
@@ -1213,13 +1217,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   756
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   757
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   758
 (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
   759
-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
   760
+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
   761
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   762
-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
   763
+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
   764
 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
   765
 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
   766
 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
   767
-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
   768
+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
   769
 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
   770
 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
   771
 (Keep in mind that it is the version of the receiving rsync that affects
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   772
@@ -1229,17 +1233,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   773
 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
   774
 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
   775
 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
   776
-\(cq\&x\(cq\& is turned on in its permissions.  When an existing destination file\(cq\&s
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   777
+\&'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
   778
 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
   779
-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
   780
+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
   781
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   782
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   783
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   784
-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
   785
+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
   786
 permissions.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   787
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   788
-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
   789
-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
   790
+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
   791
+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
   792
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   793
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   794
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   795
@@ -1253,6 +1257,8 @@
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   796
 The source and destination systems must have compatible ACL entries for this
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   797
 option to work properly.  See the \fB\-\-fake\-super\fP option for a way to backup
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   798
 and restore ACLs that are not compatible.
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   799
+.IP
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   800
+Note, that rsync does not support NFSv4 ACLs.
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   801
 .IP 
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   802
 .IP "\fB\-X, \-\-xattrs\fP"
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   803
 This option causes rsync to update the destination
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   804
@@ -1265,19 +1271,19 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   805
 .IP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   806
 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
   807
 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
   808
-\(dq\&copy 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
   809
+"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
   810
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   811
 .IP "\fB\-\-chmod\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   812
 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
   813
-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
   814
+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
   815
 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
   816
 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
   817
 can seem to have no effect on existing files if \fB\-\-perms\fP is not enabled.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   818
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   819
 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
   820
 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
   821
-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
   822
-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
   823
+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
   824
+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
   825
 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
   826
 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
   827
 consistent executability across all bits:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   828
@@ -1344,8 +1350,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   829
 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
   830
 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
   831
 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
   832
-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
   833
-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
   834
+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
   835
+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
   836
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   837
 .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
   838
 This tells rsync to omit directories when
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   839
@@ -1360,7 +1366,7 @@
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   840
 directory right away (without having to delay that until a bunch of recursive
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   841
 copying has finished).  This early\-create idiom is not necessary if directory
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   842
 modify times are not being preserved, so it is skipped.  Since early\-create
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   843
-directories don\(cq\&t have accurate mode, mtime, or ownership, the use of this
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   844
+directories don't have accurate mode, mtime, or ownership, the use of this
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   845
 option can help when someone wants to avoid these partially\-finished
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   846
 directories.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   847
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   848
@@ -1370,12 +1376,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   849
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   850
 .IP "\fB\-\-super\fP"
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   851
 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
   852
-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
   853
+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
   854
 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
   855
-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
   856
+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
   857
 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
   858
 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
   859
-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
   860
+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
   861
 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
   862
 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
   863
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   864
@@ -1383,10 +1389,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   865
 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
   866
 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
   867
 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
   868
-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
   869
+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
   870
 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
   871
-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
   872
-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
   873
+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
   874
+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
   875
 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
   876
 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
   877
 This option also handles ACLs (if \fB\-\-acls\fP was specified) and non\-user
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   878
@@ -1412,18 +1418,18 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   879
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   880
 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
   881
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   882
-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
   883
+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
   884
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   885
 .IP "\fB\-S, \-\-sparse\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   886
 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
   887
-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
   888
+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
   889
 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
   890
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   891
 .IP "\fB\-\-preallocate\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   892
 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
   893
 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
   894
-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
   895
-\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
   896
+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
   897
+\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
   898
 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
   899
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   900
 Without this option, larger files may not be entirely contiguous on the
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   901
@@ -1432,7 +1438,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   902
 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
   903
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   904
 .IP "\fB\-n, \-\-dry\-run\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   905
-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
   906
+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
   907
 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
   908
 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
   909
 \fB\-i, \-\-itemize\-changes\fP options to see what an rsync command is going
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   910
@@ -1440,29 +1446,29 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   911
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   912
 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
   913
 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
   914
-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
   915
+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
   916
 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
   917
 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
   918
-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
   919
-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
   920
+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
   921
+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
   922
 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
   923
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   924
 .IP "\fB\-W, \-\-whole\-file\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   925
-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
   926
+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
   927
 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
   928
 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
   929
 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
   930
-\(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
   931
+"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
   932
 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
   933
 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
   934
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   935
 .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
   936
 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
   937
-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
   938
-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
   939
+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
   940
+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
   941
 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
   942
 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
   943
-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
   944
+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
   945
 same filesystem.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   946
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   947
 If this option is repeated, rsync omits all mount\-point directories from
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   948
@@ -1482,8 +1488,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   949
 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
   950
 (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
   951
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   952
-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
   953
-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
   954
+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
   955
+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
   956
 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
   957
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   958
 .IP "\fB\-\-ignore\-existing\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   959
@@ -1491,15 +1497,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   960
 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
   961
 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
   962
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   963
-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
   964
-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
   965
+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
   966
+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
   967
 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
   968
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   969
 This option can be useful for those doing backups using the \fB\-\-link\-dest\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   970
 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
   971
 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
   972
 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
   973
-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
   974
+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
   975
 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
   976
 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
   977
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
   978
@@ -1511,24 +1517,24 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   979
 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
   980
 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
   981
 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
   982
-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
   983
-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
   984
+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
   985
+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
   986
 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
   987
-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
   988
-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
   989
-\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
   990
+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
   991
+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
   992
+\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
   993
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   994
 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
   995
-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
   996
+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
   997
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   998
 .IP "\fB\-\-delete\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   999
 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
  1000
-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
  1001
+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
  1002
 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
  1003
-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
  1004
-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
  1005
+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
  1006
+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
  1007
 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
  1008
-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
  1009
+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
  1010
 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
  1011
 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
  1012
 include/exclude modifiers in the FILTER RULES section).
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1013
@@ -1585,7 +1591,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1014
 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
  1015
 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
  1016
 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
  1017
-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
  1018
+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
  1019
 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
  1020
 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
  1021
 incremental scan).
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1022
@@ -1627,7 +1633,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1023
 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
  1024
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1025
 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
  1026
-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
  1027
+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
  1028
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1029
 .IP "\fB\-\-ignore\-errors\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1030
 Tells \fB\-\-delete\fP to go ahead and delete files
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1031
@@ -1651,27 +1657,27 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1032
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1033
 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
  1034
 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
  1035
-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
  1036
+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
  1037
 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
  1038
 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
  1039
-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
  1040
+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
  1041
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1042
 .IP "\fB\-\-max\-size=SIZE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1043
 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
  1044
 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
  1045
 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
  1046
-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
  1047
+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
  1048
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1049
-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
  1050
-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
  1051
+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
  1052
+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
  1053
 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
  1054
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1055
-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
  1056
-\(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
  1057
+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
  1058
+"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
  1059
 gibibyte (1024*1024*1024).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1060
-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
  1061
-\(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
  1062
-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
  1063
+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
  1064
+"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
  1065
+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
  1066
 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
  1067
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1068
 Examples: \-\-max\-size=1.5mb\-1 is 1499999 bytes, and \-\-max\-size=2g+1 is
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1069
@@ -1689,7 +1695,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1070
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1071
 .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
  1072
 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
  1073
-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
  1074
+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
  1075
 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
  1076
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1077
 .IP "\fB\-e, \-\-rsh=COMMAND\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1078
@@ -1702,8 +1708,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1079
 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
  1080
 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
  1081
 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
  1082
-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
  1083
-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
  1084
+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
  1085
+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
  1086
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1087
 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
  1088
 presented to rsync as a single argument.  You must use spaces (not tabs
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1089
@@ -1715,9 +1721,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1090
 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
  1091
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1092
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1093
-\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
  1094
+\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
  1095
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1096
-\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
  1097
+\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
  1098
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1099
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1100
 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1101
@@ -1733,9 +1739,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1102
 .IP "\fB\-\-rsync\-path=PROGRAM\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1103
 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
  1104
 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
  1105
-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
  1106
+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
  1107
 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
  1108
-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
  1109
+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
  1110
 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
  1111
 communicate.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1112
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1113
@@ -1743,7 +1749,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1114
 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
  1115
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1116
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1117
-\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
  1118
+\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
  1119
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1120
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1121
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1122
@@ -1776,8 +1782,8 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1123
 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
  1124
 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
  1125
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1126
-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
  1127
-\(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
  1128
+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
  1129
+"remote" side is the receiver.
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1130
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1131
 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
  1132
 prevents you from using an adjacent arg with an equal in it next to a short
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1133
@@ -1786,7 +1792,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1134
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1135
 .IP "\fB\-C, \-\-cvs\-exclude\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1136
 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
  1137
-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
  1138
+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
  1139
 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
  1140
 a file should be ignored.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1141
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1142
@@ -1808,17 +1814,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1143
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1144
 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
  1145
 \&.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
  1146
-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
  1147
+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
  1148
 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
  1149
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1150
-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
  1151
+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
  1152
 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
  1153
 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
  1154
 a lower priority than any rules you specified explicitly.  If you want to
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1155
 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
  1156
 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
  1157
 \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
  1158
-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
  1159
+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
  1160
 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
  1161
 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
  1162
 mentioned above.
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1163
@@ -1841,7 +1847,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1164
 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
  1165
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1166
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1167
-\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
  1168
+\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
  1169
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1170
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1171
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1172
@@ -1851,7 +1857,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1173
 rule:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1174
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1175
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1176
-\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
  1177
+\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
  1178
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1179
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1180
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1181
@@ -1870,7 +1876,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1182
 .IP "\fB\-\-exclude\-from=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1183
 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
  1184
 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
  1185
-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
  1186
+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
  1187
 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
  1188
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1189
 .IP "\fB\-\-include=PATTERN\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1190
@@ -1883,7 +1889,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1191
 .IP "\fB\-\-include\-from=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1192
 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
  1193
 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
  1194
-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
  1195
+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
  1196
 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
  1197
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1198
 .IP "\fB\-\-files\-from=FILE\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1199
@@ -1902,7 +1908,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1200
 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
  1201
 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
  1202
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1203
-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
  1204
+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
  1205
 (\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
  1206
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1207
 These side\-effects change the default state of rsync, so the position
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1208
@@ -1913,7 +1919,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1209
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1210
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1211
 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
  1212
-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
  1213
+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
  1214
 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
  1215
 command:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1216
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1217
@@ -1922,12 +1928,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1218
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1219
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1220
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1221
-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
  1222
+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
  1223
 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
  1224
-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
  1225
+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
  1226
 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
  1227
 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
  1228
-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
  1229
+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
  1230
 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
  1231
 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
  1232
 Also note
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1233
@@ -1936,10 +1942,10 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1234
 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
  1235
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1236
 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
  1237
-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
  1238
+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
  1239
 (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
  1240
-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
  1241
-transfer\(dq\&.  For example:
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1242
+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
  1243
+transfer".  For example:
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1244
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1245
 .RS 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1246
 \f(CW   rsync \-a \-\-files\-from=:/path/file\-list src:/ /tmp/copy\fP
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1247
@@ -1947,12 +1953,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1248
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1249
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1250
 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
  1251
-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
  1252
+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
  1253
 .IP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1254
 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
  1255
 \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
  1256
-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
  1257
-receiving host\(cq\&s charset.
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1258
+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
  1259
+receiving host's charset.
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1260
 .IP 
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1261
 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
  1262
 more efficient, as it will avoid re\-visiting the path elements that are shared
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1263
@@ -1962,7 +1968,7 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1264
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1265
 .IP "\fB\-0, \-\-from0\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1266
 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
  1267
-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
  1268
+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
  1269
 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
  1270
 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
  1271
 It does not affect \fB\-\-cvs\-exclude\fP (since all names read from a .cvsignore
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1272
@@ -1985,7 +1991,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1273
 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
  1274
 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
  1275
 (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
  1276
-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
  1277
+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
  1278
 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
  1279
 that.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1280
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1281
@@ -2020,9 +2026,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1282
 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
  1283
 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
  1284
 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
  1285
-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
  1286
+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
  1287
 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
  1288
-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
  1289
+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
  1290
 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
  1291
 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
  1292
 single file in a subdir in the destination hierarchy, rsync will use the
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1293
@@ -2050,7 +2056,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1294
 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
  1295
 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
  1296
 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
  1297
-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
  1298
+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
  1299
 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
  1300
 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
  1301
 This option is typically used to copy into an empty (or newly created)
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1302
@@ -2099,10 +2105,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1303
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1304
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1305
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1306
-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
  1307
-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
  1308
+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
  1309
+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
  1310
 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
  1311
-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
  1312
+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
  1313
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1314
 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
  1315
 provided, which will cause rsync to search the list in the order specified
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1316
@@ -2172,11 +2178,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1317
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1318
 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
  1319
 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
  1320
-\(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
  1321
+"[: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
  1322
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1323
 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
  1324
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1325
-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
  1326
+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
  1327
 matches 2 suffixes):
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1328
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1329
 .nf 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1330
@@ -2234,8 +2240,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1331
 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
  1332
 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
  1333
 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
  1334
-\(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
  1335
-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
  1336
+"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
  1337
+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
  1338
 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
  1339
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1340
 .IP "\fB\-\-usermap=STRING, \-\-groupmap=STRING\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1341
@@ -2245,9 +2251,9 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1342
 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
  1343
 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
  1344
 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
  1345
-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
  1346
+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
  1347
 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
  1348
-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
  1349
+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
  1350
 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
  1351
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1352
 .nf 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1353
@@ -2259,15 +2265,15 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1354
 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
  1355
 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
  1356
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1357
-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
  1358
+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
  1359
 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
  1360
-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
  1361
+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
  1362
 \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
  1363
 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
  1364
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1365
 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
  1366
 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
  1367
-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
  1368
+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
  1369
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1370
 .nf 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1371
   \-\-usermap=:nobody \-\-groupmap=*:nobody
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1372
@@ -2294,8 +2300,8 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1373
 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
  1374
 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
  1375
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1376
-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
  1377
-\(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
  1378
+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
  1379
+"\-\-usermap=*:foo \-\-groupmap=*:bar", only easier.
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1380
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1381
 .IP "\fB\-\-timeout=TIMEOUT\fP"
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1382
 This option allows you to set a maximum I/O
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1383
@@ -2345,18 +2351,18 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1384
 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
  1385
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1386
 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
  1387
-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
  1388
+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
  1389
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1390
 .IP "\fB\-i, \-\-itemize\-changes\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1391
 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
  1392
 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
  1393
-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
  1394
+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
  1395
 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
  1396
 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
  1397
 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
  1398
 verbose messages).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1399
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1400
-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
  1401
+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
  1402
 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
  1403
 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
  1404
 other letters represent attributes that may be output if they are being
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1405
@@ -2382,7 +2388,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1406
 have attributes that are being modified).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1407
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1408
 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
  1409
-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
  1410
+a message (e.g. "deleting").
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1411
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1412
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1413
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1414
@@ -2392,10 +2398,10 @@
297
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
 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
  1417
 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
  1418
-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
  1419
-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
  1420
+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
  1421
+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
  1422
 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
  1423
-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
  1424
+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
  1425
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1426
 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
  1427
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1428
@@ -2411,21 +2417,21 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1429
 by the file transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1430
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1431
 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
  1432
-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
  1433
+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
  1434
 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
  1435
 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
  1436
-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
  1437
+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
  1438
 (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
  1439
 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
  1440
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1441
 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
  1442
-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
  1443
+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
  1444
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1445
 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
  1446
-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
  1447
+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
  1448
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1449
 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
  1450
-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
  1451
+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
  1452
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1453
 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
  1454
 .IP o 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1455
@@ -2435,8 +2441,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1456
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1457
 
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
-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
  1460
-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
  1461
+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
  1462
+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
  1463
 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
  1464
 outputting them as a verbose message).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1465
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1466
@@ -2444,10 +2450,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1467
 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
  1468
 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
  1469
 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
  1470
-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
  1471
+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
  1472
 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
  1473
 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
  1474
-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
  1475
+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
  1476
 rsyncd.conf manpage.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1477
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1478
 Specifying the \fB\-\-out\-format\fP option implies the \fB\-\-info=name\fP option,
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1479
@@ -2457,11 +2463,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1480
 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
  1481
 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
  1482
 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
  1483
-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
  1484
+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
  1485
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1486
-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
  1487
+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
  1488
 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
  1489
-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
  1490
+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
  1491
 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
  1492
 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
  1493
 (followed, of course, by the out\-format output).
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1494
@@ -2471,10 +2477,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1495
 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
  1496
 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
  1497
 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
  1498
-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
  1499
+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
  1500
 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
  1501
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1502
-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
  1503
+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
  1504
 happening:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1505
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1506
 .nf 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1507
@@ -2490,15 +2496,15 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1508
 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
  1509
 (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
  1510
 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
  1511
-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
  1512
+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
  1513
 in the rsyncd.conf manpage.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1514
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1515
 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
  1516
-is \(cq\&%i %n%L\(cq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1517
+is '%i %n%L'.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1518
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1519
 .IP "\fB\-\-stats\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1520
 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
  1521
-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
  1522
+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
  1523
 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
  1524
 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
  1525
 with 2 or more \fB\-v\fP options.
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1526
@@ -2506,27 +2512,27 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1527
 The current statistics are as follows: 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1528
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1529
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1530
-\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
  1531
+\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
  1532
 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
  1533
 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
  1534
-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
  1535
+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
  1536
 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
  1537
 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
  1538
 .IP o 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1539
-\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
  1540
+\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
  1541
 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
  1542
 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
  1543
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1544
-\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
  1545
+\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
  1546
 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
  1547
 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
  1548
 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
  1549
 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
  1550
 .IP o 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1551
 \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
  1552
-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
  1553
+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
  1554
 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
  1555
-\(dq\&regular\(dq\& into this heading.
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1556
+"regular" into this heading.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1557
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1558
 \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
  1559
 This does not count any size for directories or special files, but does
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1560
@@ -2557,22 +2563,22 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1561
 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
  1562
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1563
 \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
  1564
-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
  1565
-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
  1566
+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
  1567
+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
  1568
 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
  1569
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1570
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1571
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1572
 .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
  1573
 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
  1574
-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
  1575
+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
  1576
 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
  1577
-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
  1578
+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
  1579
 setting.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1580
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1581
 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
  1582
 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
  1583
-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
  1584
+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
  1585
 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
  1586
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1587
 .IP "\fB\-h, \-\-human\-readable\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1588
@@ -2594,7 +2600,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1589
 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
  1590
 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
  1591
 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
  1592
-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
  1593
+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
  1594
 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
  1595
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1596
 .IP "\fB\-\-partial\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1597
@@ -2615,12 +2621,12 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1598
 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
  1599
 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
  1600
 (since
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1601
-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
  1602
+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
  1603
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1604
 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
  1605
 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
  1606
-\(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
  1607
-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
  1608
+"\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
  1609
+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
  1610
 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
  1611
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1612
 If the partial\-dir value is not an absolute path, rsync will add an exclude
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1613
@@ -2628,21 +2634,21 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1614
 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
  1615
 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
  1616
 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
  1617
-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
  1618
+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
  1619
 filter rules.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1620
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1621
 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
  1622
 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
  1623
 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
  1624
-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
  1625
+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
  1626
 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
  1627
-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
  1628
-\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
  1629
-\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
  1630
+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
  1631
+\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
  1632
+\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
  1633
 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
  1634
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1635
 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
  1636
-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
  1637
+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
  1638
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1639
 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
  1640
 variable.  Setting this in the environment does not force \fB\-\-partial\fP to be
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1641
@@ -2655,7 +2661,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1642
 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
  1643
 \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
  1644
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1645
-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
  1646
+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
  1647
 \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
  1648
 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
  1649
 of destination files with a partial transfer, while still allowing the
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1650
@@ -2666,12 +2672,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1651
 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
  1652
 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
  1653
 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
  1654
-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
  1655
-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
  1656
+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
  1657
+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
  1658
 \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
  1659
 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
  1660
-\(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
  1661
-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
  1662
+".~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
  1663
+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
  1664
 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
  1665
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1666
 This option uses more memory on the receiving side (one bit per file
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1667
@@ -2683,9 +2689,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1668
 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
  1669
 absolute)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1670
 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
  1671
-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
  1672
+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
  1673
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1674
-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
  1675
+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
  1676
 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
  1677
 parallel hierarchy of files).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1678
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1679
@@ -2709,26 +2715,26 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1680
 this.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1681
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1682
 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
  1683
-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
  1684
-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
  1685
+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
  1686
+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
  1687
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1688
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1689
-\-\-filter \(cq\&protect emptydir/\(cq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1690
+\-\-filter 'protect emptydir/'
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1691
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1692
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1693
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1694
-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
  1695
+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
  1696
 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
  1697
 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
  1698
 (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
  1699
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1700
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1701
-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
  1702
+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
  1703
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1704
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1705
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1706
-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
  1707
-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
  1708
+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
  1709
+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
  1710
 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
  1711
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1712
 .IP "\fB\-\-progress\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1713
@@ -2737,7 +2743,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1714
 something to watch.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1715
 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
  1716
 \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
  1717
-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
  1718
+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
  1719
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1720
 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
  1721
 looks like this:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1722
@@ -2748,12 +2754,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1723
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1724
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1725
 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
  1726
-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
  1727
+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
  1728
 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
  1729
 is maintained until the end.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1730
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1731
-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
  1732
-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
  1733
+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
  1734
+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
  1735
 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
  1736
 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
  1737
 will probably take much longer to finish than the receiver estimated as it
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1738
@@ -2774,12 +2780,12 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1739
 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
  1740
 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
  1741
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1742
-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
  1743
+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
  1744
 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
  1745
-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
  1746
-(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
  1747
+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
  1748
+(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
  1749
 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
  1750
-\(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
  1751
+"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
  1752
 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
  1753
 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
  1754
 list).
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1755
@@ -2793,7 +2799,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1756
 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
  1757
 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
  1758
 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
  1759
-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
  1760
+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
  1761
 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
  1762
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1763
 .IP "\fB\-\-password\-file=FILE\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1764
@@ -2804,10 +2810,10 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1765
 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
  1766
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1767
 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
  1768
-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
  1769
+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
  1770
 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
  1771
 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
  1772
-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
  1773
+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
  1774
 config file).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1775
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1776
 .IP "\fB\-\-list\-only\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1777
@@ -2837,17 +2843,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1778
 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
  1779
 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
  1780
 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
  1781
-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
  1782
-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
  1783
-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
  1784
-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
  1785
+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
  1786
+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
  1787
+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
  1788
+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
  1789
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1790
 .IP "\fB\-\-bwlimit=RATE\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1791
 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
  1792
 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
  1793
 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
  1794
-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
  1795
-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
  1796
+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
  1797
+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
  1798
 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
  1799
 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
  1800
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1801
@@ -2856,7 +2862,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1802
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1803
 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
  1804
 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
  1805
-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
  1806
+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
  1807
 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
  1808
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1809
 Due to the internal buffering of data, the \fB\-\-progress\fP option may not be an
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1810
@@ -2867,7 +2873,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1811
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1812
 .IP "\fB\-\-write\-batch=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1813
 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
  1814
-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
  1815
+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
  1816
 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
  1817
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1818
 .IP "\fB\-\-only\-write\-batch=FILE\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1819
@@ -2879,58 +2885,58 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1820
 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
  1821
 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
  1822
 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
  1823
-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
  1824
+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
  1825
 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
  1826
 happening).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1827
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1828
 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
  1829
 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
  1830
 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
  1831
-(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
  1832
+(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
  1833
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1834
 .IP "\fB\-\-read\-batch=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1835
 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
  1836
 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
  1837
 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
  1838
-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
  1839
+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
  1840
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1841
 .IP "\fB\-\-protocol=NUM\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1842
 Force an older protocol version to be used.  This
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1843
 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
  1844
 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
  1845
 \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
  1846
-\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
  1847
+\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
  1848
 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
  1849
-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
  1850
+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
  1851
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1852
 .IP "\fB\-\-iconv=CONVERT_SPEC\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1853
 Rsync can convert filenames between character
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1854
-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
  1855
+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
  1856
 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
  1857
 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
  1858
 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
  1859
 \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
  1860
-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
  1861
-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
  1862
+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
  1863
+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
  1864
 to turn off any conversion.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1865
 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
  1866
 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
  1867
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1868
 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
  1869
-run \(dq\&iconv \-\-list\(dq\&.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1870
+run "iconv \-\-list".
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1871
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1872
 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
  1873
 the filenames you specify on the command\-line that are being sent to the
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1874
 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
  1875
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1876
 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
  1877
-(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
  1878
+(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
  1879
 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
  1880
 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
  1881
 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
  1882
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1883
 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
  1884
-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
  1885
+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
  1886
 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
  1887
 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
  1888
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1889
@@ -2947,10 +2953,10 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1890
 .IP "\fB\-\-checksum\-seed=NUM\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1891
 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
  1892
 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
  1893
-(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
  1894
+(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
  1895
 seed is generated by the server and defaults to the current 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1896
-\f(CWtime()\fP
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1897
-\&.  This
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1898
+\f(CWtime().\fP
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1899
+This
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1900
 option is used to set a specific checksum seed, which is useful for
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1901
 applications that want repeatable block checksums, or in the case where the
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1902
 user wants a more random checksum seed.  Setting NUM to 0 causes rsync to use
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1903
@@ -2980,7 +2986,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1904
 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
  1905
 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
  1906
 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
  1907
-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
  1908
+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
  1909
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1910
 .IP "\fB\-\-bwlimit=RATE\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1911
 This option allows you to specify the maximum transfer
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1912
@@ -2998,7 +3004,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1913
 .IP "\fB\-M, \-\-dparam=OVERRIDE\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1914
 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
  1915
 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
  1916
-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
  1917
+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
  1918
 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
  1919
 desire.  For instance:
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1920
 .IP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1921
@@ -3012,25 +3018,25 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1922
 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
  1923
 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
  1924
 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
  1925
-\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
  1926
+\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
  1927
 \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
  1928
 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
  1929
 sshd.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1930
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1931
 .IP "\fB\-\-port=PORT\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1932
 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
  1933
-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
  1934
+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
  1935
 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
  1936
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1937
 .IP "\fB\-\-log\-file=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1938
 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
  1939
-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
  1940
+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
  1941
 file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1942
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1943
 .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
  1944
 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
  1945
-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
  1946
-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
  1947
+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
  1948
+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
  1949
 case transfer logging is turned off.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1950
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1951
 .IP "\fB\-\-sockopts\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1952
@@ -3040,15 +3046,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1953
 .IP "\fB\-v, \-\-verbose\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1954
 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
  1955
 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
  1956
-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
  1957
-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
  1958
+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
  1959
+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
  1960
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1961
 .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
  1962
 Tells rsync to prefer IPv4/IPv6
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1963
 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
  1964
 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
  1965
 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
  1966
-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
  1967
+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
  1968
 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
  1969
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1970
 If rsync was complied without support for IPv6, the \fB\-\-ipv6\fP option
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1971
@@ -3087,7 +3093,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1972
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1973
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1974
 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
  1975
-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
  1976
+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
  1977
 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
  1978
 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
  1979
 Here are the available rule prefixes:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  1980
@@ -3115,15 +3121,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1981
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1982
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1983
 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
  1984
-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
  1985
+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
  1986
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1987
 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
  1988
 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
  1989
-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
  1990
+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
  1991
 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
  1992
 If a pattern
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1993
-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
  1994
-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
  1995
+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
  1996
+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
  1997
 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
  1998
 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
  1999
 start of the rule.
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2000
@@ -3136,8 +3142,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2001
 .SH "INCLUDE/EXCLUDE PATTERN RULES"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2002
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2003
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2004
-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
  2005
-\(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
  2006
+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
  2007
+"\-", 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
  2008
 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
  2009
 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
  2010
 can take several forms:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2011
@@ -3147,15 +3153,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2012
 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
  2013
 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
  2014
 regular expressions.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2015
-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
  2016
-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
  2017
+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
  2018
+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
  2019
 per\-directory rule).
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2020
-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
  2021
+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
  2022
 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
  2023
 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
  2024
-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
  2025
-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
  2026
-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
  2027
+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
  2028
+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
  2029
+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
  2030
 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
  2031
 of the transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2032
 .IP o 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2033
@@ -3164,48 +3170,48 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2034
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2035
 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
  2036
 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
  2037
-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
  2038
+characters: '*', '?', and '[' .
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2039
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2040
-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
  2041
+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
  2042
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2043
-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
  2044
+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
  2045
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2046
-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
  2047
+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
  2048
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2049
-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
  2050
+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
  2051
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2052
 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
  2053
 character, but it is matched literally when no wildcards are present.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  2054
 This means that there is an extra level of backslash removal when a
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  2055
 pattern contains wildcard characters compared to a pattern that has none.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  2056
-e.g. if you add a wildcard to \(dq\&foo\ebar\(dq\& (which matches the backslash) you
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  2057
-would need to use \(dq\&foo\e\ebar*\(dq\& to avoid the \(dq\&\eb\(dq\& becoming just \(dq\&b\(dq\&.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  2058
+e.g. if you add a wildcard to "foo\ebar" (which matches the backslash) you
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  2059
+would need to use "foo\e\ebar*" to avoid the "\eb" becoming just "b".
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2060
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2061
-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
  2062
+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
  2063
 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
  2064
-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
  2065
+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
  2066
 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
  2067
-(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
  2068
+(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
  2069
 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
  2070
 down.)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2071
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2072
-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
  2073
-\(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
  2074
-(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
  2075
+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
  2076
+"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
  2077
+(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
  2078
 version 2.6.7.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2079
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2080
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2081
 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
  2082
 \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
  2083
-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
  2084
-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
  2085
-\(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
  2086
+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
  2087
+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
  2088
+"/foo/bar" must not be excluded).
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2089
 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
  2090
 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
  2091
 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
  2092
 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
  2093
-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
  2094
-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
  2095
+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
  2096
+For instance, this won't work:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2097
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2098
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2099
 \f(CW+ /some/path/this\-file\-will\-not\-be\-found\fP
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2100
@@ -3217,11 +3223,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2101
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2102
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2103
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2104
-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
  2105
-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
  2106
+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
  2107
+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
  2108
 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
  2109
-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
  2110
-\(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
  2111
+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
  2112
+"\- *" 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
  2113
 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
  2114
 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
  2115
 works fine:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2116
@@ -3243,44 +3249,44 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2117
 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
  2118
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2119
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2120
-\(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
  2121
+"\- *.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
  2122
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2123
-\(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
  2124
+"\- /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
  2125
 transfer\-root directory
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2126
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2127
-\(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
  2128
+"\- 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
  2129
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2130
-\(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
  2131
+"\- /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
  2132
 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
  2133
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2134
-\(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
  2135
+"\- /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
  2136
 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
  2137
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2138
-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
  2139
+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
  2140
 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
  2141
 \fB\-\-prune\-empty\-dirs\fP option)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2142
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2143
-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
  2144
+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
  2145
 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
  2146
-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
  2147
+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
  2148
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2149
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2150
-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
  2151
+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
  2152
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2153
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2154
 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
  2155
 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
  2156
-\(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
  2157
-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
  2158
-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
  2159
-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
  2160
+"\-/ /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
  2161
+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
  2162
+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
  2163
+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
  2164
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2165
 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
  2166
-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
  2167
+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
  2168
 non\-directories.
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 \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
  2171
-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
  2172
+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
  2173
 follow.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2174
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2175
 An \fBs\fP is used to indicate that the rule applies to the sending
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2176
@@ -3298,7 +3304,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2177
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2178
 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
  2179
 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
  2180
-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
  2181
+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
  2182
 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
  2183
 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
  2184
 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2185
@@ -3310,16 +3316,16 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2186
 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
  2187
 section above).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2188
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2189
-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
  2190
-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
  2191
-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
  2192
+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
  2193
+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
  2194
+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
  2195
 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
  2196
 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
  2197
 into the current list of inherited rules.  These per\-directory rule files
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2198
 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
  2199
 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
  2200
 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
  2201
-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
  2202
+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
  2203
 below).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2204
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2205
 Some examples:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2206
@@ -3348,27 +3354,27 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2207
 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
  2208
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2209
 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
  2210
-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
  2211
+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
  2212
 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
  2213
-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
  2214
+provided, ".cvsignore" is assumed.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2215
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2216
 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
  2217
-\(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
  2218
+"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
  2219
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2220
 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
  2221
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2222
 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
  2223
 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
  2224
 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
  2225
-\(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
  2226
+"\- 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
  2227
 also disabled).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2228
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2229
-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
  2230
+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
  2231
 (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
  2232
 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
  2233
-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
  2234
+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
  2235
 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
  2236
-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
  2237
+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
  2238
 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
  2239
 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
  2240
 then the rules in the file must not specify sides (via a modifier or
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2241
@@ -3376,22 +3382,22 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2242
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2243
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2244
 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
  2245
-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
  2246
-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
  2247
+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
  2248
+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
  2249
 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
  2250
 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
  2251
 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
  2252
 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
  2253
-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
  2254
+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
  2255
 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
  2256
 .PP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  2257
 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
  2258
 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
  2259
-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
  2260
-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
  2261
+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
  2262
+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
  2263
 file was found.
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
-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
  2266
+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
  2267
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2268
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2269
 \f(CWmerge /home/user/.global\-filter\fP
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2270
@@ -3408,7 +3414,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2271
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2272
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2273
 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
  2274
-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
  2275
+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
  2276
 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
  2277
 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
  2278
 of the transfer).
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2279
@@ -3419,7 +3425,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2280
 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
  2281
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2282
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2283
-\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
  2284
+\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
  2285
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2286
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2287
 .PP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2288
@@ -3427,38 +3433,38 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2289
 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
  2290
 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
  2291
 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
  2292
-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
  2293
+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
  2294
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2295
 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
  2296
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2297
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2298
 \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
  2299
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2300
-\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
  2301
+\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
  2302
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2303
-\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
  2304
+\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
  2305
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2306
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2307
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2308
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2309
-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
  2310
-\(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
  2311
+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
  2312
+"/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
  2313
 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
  2314
-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
  2315
+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
  2316
 a part of the transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2317
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2318
-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
  2319
-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
  2320
+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
  2321
+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
  2322
 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
  2323
-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
  2324
+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
  2325
 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
  2326
-\(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
  2327
+":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
  2328
 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
  2329
 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
  2330
 example:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2331
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2332
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2333
-\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
  2334
+\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
  2335
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2336
 \f(CW+ foo.o\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2337
 .br 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2338
@@ -3468,7 +3474,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2339
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2340
 \f(CWEOT\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2341
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2342
-\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
  2343
+\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
  2344
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2345
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2346
 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2347
@@ -3479,25 +3485,25 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2348
 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
  2349
 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
  2350
 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
  2351
-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
  2352
-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
  2353
+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
  2354
+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
  2355
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2356
 .SH "LIST\-CLEARING FILTER RULE"
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2357
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2358
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2359
-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
  2360
-rule (as introduced in the FILTER RULES section above).  The \(dq\&current\(dq\&
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2361
+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
  2362
+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
  2363
 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
  2364
 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
  2365
 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
  2366
-out the parent\(cq\&s rules).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2367
+out the parent's rules).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2368
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2369
 .SH "ANCHORING INCLUDE/EXCLUDE PATTERNS"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2370
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2371
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2372
 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
  2373
-\(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
  2374
-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
  2375
+"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
  2376
+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
  2377
 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
  2378
 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
  2379
 directory.  This root governs where patterns that start with a / match.
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2380
@@ -3508,8 +3514,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2381
 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
  2382
 host).  The following examples demonstrate this.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2383
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2384
-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
  2385
-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
  2386
+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
  2387
+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
  2388
 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
  2389
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2390
 .RS 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2391
@@ -3529,9 +3535,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2392
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2393
 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
  2394
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2395
-+/\- 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
  2396
++/\- 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
  2397
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2398
-+/\- 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
  2399
++/\- 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
  2400
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2401
 Target file: /dest/foo/bar 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2402
 .br 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2403
@@ -3570,26 +3576,26 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2404
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2405
 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
  2406
 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
  2407
-(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
  2408
+(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
  2409
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2410
 .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
  2411
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2412
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2413
 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
  2414
 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
  2415
-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
  2416
+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
  2417
 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
  2418
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2419
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2420
-\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
  2421
+\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
  2422
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2423
-\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
  2424
+\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
  2425
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2426
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2427
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2428
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2429
 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
  2430
-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
  2431
+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
  2432
 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
  2433
 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
  2434
 because this ensures that the receiving side gets all the same exclude
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2435
@@ -3600,14 +3606,14 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2436
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2437
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2438
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2439
-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
  2440
+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
  2441
 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
  2442
-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
  2443
+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
  2444
 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
  2445
 remote .rules files exclude themselves):
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2446
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2447
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2448
-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
  2449
+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
  2450
    \-\-delete host:src/dir /dest
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2451
 .fi 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2452
 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2453
@@ -3620,12 +3626,12 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2454
 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
  2455
 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
  2456
 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
  2457
-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
  2458
+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
  2459
 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
  2460
 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
  2461
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2462
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2463
-    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
  2464
+    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
  2465
         host:src/dir /dest
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2466
     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
  2467
 .fi 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2468
@@ -3641,7 +3647,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2469
 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
  2470
 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
  2471
 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
  2472
-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
  2473
+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
  2474
 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
  2475
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2476
 Generating the batch file once saves having to perform the file
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2477
@@ -3656,7 +3662,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2478
 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
  2479
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2480
 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
  2481
-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
  2482
+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
  2483
 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
  2484
 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
  2485
 a Bourne (or Bourne\-like) shell, optionally passing in an alternate
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2486
@@ -3685,25 +3691,25 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2487
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2488
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2489
 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
  2490
-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
  2491
-\(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
  2492
+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
  2493
+"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
  2494
 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
  2495
 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
  2496
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2497
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2498
-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
  2499
+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
  2500
 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
  2501
 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
  2502
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2503
-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
  2504
+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
  2505
 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
  2506
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2507
 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
  2508
-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
  2509
+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
  2510
 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
  2511
 \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
  2512
 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
  2513
-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
  2514
+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
  2515
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2516
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2517
 Caveats:
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2518
@@ -3716,7 +3722,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2519
 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
  2520
 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
  2521
 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
  2522
-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
  2523
+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
  2524
 option (when reading the batch).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2525
 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
  2526
 partially updated state. In that case, rsync can
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2527
@@ -3732,7 +3738,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2528
 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
  2529
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2530
 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
  2531
-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
  2532
+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
  2533
 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
  2534
 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
  2535
 \fB\-\-files\-from\fP is dropped, and the
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2536
@@ -3740,13 +3746,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2537
 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
  2538
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2539
 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
  2540
-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
  2541
+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
  2542
 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
  2543
 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
  2544
 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
  2545
 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
  2546
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2547
-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
  2548
+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
  2549
 version uses a new implementation.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2550
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2551
 .SH "SYMBOLIC LINKS"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2552
@@ -3756,16 +3762,16 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2553
 link in the source directory.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2554
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2555
 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
  2556
-\(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
  2557
+"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
  2558
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2559
 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
  2560
 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
  2561
 \fB\-\-links\fP.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2562
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2563
-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
  2564
+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
  2565
 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
  2566
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2567
-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
  2568
+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
  2569
 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
  2570
 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
  2571
 \fB/etc/passwd\fP in the public section of the site.  Using
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2572
@@ -3775,11 +3781,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2573
 \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
  2574
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2575
 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
  2576
-(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
  2577
+(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
  2578
 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
  2579
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2580
-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
  2581
-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
  2582
+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
  2583
+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
  2584
 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
  2585
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2586
 .IP "\fB\-\-copy\-links\fP"
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2587
@@ -3805,8 +3811,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2588
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2589
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2590
 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
  2591
-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
  2592
-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
  2593
+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
  2594
+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
  2595
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2596
 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
  2597
 facility producing unwanted garbage on the stream that rsync is using
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2598
@@ -3906,13 +3912,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2599
 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
  2600
 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
  2601
 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
  2602
-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
  2603
+consult the remote shell's documentation.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2604
 .IP "\fBUSER\fP or \fBLOGNAME\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2605
 The USER or LOGNAME environment variables
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2606
 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
  2607
-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
  2608
+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
  2609
 .IP "\fBHOME\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2610
-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
  2611
+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
  2612
 default .cvsignore file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2613
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2614
 .PP 
5303
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2615
@@ -3924,7 +3930,7 @@
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2616
 .SH "SEE ALSO"
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2617
 
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2618
 .PP 
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2619
-\fBrsyncd.conf\fP(5)
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2620
+\fBrsyncd.conf\fP(5), \fBacl\fP(5)
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2621
 .PP 
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2622
 .SH "BUGS"
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2623
 
0f5e16a0a75d 20631267 rsync man page should note that rsync in Solaris does not support NFSv4 ACLs
Lukas Rovensky <Lukas.Rovensky@oracle.com>
parents: 3835
diff changeset
  2624
@@ -3987,7 +3993,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2625
 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
  2626
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2627
 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
  2628
-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
  2629
+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
  2630
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2631
 .SH "AUTHOR"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2632