components/rsync/patches/rsync.1.patch
author julian.yuen@oracle.com <julian.yuen@oracle.com>
Mon, 16 May 2016 17:05:06 -0700
changeset 5995 a107a73db207
parent 5826 9c90e4a8156c
permissions -rw-r--r--
23210083 Upgrade rsync to 3.1.2
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
5995
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   629
--- Originals/rsync.1	2016-05-16 11:43:51.047122549 -0700
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   630
+++ rsync-3.1.2/rsync.1	2016-05-16 16:45:27.881443220 -0700
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   631
@@ -999,7 +999,7 @@
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   632
 but does not conflict with \fB\-\-sparse\fP (since it is always extending a
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   633
 file's length).
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   634
 .IP 
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   635
-The use of \fB\-\-append\fP can be dangerous if you aren\(cq\&t 100% sure that the files
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   636
+The use of \fB\-\-append\fP can be dangerous if you aren't 100% sure that the files
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   637
 that are longer have only grown by the appending of data onto the end.  You
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   638
 should thus use include/exclude/filter rules to ensure that such a transfer is
a107a73db207 23210083 Upgrade rsync to 3.1.2
julian.yuen@oracle.com <julian.yuen@oracle.com>
parents: 5826
diff changeset
   639
 only affecting files that you know to be growing via appended data.
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   640
@@ -1007,21 +1011,21 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   641
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   642
 .IP "\fB\-d, \-\-dirs\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   643
 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
   644
-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
   645
-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
   646
-(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
   647
+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
   648
+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
   649
+(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
   650
 \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
   651
 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
   652
 \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
   653
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   654
 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
   655
 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
   656
-\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
   657
+\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
   658
 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
   659
 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
   660
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   661
 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
   662
-\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
   663
+\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
   664
 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
   665
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   666
 .IP "\fB\-l, \-\-links\fP"
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   667
@@ -1033,7 +1037,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   668
 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
   669
 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
   670
 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
   671
-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
   672
+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
   673
 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
   674
 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
   675
 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
   676
@@ -1055,11 +1059,11 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   677
 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
   678
 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
   679
 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
   680
-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
   681
+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
   682
 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
   683
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   684
 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
   685
-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
   686
+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
   687
 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
   688
 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
   689
 .IP 
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   690
@@ -1068,13 +1072,13 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   691
 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
   692
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   693
 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
   694
-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
   695
-\(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
   696
+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
   697
+"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
   698
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   699
 .IP "\fB\-k, \-\-copy\-dirlinks\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   700
 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
   701
 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
   702
-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
   703
+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
   704
 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
   705
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   706
 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
   707
@@ -1097,20 +1101,20 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   708
 .IP 
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   709
 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
   710
 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
   711
-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
   712
+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
   713
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   714
 .IP "\fB\-K, \-\-keep\-dirlinks\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   715
 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
   716
 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
   717
 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
   718
-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
   719
+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
   720
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   721
-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
   722
-\(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
   723
-\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
   724
+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
   725
+"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
   726
+\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
   727
 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
   728
-\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
   729
-\(dq\&bar\(dq\&.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   730
+\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
   731
+"bar".
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   732
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   733
 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
   734
 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
   735
@@ -1178,24 +1182,24 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   736
 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
   737
 the execute permission for the file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   738
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   739
-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
   740
-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
   741
-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
   742
-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
   743
+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
   744
+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
   745
+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
   746
+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
   747
 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
   748
 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
   749
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   750
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   751
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   752
 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
   753
-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
   754
+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
   755
 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
   756
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   757
 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
   758
 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
   759
 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
   760
 \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
   761
-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
   762
+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
   763
 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
   764
 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
   765
 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
   766
@@ -1213,13 +1217,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   767
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   768
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   769
 (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
   770
-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
   771
+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
   772
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   773
-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
   774
+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
   775
 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
   776
 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
   777
 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
   778
-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
   779
+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
   780
 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
   781
 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
   782
 (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
   783
@@ -1229,17 +1233,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   784
 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
   785
 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
   786
 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
   787
-\(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
   788
+\&'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
   789
 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
   790
-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
   791
+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
   792
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   793
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   794
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   795
-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
   796
+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
   797
 permissions.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   798
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   799
-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
   800
-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
   801
+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
   802
+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
   803
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   804
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   805
 .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
   806
@@ -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
   807
 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
   808
 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
   809
 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
   810
+.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
   811
+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
   812
 .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
   813
 .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
   814
 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
   815
@@ -1265,19 +1271,19 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   816
 .IP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   817
 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
   818
 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
   819
-\(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
   820
+"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
   821
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   822
 .IP "\fB\-\-chmod\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   823
 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
   824
-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
   825
+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
   826
 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
   827
 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
   828
 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
   829
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   830
 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
   831
 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
   832
-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
   833
-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
   834
+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
   835
+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
   836
 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
   837
 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
   838
 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
   839
@@ -1344,8 +1350,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   840
 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
   841
 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
   842
 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
   843
-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
   844
-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
   845
+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
   846
+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
   847
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   848
 .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
   849
 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
   850
@@ -1360,7 +1366,7 @@
3835
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   851
 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
   852
 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
   853
 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
   854
-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
   855
+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
   856
 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
   857
 directories.
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
   858
 .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
   859
@@ -1370,12 +1376,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   860
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   861
 .IP "\fB\-\-super\fP"
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   862
 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
   863
-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
   864
+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
   865
 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
   866
-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
   867
+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
   868
 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
   869
 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
   870
-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
   871
+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
   872
 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
   873
 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
   874
 .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
   875
@@ -1383,10 +1389,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   876
 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
   877
 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
   878
 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
   879
-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
   880
+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
   881
 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
   882
-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
   883
-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
   884
+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
   885
+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
   886
 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
   887
 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
   888
 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
   889
@@ -1412,18 +1418,18 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   890
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   891
 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
   892
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   893
-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
   894
+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
   895
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   896
 .IP "\fB\-S, \-\-sparse\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   897
 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
   898
-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
   899
+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
   900
 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
   901
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   902
 .IP "\fB\-\-preallocate\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   903
 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
   904
 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
   905
-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
   906
-\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
   907
+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
   908
+\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
   909
 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
   910
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   911
 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
   912
@@ -1432,7 +1438,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   913
 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
   914
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   915
 .IP "\fB\-n, \-\-dry\-run\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   916
-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
   917
+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
   918
 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
   919
 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
   920
 \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
   921
@@ -1440,29 +1446,29 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   922
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   923
 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
   924
 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
   925
-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
   926
+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
   927
 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
   928
 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
   929
-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
   930
-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
   931
+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
   932
+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
   933
 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
   934
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   935
 .IP "\fB\-W, \-\-whole\-file\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   936
-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
   937
+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
   938
 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
   939
 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
   940
 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
   941
-\(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
   942
+"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
   943
 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
   944
 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
   945
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   946
 .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
   947
 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
   948
-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
   949
-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
   950
+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
   951
+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
   952
 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
   953
 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
   954
-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
   955
+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
   956
 same filesystem.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   957
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
   958
 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
   959
@@ -1482,8 +1488,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   960
 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
   961
 (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
   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
 .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
   970
@@ -1491,15 +1497,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   971
 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
   972
 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
   973
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   974
-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
   975
-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
   976
+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
   977
+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
   978
 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
   979
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
   980
 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
   981
 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
   982
 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
   983
 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
   984
-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
   985
+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
   986
 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
   987
 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
   988
 .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
   989
@@ -1511,24 +1517,24 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
   990
 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
   991
 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
   992
 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
   993
-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
   994
-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
   995
+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
   996
+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
   997
 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
   998
-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
   999
-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
  1000
-\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
  1001
+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
  1002
+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
  1003
+\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
  1004
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1005
 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
  1006
-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
  1007
+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
  1008
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1009
 .IP "\fB\-\-delete\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1010
 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
  1011
-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
  1012
+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
  1013
 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
  1014
-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
  1015
-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
  1016
+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
  1017
+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
  1018
 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
  1019
-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
  1020
+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
  1021
 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
  1022
 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
  1023
 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
  1024
@@ -1585,7 +1591,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1025
 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
  1026
 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
  1027
 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
  1028
-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
  1029
+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
  1030
 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
  1031
 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
  1032
 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
  1033
@@ -1627,7 +1633,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1034
 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
  1035
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1036
 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
  1037
-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
  1038
+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
  1039
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1040
 .IP "\fB\-\-ignore\-errors\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1041
 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
  1042
@@ -1651,27 +1657,27 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1043
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1044
 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
  1045
 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
  1046
-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
  1047
+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
  1048
 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
  1049
 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
  1050
-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
  1051
+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
  1052
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1053
 .IP "\fB\-\-max\-size=SIZE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1054
 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
  1055
 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
  1056
 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
  1057
-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
  1058
+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
  1059
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1060
-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
  1061
-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
  1062
+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
  1063
+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
  1064
 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
  1065
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1066
-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
  1067
-\(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
  1068
+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
  1069
+"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
  1070
 gibibyte (1024*1024*1024).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1071
-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
  1072
-\(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
  1073
-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
  1074
+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
  1075
+"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
  1076
+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
  1077
 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
  1078
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1079
 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
  1080
@@ -1689,7 +1695,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1081
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1082
 .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
  1083
 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
  1084
-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
  1085
+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
  1086
 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
  1087
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1088
 .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
  1089
@@ -1702,8 +1708,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1090
 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
  1091
 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
  1092
 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
  1093
-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
  1094
-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
  1095
+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
  1096
+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
  1097
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1098
 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
  1099
 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
  1100
@@ -1715,9 +1721,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1101
 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
  1102
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1103
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1104
-\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
  1105
+\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
  1106
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1107
-\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
  1108
+\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
  1109
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1110
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1111
 
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
  1112
@@ -1733,9 +1739,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1113
 .IP "\fB\-\-rsync\-path=PROGRAM\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1114
 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
  1115
 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
  1116
-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
  1117
+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
  1118
 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
  1119
-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
  1120
+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
  1121
 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
  1122
 communicate.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1123
 .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
  1124
@@ -1743,7 +1749,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1125
 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
  1126
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1127
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1128
-\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
  1129
+\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
  1130
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1131
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1132
 .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
  1133
@@ -1776,8 +1782,8 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1134
 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
  1135
 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
  1136
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1137
-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
  1138
-\(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
  1139
+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
  1140
+"remote" side is the receiver.
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1141
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1142
 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
  1143
 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
  1144
@@ -1786,7 +1792,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1145
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1146
 .IP "\fB\-C, \-\-cvs\-exclude\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1147
 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
  1148
-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
  1149
+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
  1150
 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
  1151
 a file should be ignored.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1152
 .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
  1153
@@ -1808,17 +1814,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1154
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1155
 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
  1156
 \&.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
  1157
-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
  1158
+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
  1159
 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
  1160
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1161
-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
  1162
+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
  1163
 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
  1164
 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
  1165
 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
  1166
 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
  1167
 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
  1168
 \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
  1169
-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
  1170
+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
  1171
 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
  1172
 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
  1173
 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
  1174
@@ -1841,7 +1847,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1175
 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
  1176
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1177
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1178
-\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
  1179
+\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
  1180
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1181
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1182
 .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
  1183
@@ -1851,7 +1857,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1184
 rule:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1185
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1186
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1187
-\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
  1188
+\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
  1189
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1190
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1191
 .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
  1192
@@ -1870,7 +1876,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1193
 .IP "\fB\-\-exclude\-from=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1194
 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
  1195
 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
  1196
-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
  1197
+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
  1198
 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
  1199
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1200
 .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
  1201
@@ -1883,7 +1889,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1202
 .IP "\fB\-\-include\-from=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1203
 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
  1204
 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
  1205
-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
  1206
+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
  1207
 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
  1208
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1209
 .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
  1210
@@ -1902,7 +1908,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1211
 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
  1212
 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
  1213
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1214
-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
  1215
+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
  1216
 (\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
  1217
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1218
 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
  1219
@@ -1913,7 +1919,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1220
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1221
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1222
 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
  1223
-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
  1224
+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
  1225
 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
  1226
 command:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1227
 .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
  1228
@@ -1922,12 +1928,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1229
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1230
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1231
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1232
-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
  1233
+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
  1234
 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
  1235
-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
  1236
+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
  1237
 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
  1238
 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
  1239
-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
  1240
+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
  1241
 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
  1242
 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
  1243
 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
  1244
@@ -1936,10 +1942,10 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1245
 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
  1246
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1247
 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
  1248
-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
  1249
+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
  1250
 (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
  1251
-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
  1252
-transfer\(dq\&.  For example:
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1253
+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
  1254
+transfer".  For example:
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1255
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1256
 .RS 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1257
 \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
  1258
@@ -1947,12 +1953,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1259
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1260
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1261
 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
  1262
-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
  1263
+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
  1264
 .IP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1265
 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
  1266
 \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
  1267
-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
  1268
-receiving host\(cq\&s charset.
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1269
+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
  1270
+receiving host's charset.
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1271
 .IP 
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1272
 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
  1273
 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
  1274
@@ -1962,7 +1968,7 @@
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  1275
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1276
 .IP "\fB\-0, \-\-from0\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1277
 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
  1278
-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
  1279
+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
  1280
 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
  1281
 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
  1282
 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
  1283
@@ -1985,7 +1991,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1284
 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
  1285
 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
  1286
 (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
  1287
-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
  1288
+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
  1289
 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
  1290
 that.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1291
 .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
  1292
@@ -2020,9 +2026,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1293
 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
  1294
 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
  1295
 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
  1296
-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
  1297
+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
  1298
 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
  1299
-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
  1300
+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
  1301
 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
  1302
 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
  1303
 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
  1304
@@ -2050,7 +2056,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1305
 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
  1306
 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
  1307
 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
  1308
-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
  1309
+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
  1310
 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
  1311
 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
  1312
 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
  1313
@@ -2099,10 +2105,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1314
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1315
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1316
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1317
-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
  1318
-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
  1319
+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
  1320
+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
  1321
 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
  1322
-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
  1323
+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
  1324
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1325
 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
  1326
 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
  1327
@@ -2172,11 +2178,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1328
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1329
 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
  1330
 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
  1331
-\(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
  1332
+"[: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
  1333
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1334
 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
  1335
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1336
-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
  1337
+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
  1338
 matches 2 suffixes):
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1339
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1340
 .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
  1341
@@ -2234,8 +2240,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1342
 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
  1343
 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
  1344
 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
  1345
-\(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
  1346
-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
  1347
+"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
  1348
+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
  1349
 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
  1350
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1351
 .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
  1352
@@ -2245,9 +2251,9 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1353
 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
  1354
 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
  1355
 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
  1356
-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
  1357
+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
  1358
 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
  1359
-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
  1360
+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
  1361
 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
  1362
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1363
 .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
  1364
@@ -2259,15 +2265,15 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1365
 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
  1366
 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
  1367
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1368
-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
  1369
+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
  1370
 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
  1371
-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
  1372
+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
  1373
 \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
  1374
 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
  1375
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1376
 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
  1377
 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
  1378
-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
  1379
+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
  1380
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1381
 .nf 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1382
   \-\-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
  1383
@@ -2294,8 +2300,8 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1384
 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
  1385
 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
  1386
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1387
-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
  1388
-\(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
  1389
+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
  1390
+"\-\-usermap=*:foo \-\-groupmap=*:bar", only easier.
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1391
 .IP 
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1392
 .IP "\fB\-\-timeout=TIMEOUT\fP"
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1393
 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
  1394
@@ -2345,18 +2351,18 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1395
 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
  1396
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1397
 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
  1398
-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
  1399
+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
  1400
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1401
 .IP "\fB\-i, \-\-itemize\-changes\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1402
 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
  1403
 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
  1404
-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
  1405
+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
  1406
 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
  1407
 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
  1408
 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
  1409
 verbose messages).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1410
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1411
-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
  1412
+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
  1413
 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
  1414
 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
  1415
 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
  1416
@@ -2382,7 +2388,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1417
 have attributes that are being modified).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1418
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1419
 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
  1420
-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
  1421
+a message (e.g. "deleting").
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1422
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1423
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1424
 .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
  1425
@@ -2392,10 +2398,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1426
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1427
 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
  1428
 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
  1429
-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
  1430
-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
  1431
+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
  1432
+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
  1433
 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
  1434
-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
  1435
+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
  1436
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1437
 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
  1438
 .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
  1439
@@ -2411,21 +2417,21 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1440
 by the file transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1441
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1442
 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
  1443
-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
  1444
+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
  1445
 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
  1446
 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
  1447
-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
  1448
+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
  1449
 (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
  1450
 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
  1451
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1452
 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
  1453
-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
  1454
+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
  1455
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1456
 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
  1457
-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
  1458
+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
  1459
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1460
 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
  1461
-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
  1462
+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
  1463
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1464
 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
  1465
 .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
  1466
@@ -2435,8 +2441,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1467
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1468
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1469
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1470
-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
  1471
-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
  1472
+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
  1473
+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
  1474
 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
  1475
 outputting them as a verbose message).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1476
 .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
  1477
@@ -2444,10 +2450,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1478
 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
  1479
 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
  1480
 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
  1481
-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
  1482
+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
  1483
 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
  1484
 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
  1485
-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
  1486
+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
  1487
 rsyncd.conf manpage.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1488
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1489
 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
  1490
@@ -2457,11 +2463,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1491
 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
  1492
 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
  1493
 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
  1494
-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
  1495
+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
  1496
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1497
-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
  1498
+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
  1499
 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
  1500
-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
  1501
+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
  1502
 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
  1503
 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
  1504
 (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
  1505
@@ -2471,10 +2477,10 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1506
 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
  1507
 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
  1508
 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
  1509
-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
  1510
+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
  1511
 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
  1512
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1513
-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
  1514
+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
  1515
 happening:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1516
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1517
 .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
  1518
@@ -2490,15 +2496,15 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1519
 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
  1520
 (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
  1521
 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
  1522
-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
  1523
+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
  1524
 in the rsyncd.conf manpage.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1525
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1526
 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
  1527
-is \(cq\&%i %n%L\(cq\&.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1528
+is '%i %n%L'.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1529
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1530
 .IP "\fB\-\-stats\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1531
 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
  1532
-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
  1533
+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
  1534
 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
  1535
 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
  1536
 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
  1537
@@ -2506,27 +2512,27 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1538
 The current statistics are as follows: 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1539
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1540
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1541
-\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
  1542
+\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
  1543
 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
  1544
 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
  1545
-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
  1546
+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
  1547
 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
  1548
 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
  1549
 .IP o 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1550
-\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
  1551
+\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
  1552
 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
  1553
 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
  1554
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1555
-\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
  1556
+\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
  1557
 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
  1558
 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
  1559
 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
  1560
 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
  1561
 .IP o 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1562
 \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
  1563
-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
  1564
+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
  1565
 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
  1566
-\(dq\&regular\(dq\& into this heading.
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1567
+"regular" into this heading.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1568
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1569
 \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
  1570
 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
  1571
@@ -2557,22 +2563,22 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1572
 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
  1573
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1574
 \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
  1575
-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
  1576
-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
  1577
+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
  1578
+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
  1579
 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
  1580
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1581
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1582
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1583
 .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
  1584
 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
  1585
-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
  1586
+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
  1587
 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
  1588
-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
  1589
+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
  1590
 setting.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1591
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1592
 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
  1593
 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
  1594
-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
  1595
+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
  1596
 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
  1597
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1598
 .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
  1599
@@ -2594,7 +2600,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1600
 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
  1601
 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
  1602
 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
  1603
-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
  1604
+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
  1605
 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
  1606
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1607
 .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
  1608
@@ -2615,12 +2621,12 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1609
 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
  1610
 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
  1611
 (since
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1612
-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
  1613
+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
  1614
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1615
 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
  1616
 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
  1617
-\(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
  1618
-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
  1619
+"\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
  1620
+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
  1621
 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
  1622
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1623
 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
  1624
@@ -2628,21 +2634,21 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1625
 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
  1626
 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
  1627
 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
  1628
-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
  1629
+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
  1630
 filter rules.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1631
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1632
 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
  1633
 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
  1634
 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
  1635
-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
  1636
+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
  1637
 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
  1638
-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
  1639
-\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
  1640
-\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
  1641
+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
  1642
+\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
  1643
+\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
  1644
 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
  1645
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1646
 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
  1647
-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
  1648
+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
  1649
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1650
 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
  1651
 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
  1652
@@ -2655,7 +2661,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1653
 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
  1654
 \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
  1655
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1656
-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
  1657
+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
  1658
 \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
  1659
 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
  1660
 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
  1661
@@ -2666,12 +2672,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1662
 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
  1663
 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
  1664
 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
  1665
-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
  1666
-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
  1667
+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
  1668
+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
  1669
 \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
  1670
 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
  1671
-\(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
  1672
-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
  1673
+".~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
  1674
+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
  1675
 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
  1676
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1677
 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
  1678
@@ -2683,9 +2689,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1679
 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
  1680
 absolute)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1681
 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
  1682
-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
  1683
+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
  1684
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1685
-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
  1686
+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
  1687
 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
  1688
 parallel hierarchy of files).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1689
 .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
  1690
@@ -2709,26 +2715,26 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1691
 this.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1692
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1693
 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
  1694
-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
  1695
-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
  1696
+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
  1697
+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
  1698
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1699
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1700
-\-\-filter \(cq\&protect emptydir/\(cq\&
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1701
+\-\-filter 'protect emptydir/'
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1702
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1703
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1704
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1705
-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
  1706
+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
  1707
 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
  1708
 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
  1709
 (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
  1710
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1711
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1712
-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
  1713
+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
  1714
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1715
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1716
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1717
-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
  1718
-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
  1719
+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
  1720
+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
  1721
 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
  1722
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1723
 .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
  1724
@@ -2737,7 +2743,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1725
 something to watch.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1726
 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
  1727
 \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
  1728
-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
  1729
+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
  1730
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1731
 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
  1732
 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
  1733
@@ -2748,12 +2754,12 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1734
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1735
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1736
 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
  1737
-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
  1738
+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
  1739
 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
  1740
 is maintained until the end.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1741
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1742
-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
  1743
-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
  1744
+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
  1745
+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
  1746
 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
  1747
 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
  1748
 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
  1749
@@ -2774,12 +2780,12 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1750
 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
  1751
 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
  1752
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1753
-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
  1754
+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
  1755
 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
  1756
-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
  1757
-(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
  1758
+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
  1759
+(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
  1760
 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
  1761
-\(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
  1762
+"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
  1763
 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
  1764
 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
  1765
 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
  1766
@@ -2793,7 +2799,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1767
 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
  1768
 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
  1769
 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
  1770
-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
  1771
+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
  1772
 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
  1773
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1774
 .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
  1775
@@ -2804,10 +2810,10 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1776
 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
  1777
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1778
 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
  1779
-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
  1780
+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
  1781
 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
  1782
 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
  1783
-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
  1784
+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
  1785
 config file).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1786
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1787
 .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
  1788
@@ -2837,17 +2843,17 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1789
 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
  1790
 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
  1791
 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
  1792
-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
  1793
-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
  1794
-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
  1795
-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
  1796
+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
  1797
+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
  1798
+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
  1799
+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
  1800
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1801
 .IP "\fB\-\-bwlimit=RATE\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1802
 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
  1803
 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
  1804
 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
  1805
-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
  1806
-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
  1807
+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
  1808
+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
  1809
 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
  1810
 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
  1811
 .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
  1812
@@ -2856,7 +2862,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1813
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1814
 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
  1815
 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
  1816
-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
  1817
+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
  1818
 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
  1819
 .IP 
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1820
 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
  1821
@@ -2867,7 +2873,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1822
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1823
 .IP "\fB\-\-write\-batch=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1824
 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
  1825
-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
  1826
+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
  1827
 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
  1828
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1829
 .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
  1830
@@ -2879,58 +2885,58 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1831
 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
  1832
 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
  1833
 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
  1834
-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
  1835
+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
  1836
 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
  1837
 happening).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1838
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1839
 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
  1840
 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
  1841
 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
  1842
-(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
  1843
+(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
  1844
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1845
 .IP "\fB\-\-read\-batch=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1846
 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
  1847
 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
  1848
 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
  1849
-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
  1850
+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
  1851
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1852
 .IP "\fB\-\-protocol=NUM\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1853
 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
  1854
 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
  1855
 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
  1856
 \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
  1857
-\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
  1858
+\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
  1859
 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
  1860
-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
  1861
+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
  1862
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1863
 .IP "\fB\-\-iconv=CONVERT_SPEC\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1864
 Rsync can convert filenames between character
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1865
-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
  1866
+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
  1867
 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
  1868
 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
  1869
 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
  1870
 \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
  1871
-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
  1872
-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
  1873
+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
  1874
+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
  1875
 to turn off any conversion.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1876
 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
  1877
 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
  1878
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1879
 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
  1880
-run \(dq\&iconv \-\-list\(dq\&.
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1881
+run "iconv \-\-list".
297
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
 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
  1884
 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
  1885
 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
  1886
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1887
 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
  1888
-(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
  1889
+(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
  1890
 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
  1891
 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
  1892
 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
  1893
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1894
 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
  1895
-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
  1896
+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
  1897
 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
  1898
 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
  1899
 .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
  1900
@@ -2947,10 +2953,10 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1901
 .IP "\fB\-\-checksum\-seed=NUM\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1902
 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
  1903
 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
  1904
-(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
  1905
+(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
  1906
 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
  1907
-\f(CWtime()\fP
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1908
-\&.  This
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1909
+\f(CWtime().\fP
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1910
+This
fff36af96643 20524211 update rsync to 3.1.1
klauw <ken.lauw@oracle.com>
parents: 1817
diff changeset
  1911
 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
  1912
 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
  1913
 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
  1914
@@ -2980,7 +2986,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1915
 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
  1916
 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
  1917
 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
  1918
-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
  1919
+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
  1920
 .IP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1921
 .IP "\fB\-\-bwlimit=RATE\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1922
 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
  1923
@@ -2998,7 +3004,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1924
 .IP "\fB\-M, \-\-dparam=OVERRIDE\fP"
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1925
 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
  1926
 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
  1927
-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
  1928
+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
  1929
 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
  1930
 desire.  For instance:
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1931
 .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
  1932
@@ -3012,25 +3018,25 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1933
 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
  1934
 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
  1935
 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
  1936
-\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
  1937
+\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
  1938
 \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
  1939
 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
  1940
 sshd.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1941
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1942
 .IP "\fB\-\-port=PORT\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1943
 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
  1944
-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
  1945
+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
  1946
 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
  1947
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1948
 .IP "\fB\-\-log\-file=FILE\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1949
 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
  1950
-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
  1951
+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
  1952
 file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1953
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1954
 .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
  1955
 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
  1956
-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
  1957
-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
  1958
+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
  1959
+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
  1960
 case transfer logging is turned off.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1961
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1962
 .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
  1963
@@ -3040,15 +3046,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1964
 .IP "\fB\-v, \-\-verbose\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1965
 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
  1966
 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
  1967
-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
  1968
-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
  1969
+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
  1970
+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
  1971
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1972
 .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
  1973
 Tells rsync to prefer IPv4/IPv6
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1974
 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
  1975
 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
  1976
 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
  1977
-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
  1978
+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
  1979
 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
  1980
 .IP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1981
 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
  1982
@@ -3087,7 +3093,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1983
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1984
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1985
 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
  1986
-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
  1987
+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
  1988
 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
  1989
 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
  1990
 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
  1991
@@ -3115,15 +3121,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1992
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1993
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  1994
 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
  1995
-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
  1996
+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
  1997
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  1998
 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
  1999
 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
  2000
-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
  2001
+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
  2002
 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
  2003
 If a pattern
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2004
-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
  2005
-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
  2006
+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
  2007
+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
  2008
 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
  2009
 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
  2010
 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
  2011
@@ -3136,8 +3142,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2012
 .SH "INCLUDE/EXCLUDE PATTERN RULES"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2013
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2014
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2015
-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
  2016
-\(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
  2017
+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
  2018
+"\-", 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
  2019
 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
  2020
 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
  2021
 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
  2022
@@ -3147,15 +3153,15 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2023
 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
  2024
 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
  2025
 regular expressions.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2026
-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
  2027
-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
  2028
+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
  2029
+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
  2030
 per\-directory rule).
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2031
-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
  2032
+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
  2033
 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
  2034
 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
  2035
-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
  2036
-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
  2037
-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
  2038
+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
  2039
+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
  2040
+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
  2041
 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
  2042
 of the transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2043
 .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
  2044
@@ -3164,48 +3170,48 @@
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
 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
  2047
 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
  2048
-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
  2049
+characters: '*', '?', and '[' .
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2050
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2051
-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
  2052
+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
  2053
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2054
-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
  2055
+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
  2056
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2057
-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
  2058
+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
  2059
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2060
-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
  2061
+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
  2062
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2063
 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
  2064
 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
  2065
 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
  2066
 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
  2067
-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
  2068
-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
  2069
+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
  2070
+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
  2071
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2072
-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
  2073
+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
  2074
 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
  2075
-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
  2076
+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
  2077
 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
  2078
-(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
  2079
+(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
  2080
 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
  2081
 down.)
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2082
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2083
-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
  2084
-\(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
  2085
-(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
  2086
+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
  2087
+"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
  2088
+(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
  2089
 version 2.6.7.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2090
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2091
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2092
 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
  2093
 \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
  2094
-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
  2095
-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
  2096
-\(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
  2097
+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
  2098
+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
  2099
+"/foo/bar" must not be excluded).
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2100
 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
  2101
 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
  2102
 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
  2103
 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
  2104
-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
  2105
-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
  2106
+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
  2107
+For instance, this won't work:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2108
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2109
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2110
 \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
  2111
@@ -3217,11 +3223,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2112
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2113
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2114
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2115
-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
  2116
-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
  2117
+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
  2118
+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
  2119
 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
  2120
-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
  2121
-\(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
  2122
+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
  2123
+"\- *" 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
  2124
 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
  2125
 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
  2126
 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
  2127
@@ -3243,44 +3249,44 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2128
 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
  2129
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2130
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2131
-\(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
  2132
+"\- *.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
  2133
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2134
-\(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
  2135
+"\- /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
  2136
 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
-\(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
  2139
+"\- 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
  2140
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2141
-\(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
  2142
+"\- /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
  2143
 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
  2144
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2145
-\(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
  2146
+"\- /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
  2147
 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
  2148
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2149
-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
  2150
+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
  2151
 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
  2152
 \fB\-\-prune\-empty\-dirs\fP option)
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
-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
  2155
+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
  2156
 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
  2157
-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
  2158
+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
  2159
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2160
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2161
-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
  2162
+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
  2163
 .PP 
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 rule should be matched
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2166
 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
  2167
-\(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
  2168
-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
  2169
-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
  2170
-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
  2171
+"\-/ /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
  2172
+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
  2173
+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
  2174
+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
  2175
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2176
 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
  2177
-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
  2178
+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
  2179
 non\-directories.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2180
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2181
 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
  2182
-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
  2183
+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
  2184
 follow.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2185
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2186
 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
  2187
@@ -3298,7 +3304,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2188
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2189
 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
  2190
 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
  2191
-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
  2192
+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
  2193
 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
  2194
 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
  2195
 
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
  2196
@@ -3310,16 +3316,16 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2197
 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
  2198
 section above).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2199
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2200
-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
  2201
-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
  2202
-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
  2203
+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
  2204
+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
  2205
+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
  2206
 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
  2207
 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
  2208
 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
  2209
 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
  2210
 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
  2211
 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
  2212
-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
  2213
+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
  2214
 below).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2215
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2216
 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
  2217
@@ -3348,27 +3354,27 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2218
 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
  2219
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2220
 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
  2221
-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
  2222
+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
  2223
 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
  2224
-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
  2225
+provided, ".cvsignore" is assumed.
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2226
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2227
 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
  2228
-\(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
  2229
+"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
  2230
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2231
 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
  2232
 .IP o 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2233
 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
  2234
 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
  2235
 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
  2236
-\(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
  2237
+"\- 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
  2238
 also disabled).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2239
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2240
-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
  2241
+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
  2242
 (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
  2243
 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
  2244
-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
  2245
+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
  2246
 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
  2247
-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
  2248
+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
  2249
 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
  2250
 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
  2251
 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
  2252
@@ -3376,22 +3382,22 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2253
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2254
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2255
 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
  2256
-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
  2257
-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
  2258
+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
  2259
+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
  2260
 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
  2261
 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
  2262
 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
  2263
 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
  2264
-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
  2265
+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
  2266
 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
  2267
 .PP 
1351
5c589218fa09 15752593 SUNBT7107925 bump rsync to 3.0.9
klauw <ken.lauw@oracle.com>
parents: 297
diff changeset
  2268
 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
  2269
 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
  2270
-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
  2271
-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
  2272
+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
  2273
+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
  2274
 file was found.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2275
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2276
-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
  2277
+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
  2278
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2279
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2280
 \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
  2281
@@ -3408,7 +3414,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2282
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2283
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2284
 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
  2285
-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
  2286
+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
  2287
 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
  2288
 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
  2289
 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
  2290
@@ -3419,7 +3425,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2291
 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
  2292
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2293
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2294
-\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
  2295
+\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
  2296
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2297
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2298
 .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
  2299
@@ -3427,38 +3433,38 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2300
 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
  2301
 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
  2302
 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
  2303
-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
  2304
+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
  2305
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2306
 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
  2307
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2308
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2309
 \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
  2310
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2311
-\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
  2312
+\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
  2313
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2314
-\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
  2315
+\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
  2316
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2317
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2318
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2319
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2320
-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
  2321
-\(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
  2322
+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
  2323
+"/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
  2324
 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
  2325
-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
  2326
+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
  2327
 a part of the transfer.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2328
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2329
-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
  2330
-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
  2331
+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
  2332
+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
  2333
 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
  2334
-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
  2335
+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
  2336
 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
  2337
-\(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
  2338
+":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
  2339
 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
  2340
 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
  2341
 example:
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2342
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2343
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2344
-\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
  2345
+\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
  2346
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2347
 \f(CW+ foo.o\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2348
 .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
  2349
@@ -3468,7 +3474,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2350
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2351
 \f(CWEOT\fP
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2352
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2353
-\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
  2354
+\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
  2355
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2356
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2357
 
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
  2358
@@ -3479,25 +3485,25 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2359
 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
  2360
 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
  2361
 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
  2362
-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
  2363
-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
  2364
+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
  2365
+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
  2366
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2367
 .SH "LIST\-CLEARING FILTER RULE"
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2368
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2369
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2370
-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
  2371
-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
  2372
+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
  2373
+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
  2374
 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
  2375
 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
  2376
 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
  2377
-out the parent\(cq\&s rules).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2378
+out the parent's rules).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2379
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2380
 .SH "ANCHORING INCLUDE/EXCLUDE PATTERNS"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2381
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2382
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2383
 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
  2384
-\(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
  2385
-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
  2386
+"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
  2387
+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
  2388
 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
  2389
 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
  2390
 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
  2391
@@ -3508,8 +3514,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2392
 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
  2393
 host).  The following examples demonstrate this.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2394
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2395
-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
  2396
-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
  2397
+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
  2398
+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
  2399
 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
  2400
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2401
 .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
  2402
@@ -3529,9 +3535,9 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2403
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2404
 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
  2405
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2406
-+/\- 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
  2407
++/\- 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
  2408
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2409
-+/\- 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
  2410
++/\- 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
  2411
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2412
 Target file: /dest/foo/bar 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2413
 .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
  2414
@@ -3570,26 +3576,26 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2415
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2416
 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
  2417
 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
  2418
-(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
  2419
+(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
  2420
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2421
 .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
  2422
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2423
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2424
 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
  2425
 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
  2426
-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
  2427
+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
  2428
 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
  2429
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2430
 .RS 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2431
-\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
  2432
+\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
  2433
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2434
-\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
  2435
+\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
  2436
 .br 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2437
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2438
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2439
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2440
 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
  2441
-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
  2442
+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
  2443
 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
  2444
 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
  2445
 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
  2446
@@ -3600,14 +3606,14 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2447
 .RE
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2448
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2449
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2450
-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
  2451
+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
  2452
 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
  2453
-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
  2454
+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
  2455
 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
  2456
 remote .rules files exclude themselves):
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2457
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2458
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2459
-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
  2460
+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
  2461
    \-\-delete host:src/dir /dest
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2462
 .fi 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2463
 
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
  2464
@@ -3620,12 +3626,12 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2465
 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
  2466
 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
  2467
 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
  2468
-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
  2469
+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
  2470
 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
  2471
 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
  2472
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2473
 .nf 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2474
-    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
  2475
+    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
  2476
         host:src/dir /dest
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2477
     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
  2478
 .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
  2479
@@ -3641,7 +3647,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2480
 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
  2481
 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
  2482
 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
  2483
-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
  2484
+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
  2485
 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
  2486
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2487
 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
  2488
@@ -3656,7 +3662,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2489
 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
  2490
 .PP 
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2491
 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
  2492
-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
  2493
+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
  2494
 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
  2495
 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
  2496
 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
  2497
@@ -3685,25 +3691,25 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2498
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2499
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2500
 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
  2501
-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
  2502
-\(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
  2503
+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
  2504
+"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
  2505
 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
  2506
 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
  2507
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2508
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2509
-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
  2510
+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
  2511
 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
  2512
 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
  2513
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2514
-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
  2515
+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
  2516
 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
  2517
 .IP o 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2518
 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
  2519
-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
  2520
+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
  2521
 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
  2522
 \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
  2523
 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
  2524
-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
  2525
+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
  2526
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2527
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2528
 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
  2529
@@ -3716,7 +3722,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2530
 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
  2531
 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
  2532
 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
  2533
-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
  2534
+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
  2535
 option (when reading the batch).
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2536
 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
  2537
 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
  2538
@@ -3732,7 +3738,7 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2539
 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
  2540
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2541
 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
  2542
-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
  2543
+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
  2544
 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
  2545
 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
  2546
 \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
  2547
@@ -3740,13 +3746,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2548
 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
  2549
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2550
 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
  2551
-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
  2552
+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
  2553
 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
  2554
 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
  2555
 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
  2556
 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
  2557
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2558
-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
  2559
+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
  2560
 version uses a new implementation.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2561
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2562
 .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
  2563
@@ -3756,16 +3762,16 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2564
 link in the source directory.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2565
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2566
 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
  2567
-\(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
  2568
+"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
  2569
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2570
 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
  2571
 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
  2572
 \fB\-\-links\fP.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2573
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2574
-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
  2575
+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
  2576
 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
  2577
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2578
-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
  2579
+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
  2580
 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
  2581
 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
  2582
 \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
  2583
@@ -3775,11 +3781,11 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2584
 \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
  2585
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2586
 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
  2587
-(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
  2588
+(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
  2589
 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
  2590
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2591
-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
  2592
-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
  2593
+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
  2594
+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
  2595
 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
  2596
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2597
 .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
  2598
@@ -3805,8 +3811,8 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2599
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2600
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2601
 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
  2602
-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
  2603
-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
  2604
+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
  2605
+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
  2606
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2607
 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
  2608
 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
  2609
@@ -3906,13 +3912,13 @@
297
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2610
 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
  2611
 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
  2612
 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
  2613
-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
  2614
+consult the remote shell's documentation.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2615
 .IP "\fBUSER\fP or \fBLOGNAME\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2616
 The USER or LOGNAME environment variables
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2617
 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
  2618
-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
  2619
+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
  2620
 .IP "\fBHOME\fP"
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2621
-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
  2622
+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
  2623
 default .cvsignore file.
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2624
 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2625
 .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
  2626
@@ -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
  2627
 .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
  2628
 
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
  2629
 .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
  2630
-\fBrsyncd.conf\fP(5)
5826
9c90e4a8156c 23137909 Userland man page normalization work
Rich Burridge <rich.burridge@oracle.com>
parents: 5303
diff changeset
  2631
+\fBrsyncd.conf\fP(5), \fBacl\fP(7)
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
  2632
 .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
  2633
 .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
  2634
 
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
  2635
@@ -3987,7 +3993,7 @@
1817
ff42a83716c4 18414592 update rsync to 3.1.0
Danek Duvall <danek.duvall@oracle.com>
parents: 1351
diff changeset
  2636
 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
  2637
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2638
 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
  2639
-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
  2640
+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
  2641
 .PP 
3940bc347ca8 7034286 Problem with utility/rsync (fix patches)
Norm Jacobs <Norm.Jacobs@Oracle.COM>
parents: 296
diff changeset
  2642
 .SH "AUTHOR"