77 +\(lqserver\(rq. Don't confuse \(lqserver\(rq with an rsync daemon \(em a daemon is always a |
76 +\(lqserver\(rq. Don't confuse \(lqserver\(rq with an rsync daemon \(em a daemon is always a |
78 +server, but a server can be either a daemon or a remote-shell spawned process. |
77 +server, but a server can be either a daemon or a remote-shell spawned process. |
79 .PP |
78 .PP |
80 .SH "SETUP" |
79 .SH "SETUP" |
81 |
80 |
82 @@ -93,7 +93,7 @@ |
81 @@ -93,7 +94,7 @@ |
83 .PP |
82 .PP |
84 Once installed, you can use rsync to any machine that you can access via |
83 Once installed, you can use rsync to any machine that you can access via |
85 a remote shell (as well as some that you can access using the rsync |
84 a remote shell (as well as some that you can access using the rsync |
86 -daemon\-mode protocol). For remote transfers, a modern rsync uses ssh |
85 -daemon\-mode protocol). For remote transfers, a modern rsync uses ssh |
87 +daemon-mode protocol). For remote transfers, a modern rsync uses ssh |
86 +daemon-mode protocol). For remote transfers, a modern rsync uses ssh |
88 for its communications, but it may have been configured to use a |
87 for its communications, but it may have been configured to use a |
89 different remote shell by default, such as rsh or remsh. |
88 different remote shell by default, such as rsh or remsh. |
90 .PP |
89 .PP |
91 @@ -119,7 +119,7 @@ |
90 @@ -119,7 +120,7 @@ |
92 This would transfer all files matching the pattern *.c from the |
91 This would transfer all files matching the pattern *.c from the |
93 current directory to the directory src on the machine foo. If any of |
92 current directory to the directory src on the machine foo. If any of |
94 the files already exist on the remote system then the rsync |
93 the files already exist on the remote system then the rsync |
95 -remote\-update protocol is used to update the file by sending only the |
94 -remote\-update protocol is used to update the file by sending only the |
96 +remote-update protocol is used to update the file by sending only the |
95 +remote-update protocol is used to update the file by sending only the |
97 differences. See the tech report for details. |
96 differences. See the tech report for details. |
98 .PP |
97 .PP |
99 .RS |
98 .RS |
100 @@ -129,7 +129,7 @@ |
99 @@ -129,7 +130,7 @@ |
101 .PP |
100 .PP |
102 This would recursively transfer all files from the directory src/bar on the |
101 This would recursively transfer all files from the directory src/bar on the |
103 machine foo into the /data/tmp/bar directory on the local machine. The |
102 machine foo into the /data/tmp/bar directory on the local machine. The |
104 -files are transferred in \(dq\&archive\(dq\& mode, which ensures that symbolic |
103 -files are transferred in \(dq\&archive\(dq\& mode, which ensures that symbolic |
105 +files are transferred in \(lqarchive\(rq mode, which ensures that symbolic |
104 +files are transferred in \(lqarchive\(rq mode, which ensures that symbolic |
106 links, devices, attributes, permissions, ownerships, etc. are preserved |
105 links, devices, attributes, permissions, ownerships, etc. are preserved |
107 in the transfer. Additionally, compression will be used to reduce the |
106 in the transfer. Additionally, compression will be used to reduce the |
108 size of data portions of the transfer. |
107 size of data portions of the transfer. |
109 @@ -141,8 +141,8 @@ |
108 @@ -141,8 +142,8 @@ |
110 .PP |
109 .PP |
111 A trailing slash on the source changes this behavior to avoid creating an |
110 A trailing slash on the source changes this behavior to avoid creating an |
112 additional directory level at the destination. You can think of a trailing |
111 additional directory level at the destination. You can think of a trailing |
113 -/ on a source as meaning \(dq\© the contents of this directory\(dq\& as opposed |
112 -/ on a source as meaning \(dq\© the contents of this directory\(dq\& as opposed |
114 -to \(dq\© the directory by name\(dq\&, but in both cases the attributes of the |
113 -to \(dq\© the directory by name\(dq\&, but in both cases the attributes of the |
115 +/ on a source as meaning \(lqcopy the contents of this directory\(rq as opposed |
114 +/ on a source as meaning \(lqcopy the contents of this directory\(rq as opposed |
116 +to \(lqcopy the directory by name\(rq, but in both cases the attributes of the |
115 +to \(lqcopy the directory by name\(rq, but in both cases the attributes of the |
117 containing directory are transferred to the containing directory on the |
116 containing directory are transferred to the containing directory on the |
118 destination. In other words, each of the following commands copies the |
117 destination. In other words, each of the following commands copies the |
119 files in the same way, including their setting of the attributes of |
118 files in the same way, including their setting of the attributes of |
120 @@ -156,9 +156,9 @@ |
119 @@ -156,9 +157,9 @@ |
121 .RE |
120 .RE |
122 |
121 |
123 .PP |
122 .PP |
124 -Note also that host and module references don\(cq\&t require a trailing slash to |
123 -Note also that host and module references don\(cq\&t require a trailing slash to |
125 +Note also that host and module references don't require a trailing slash to |
124 +Note also that host and module references don't require a trailing slash to |
293 .PP |
297 .PP |
294 -If you\(cq\&re using one of the remote\-shell transports for the transfer, there is |
298 -If you\(cq\&re using one of the remote\-shell transports for the transfer, there is |
295 +If you're using one of the remote-shell transports for the transfer, there is |
299 +If you're using one of the remote-shell transports for the transfer, there is |
296 no need to manually start an rsync daemon. |
300 no need to manually start an rsync daemon. |
297 .PP |
301 .PP |
|
302 .SH "SORTED TRANSFER ORDER" |
|
303 @@ -353,19 +358,19 @@ |
|
304 This handles the merging together of the contents of identically named |
|
305 directories, makes it easy to remove duplicate filenames, and may confuse |
|
306 someone when the files are transferred in a different order than what was |
|
307 -given on the command\-line. |
|
308 +given on the command-line. |
|
309 .PP |
|
310 If you need a particular file to be transferred prior to another, either |
|
311 separate the files into different rsync calls, or consider using |
|
312 -\fB\-\-delay\-updates\fP (which doesn\(cq\&t affect the sorted transfer order, but |
|
313 -does make the final file\-updating phase happen much more rapidly). |
|
314 +\fB\-\-delay-updates\fP (which doesn't affect the sorted transfer order, but |
|
315 +does make the final file-updating phase happen much more rapidly). |
|
316 .PP |
298 .SH "EXAMPLES" |
317 .SH "EXAMPLES" |
299 @@ -351,7 +351,7 @@ |
318 |
300 .PP |
319 .PP |
301 Here are some examples of how I use rsync. |
320 Here are some examples of how I use rsync. |
302 .PP |
321 .PP |
303 -To backup my wife\(cq\&s home directory, which consists of large MS Word |
322 -To backup my wife\(cq\&s home directory, which consists of large MS Word |
304 +To backup my wife's home directory, which consists of large MS Word |
323 +To backup my wife's home directory, which consists of large MS Word |
305 files and mail folders, I use a cron job that runs |
324 files and mail folders, I use a cron job that runs |
306 .PP |
325 .PP |
307 .RS |
326 .RS |
308 @@ -360,7 +360,7 @@ |
327 @@ -374,14 +379,14 @@ |
309 |
328 |
310 .PP |
329 .PP |
311 each night over a PPP connection to a duplicate directory on my machine |
330 each night over a PPP connection to a duplicate directory on my machine |
312 -\(dq\&arvidsjaur\(dq\&. |
331 -\(dq\&arvidsjaur\(dq\&. |
313 +\(lqarvidsjaur\(rq. |
332 +\(lqarvidsjaur\(rq. |
314 .PP |
333 .PP |
315 To synchronize my samba source trees I use the following Makefile |
334 To synchronize my samba source trees I use the following Makefile |
316 targets: |
335 targets: |
317 @@ -367,7 +367,7 @@ |
|
318 .PP |
336 .PP |
319 .nf |
337 .nf |
320 get: |
338 get: |
321 - rsync \-avuzb \-\-exclude '\&*~'\& samba:samba/ . |
339 - rsync \-avuzb \-\-exclude '\&*~'\& samba:samba/ . |
322 + rsync \-avuzb \-\-exclude '*~' samba:samba/ . |
340 + rsync \-avuzb \-\-exclude '*~' samba:samba/ . |
323 put: |
341 put: |
324 rsync \-Cavuzb . samba:samba/ |
342 rsync \-Cavuzb . samba:samba/ |
325 sync: get put |
343 sync: get put |
326 @@ -376,12 +376,12 @@ |
344 @@ -390,12 +395,12 @@ |
327 .PP |
345 .PP |
328 this allows me to sync with a CVS directory at the other end of the |
346 this allows me to sync with a CVS directory at the other end of the |
329 connection. I then do CVS operations on the remote machine, which saves a |
347 connection. I then do CVS operations on the remote machine, which saves a |
330 -lot of time as the remote CVS protocol isn\(cq\&t very efficient. |
348 -lot of time as the remote CVS protocol isn\(cq\&t very efficient. |
331 +lot of time as the remote CVS protocol isn't very efficient. |
349 +lot of time as the remote CVS protocol isn't very efficient. |
429 - \-\-modify\-window=NUM compare mod\-times with reduced accuracy |
447 - \-\-modify\-window=NUM compare mod\-times with reduced accuracy |
430 + \-\-modify\-window=NUM compare mod-times with reduced accuracy |
448 + \-\-modify\-window=NUM compare mod-times with reduced accuracy |
431 \-T, \-\-temp\-dir=DIR create temporary files in directory DIR |
449 \-T, \-\-temp\-dir=DIR create temporary files in directory DIR |
432 \-y, \-\-fuzzy find similar file for basis if no dest file |
450 \-y, \-\-fuzzy find similar file for basis if no dest file |
433 \-\-compare\-dest=DIR also compare received files relative to DIR |
451 \-\-compare\-dest=DIR also compare received files relative to DIR |
434 @@ -470,31 +470,31 @@ |
452 @@ -484,29 +489,29 @@ |
435 \-z, \-\-compress compress file data during the transfer |
453 \-z, \-\-compress compress file data during the transfer |
436 \-\-compress\-level=NUM explicitly set compression level |
454 \-\-compress\-level=NUM explicitly set compression level |
437 \-\-skip\-compress=LIST skip compressing files with suffix in LIST |
455 \-\-skip\-compress=LIST skip compressing files with suffix in LIST |
438 - \-C, \-\-cvs\-exclude auto\-ignore files in the same way CVS does |
456 - \-C, \-\-cvs\-exclude auto\-ignore files in the same way CVS does |
439 - \-f, \-\-filter=RULE add a file\-filtering RULE |
457 - \-f, \-\-filter=RULE add a file\-filtering RULE |
440 - \-F same as \-\-filter='\&dir\-merge /.rsync\-filter'\& |
458 - \-F same as \-\-filter='\&dir\-merge /.rsync\-filter'\& |
441 - repeated: \-\-filter='\&\- .rsync\-filter'\& |
459 - repeated: \-\-filter='\&\- .rsync\-filter'\& |
442 + \-C, \-\-cvs\-exclude auto-ignore files in the same way CVS does |
460 + \-C, \-\-cvs\-exclude auto-ignore files in the same way CVS does |
443 + \-f, \-\-filter=RULE add a file-filtering RULE |
461 + \-f, \-\-filter=RULE add a file-filtering RULE |
444 + \-F same as \-\-filter='dir-merge /.rsync\-filter' |
462 + \-F same as \-\-filter='dir-merge /.rsync\-filter' |
445 + repeated: \-\-filter='\- .rsync\-filter' |
463 + repeated: \-\-filter='\- .rsync-filter |
446 \-\-exclude=PATTERN exclude files matching PATTERN |
464 \-\-exclude=PATTERN exclude files matching PATTERN |
447 \-\-exclude\-from=FILE read exclude patterns from FILE |
465 \-\-exclude\-from=FILE read exclude patterns from FILE |
448 - \-\-include=PATTERN don'\&t exclude files matching PATTERN |
466 - \-\-include=PATTERN don'\&t exclude files matching PATTERN |
449 + \-\-include=PATTERN don't exclude files matching PATTERN |
467 + \-\-include=PATTERN don't exclude files matching PATTERN |
450 \-\-include\-from=FILE read include patterns from FILE |
468 \-\-include\-from=FILE read include patterns from FILE |
470 + \-i, \-\-itemize\-changes output a change-summary for all updates |
488 + \-i, \-\-itemize\-changes output a change-summary for all updates |
471 \-\-out\-format=FORMAT output updates using the specified FORMAT |
489 \-\-out\-format=FORMAT output updates using the specified FORMAT |
472 - \-\-log\-file=FILE log what we'\&re doing to the specified FILE |
490 - \-\-log\-file=FILE log what we'\&re doing to the specified FILE |
473 + \-\-log\-file=FILE log what we're doing to the specified FILE |
491 + \-\-log\-file=FILE log what we're doing to the specified FILE |
474 \-\-log\-file\-format=FMT log updates using the specified FMT |
492 \-\-log\-file\-format=FMT log updates using the specified FMT |
475 - \-\-password\-file=FILE read daemon\-access password from FILE |
493 \-\-password\-file=FILE read daemon\-access password from FILE |
476 + \-\-password\-file=FILE read daemon-access password from FILE |
|
477 \-\-list\-only list the files instead of copying them |
494 \-\-list\-only list the files instead of copying them |
478 \-\-bwlimit=KBPS limit I/O bandwidth; KBytes per second |
495 @@ -534,8 +539,8 @@ |
479 \-\-write\-batch=FILE write a batched update to FILE |
|
480 @@ -520,8 +520,8 @@ |
|
481 \-\-config=FILE specify alternate rsyncd.conf file |
496 \-\-config=FILE specify alternate rsyncd.conf file |
482 \-\-no\-detach do not detach from the parent |
497 \-\-no\-detach do not detach from the parent |
483 \-\-port=PORT listen on alternate port number |
498 \-\-port=PORT listen on alternate port number |
484 - \-\-log\-file=FILE override the \(dq\&log file\(dq\& setting |
499 - \-\-log\-file=FILE override the \(dq\&log file\(dq\& setting |
485 - \-\-log\-file\-format=FMT override the \(dq\&log format\(dq\& setting |
500 - \-\-log\-file\-format=FMT override the \(dq\&log format\(dq\& setting |
486 + \-\-log\-file=FILE override the "log file" setting |
501 + \-\-log\-file=FILE override the "log file" setting |
487 + \-\-log\-file\-format=FMT override the "log format" setting |
502 + \-\-log\-file\-format=FMT override the "log format" setting |
488 \-\-sockopts=OPTIONS specify custom TCP options |
503 \-\-sockopts=OPTIONS specify custom TCP options |
489 \-v, \-\-verbose increase verbosity |
504 \-v, \-\-verbose increase verbosity |
490 \-4, \-\-ipv4 prefer IPv4 |
505 \-4, \-\-ipv4 prefer IPv4 |
491 @@ -536,12 +536,12 @@ |
506 @@ -547,21 +552,21 @@ |
492 rsync uses the GNU long options package. Many of the command line |
507 .SH "OPTIONS" |
493 options have two variants, one short and one long. These are shown |
508 |
494 below, separated by commas. Some options only have a long variant. |
509 .PP |
495 -The \(cq\&=\(cq\& for options that take a parameter is optional; whitespace |
510 -Rsync accepts both long (double\-dash + word) and short (single\-dash + letter) |
496 +The \(oq=\(cq for options that take a parameter is optional; whitespace |
511 +Rsync accepts both long (double-dash + word) and short (single\-dash + letter) |
497 can be used instead. |
512 options. The full list of the available options are described below. If an |
|
513 option can be specified in more than one way, the choices are comma\-separated. |
|
514 Some options only have a long variant, not a short. If the option takes a |
|
515 parameter, the parameter is only listed after the long variant, even though it |
|
516 must also be specified for the short. When specifying a parameter, you can |
|
517 -either use the form \-\-option=param or replace the \(cq\&=\(cq\& with whitespace. The |
|
518 -parameter may need to be quoted in some manner for it to survive the shell\(cq\&s |
|
519 +either use the form \-\-option=param or replace the '=' with whitespace. The |
|
520 +parameter may need to be quoted in some manner for it to survive the shell's |
|
521 command\-line parsing. Keep in mind that a leading tilde (~) in a filename is |
|
522 substituted by your shell, so \-\-option=~/foo will not change the tilde into |
|
523 -your home directory (remove the \(cq\&=\(cq\& for that). |
|
524 +your home directory (remove the '=' for that). |
498 .PP |
525 .PP |
499 .IP "\fB\-\-help\fP" |
526 .IP "\fB\-\-help\fP" |
500 Print a short help page describing the options |
527 Print a short help page describing the options |
501 -available in rsync and exit. For backward\-compatibility with older |
528 -available in rsync and exit. For backward\-compatibility with older |
502 +available in rsync and exit. For backward-compatibility with older |
529 +available in rsync and exit. For backward-compatibility with older |
503 versions of rsync, the help will also be output if you use the \fB\-h\fP |
530 versions of rsync, the help will also be output if you use the \fB\-h\fP |
504 option without any other args. |
531 option without any other args. |
505 .IP |
532 .IP |
506 @@ -558,11 +558,11 @@ |
533 @@ -578,11 +583,11 @@ |
507 you are debugging rsync. |
534 you are debugging rsync. |
508 .IP |
535 .IP |
509 Note that the names of the transferred files that are output are done using |
536 Note that the names of the transferred files that are output are done using |
510 -a default \fB\-\-out\-format\fP of \(dq\&%n%L\(dq\&, which tells you just the name of the |
537 -a default \fB\-\-out\-format\fP of \(dq\&%n%L\(dq\&, which tells you just the name of the |
511 +a default \fB\-\-out\-format\fP of \(lq%n%L\(rq, which tells you just the name of the |
538 +a default \fB\-\-out\-format\fP of \(lq%n%L\(rq, which tells you just the name of the |
515 -\fB\-\-itemize\-changes\fP or adding \(dq\&%i\(dq\& to the \fB\-\-out\-format\fP setting), the |
542 -\fB\-\-itemize\-changes\fP or adding \(dq\&%i\(dq\& to the \fB\-\-out\-format\fP setting), the |
516 +\fB\-\-itemize\-changes\fP or adding \(lq%i\(rq to the \fB\-\-out\-format\fP setting), the |
543 +\fB\-\-itemize\-changes\fP or adding \(lq%i\(rq to the \fB\-\-out\-format\fP setting), the |
517 output (on the client) increases to mention all items that are changed in |
544 output (on the client) increases to mention all items that are changed in |
518 any way. See the \fB\-\-out\-format\fP option for more details. |
545 any way. See the \fB\-\-out\-format\fP option for more details. |
519 .IP |
546 .IP |
520 @@ -575,8 +575,8 @@ |
547 @@ -595,56 +600,56 @@ |
521 .IP "\fB\-\-no\-motd\fP" |
548 .IP "\fB\-\-no\-motd\fP" |
522 This option affects the information that is output |
549 This option affects the information that is output |
523 by the client at the start of a daemon transfer. This suppresses the |
550 by the client at the start of a daemon transfer. This suppresses the |
524 -message\-of\-the\-day (MOTD) text, but it also affects the list of modules |
551 -message\-of\-the\-day (MOTD) text, but it also affects the list of modules |
525 -that the daemon sends in response to the \(dq\&rsync host::\(dq\& request (due to |
552 -that the daemon sends in response to the \(dq\&rsync host::\(dq\& request (due to |
526 +message-of-the-day (MOTD) text, but it also affects the list of modules |
553 +message-of-the-day (MOTD) text, but it also affects the list of modules |
527 +that the daemon sends in response to the \(lqrsync host::\(rq request (due to |
554 +that the daemon sends in response to the \(lqrsync host::\(rq request (due to |
528 a limitation in the rsync protocol), so omit this option if you want to |
555 a limitation in the rsync protocol), so omit this option if you want to |
529 request the list of modules from the daemon. |
556 request the list of modules from the daemon. |
530 .IP |
557 .IP |
531 @@ -583,13 +583,13 @@ |
|
532 .IP "\fB\-I, \-\-ignore\-times\fP" |
558 .IP "\fB\-I, \-\-ignore\-times\fP" |
533 Normally rsync will skip any files that are |
559 Normally rsync will skip any files that are |
534 already the same size and have the same modification timestamp. |
560 already the same size and have the same modification timestamp. |
535 -This option turns off this \(dq\&quick check\(dq\& behavior, causing all files to |
561 -This option turns off this \(dq\&quick check\(dq\& behavior, causing all files to |
536 +This option turns off this \(lqquick check\(rq behavior, causing all files to |
562 +This option turns off this \(lqquick check\(rq behavior, causing all files to |
619 -Note also that the side\-effects of the \fB\-\-files\-from\fP option are NOT |
644 -Note also that the side\-effects of the \fB\-\-files\-from\fP option are NOT |
620 +Note also that the side-effects of the \fB\-\-files\-from\fP option are NOT |
645 +Note also that the side-effects of the \fB\-\-files\-from\fP option are NOT |
621 positional, as it affects the default state of several options and slightly |
646 positional, as it affects the default state of several options and slightly |
622 changes the meaning of \fB\-a\fP (see the \fB\-\-files\-from\fP option for more |
647 changes the meaning of \fB\-a\fP (see the \fB\-\-files\-from\fP option for more |
623 details). |
648 details). |
624 @@ -668,7 +668,7 @@ |
649 @@ -688,7 +693,7 @@ |
625 incremental scan that uses much less memory than before and begins the |
650 incremental scan that uses much less memory than before and begins the |
626 transfer after the scanning of the first few directories have been |
651 transfer after the scanning of the first few directories have been |
627 completed. This incremental scan only affects our recursion algorithm, and |
652 completed. This incremental scan only affects our recursion algorithm, and |
628 -does not change a non\-recursive transfer. It is also only possible when |
653 -does not change a non\-recursive transfer. It is also only possible when |
629 +does not change a non-recursive transfer. It is also only possible when |
654 +does not change a non-recursive transfer. It is also only possible when |
630 both ends of the transfer are at least version 3.0.0. |
655 both ends of the transfer are at least version 3.0.0. |
631 .IP |
656 .IP |
632 Some options require rsync to know the full file list, so these options |
657 Some options require rsync to know the full file list, so these options |
633 @@ -705,16 +705,16 @@ |
658 @@ -725,16 +730,16 @@ |
634 .IP |
659 .IP |
635 then a file named /tmp/foo/bar/baz.c would be created on the remote |
660 then a file named /tmp/foo/bar/baz.c would be created on the remote |
636 machine, preserving its full path. These extra path elements are called |
661 machine, preserving its full path. These extra path elements are called |
637 -\(dq\&implied directories\(dq\& (i.e. the \(dq\&foo\(dq\& and the \(dq\&foo/bar\(dq\& directories in the |
662 -\(dq\&implied directories\(dq\& (i.e. the \(dq\&foo\(dq\& and the \(dq\&foo/bar\(dq\& directories in the |
638 +\(lqimplied directories\(rq (i.e. the \(lqfoo\(rq and the \(lqfoo/bar\(rq directories in the |
663 +\(lqimplied directories\(rq (i.e. the \(lqfoo\(rq and the \(lqfoo/bar\(rq directories in the |
722 -your rules specify a trailing inclusion/exclusion of \(cq\&*\(cq\&, the auto\-added |
745 -your rules specify a trailing inclusion/exclusion of \(cq\&*\(cq\&, the auto\-added |
723 +your rules specify a trailing inclusion/exclusion of \(oq*\(cq, the auto-added |
746 +your rules specify a trailing inclusion/exclusion of \(oq*\(cq, the auto-added |
724 rule would never be reached). |
747 rule would never be reached). |
725 .IP |
748 .IP |
726 .IP "\fB\-\-backup\-dir=DIR\fP" |
749 .IP "\fB\-\-backup\-dir=DIR\fP" |
727 @@ -799,22 +799,16 @@ |
750 @@ -821,20 +826,20 @@ |
728 (otherwise the files backed up in the specified directory |
751 .IP |
729 will keep their original filenames). |
752 Note that if you specify a relative path, the backup directory will be |
730 .IP |
753 relative to the destination directory, so you probably want to specify |
731 -Note that if you specify a relative path, the backup directory will be |
|
732 -relative to the destination directory, so you probably want to specify |
|
733 -either an absolute path or a path that starts with \(dq\&../\(dq\&. If an rsync |
754 -either an absolute path or a path that starts with \(dq\&../\(dq\&. If an rsync |
734 -daemon is the receiver, the backup dir cannot go outside the module\(cq\&s path |
755 -daemon is the receiver, the backup dir cannot go outside the module\(cq\&s path |
735 -hierarchy, so take extra care not to delete it or copy into it. |
756 +either an absolute path or a path that starts with \(lq../\(rq. If an rsync |
736 -.IP |
757 +daemon is the receiver, the backup dir cannot go outside the module's path |
|
758 hierarchy, so take extra care not to delete it or copy into it. |
|
759 .IP |
737 .IP "\fB\-\-suffix=SUFFIX\fP" |
760 .IP "\fB\-\-suffix=SUFFIX\fP" |
738 This option allows you to override the default |
761 This option allows you to override the default |
739 backup suffix used with the \fB\-\-backup\fP (\fB\-b\fP) option. The default suffix is a ~ |
762 backup suffix used with the \fB\-\-backup\fP (\fB\-b\fP) option. The default suffix is a ~ |
740 -if no \-\fB\-backup\-dir\fP was specified, otherwise it is an empty string. |
763 -if no \-\fB\-backup\-dir\fP was specified, otherwise it is an empty string. |
741 +if no \-\fB\-backup-dir\fP was specified, otherwise it is an empty string. |
764 +if no \-\fB\-backup-dir\fP was specified, otherwise it is an empty string. |
747 -source file\(cq\&s, it will be updated if the sizes are different.) |
770 -source file\(cq\&s, it will be updated if the sizes are different.) |
748 +source file's, it will be updated if the sizes are different.) |
771 +source file's, it will be updated if the sizes are different.) |
749 .IP |
772 .IP |
750 Note that this does not affect the copying of symlinks or other special |
773 Note that this does not affect the copying of symlinks or other special |
751 files. Also, a difference of file format between the sender and receiver |
774 files. Also, a difference of file format between the sender and receiver |
752 @@ -823,52 +817,34 @@ |
775 @@ -843,8 +848,8 @@ |
753 where the destination has a file, the transfer would occur regardless of |
776 where the destination has a file, the transfer would occur regardless of |
754 the timestamps. |
777 the timestamps. |
755 .IP |
778 .IP |
756 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
779 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
757 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
780 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
758 +This option is a transfer rule, not an exclude, so it doesn't affect the |
781 +This option is a transfer rule, not an exclude, so it doesn't affect the |
759 +data that goes into the file-lists, and thus it doesn't affect deletions. |
782 +data that goes into the file-lists, and thus it doesn't affect deletions. |
760 It just limits the files that the receiver requests to be transferred. |
783 It just limits the files that the receiver requests to be transferred. |
761 .IP |
784 .IP |
762 .IP "\fB\-\-inplace\fP" |
785 .IP "\fB\-\-inplace\fP" |
763 -This option changes how rsync transfers a file when |
786 @@ -859,14 +864,14 @@ |
764 -its data needs to be updated: instead of the default method of creating |
787 .IP o |
765 +This option changes how rsync transfers a file when the |
788 Hard links are not broken. This means the new data will be visible |
766 +file's data needs to be updated: instead of the default method of creating |
789 through other hard links to the destination file. Moreover, attempts to |
767 a new copy of the file and moving it into place when it is complete, rsync |
|
768 instead writes the updated data directly to the destination file. |
|
769 .IP |
|
770 -This has several effects: |
|
771 +This has several effects: (1) in-use binaries cannot be updated (either the |
|
772 +OS will prevent this from happening, or binaries that attempt to swap-in |
|
773 +their data will misbehave or crash), (2) the file's data will be in an |
|
774 +inconsistent state during the transfer, (3) a file's data may be left in an |
|
775 +inconsistent state after the transfer if the transfer is interrupted or if |
|
776 +an update fails, (4) a file that does not have write permissions can not be |
|
777 +updated, and (5) the efficiency of rsync's delta-transfer algorithm may be |
|
778 +reduced if some data in the destination file is overwritten before it can |
|
779 +be copied to a position later in the file (one exception to this is if you |
|
780 +combine this option with \fB\-\-backup\fP, since rsync is smart enough to use |
|
781 +the backup file as the basis file for the transfer). |
|
782 .IP |
|
783 -.RS |
|
784 -.IP o |
|
785 -Hard links are not broken. This means the new data will be visible |
|
786 -through other hard links to the destination file. Moreover, attempts to |
|
787 -copy differing source files onto a multiply\-linked destination file will |
790 -copy differing source files onto a multiply\-linked destination file will |
788 -result in a \(dq\&tug of war\(dq\& with the destination data changing back and forth. |
791 -result in a \(dq\&tug of war\(dq\& with the destination data changing back and forth. |
789 -.IP o |
792 +copy differing source files onto a multiply-linked destination file will |
790 -In\-use binaries cannot be updated (either the OS will prevent this from |
793 +result in a \(lqtug of war\(rq with the destination data changing back and forth. |
|
794 .IP o |
|
795 In\-use binaries cannot be updated (either the OS will prevent this from |
791 -happening, or binaries that attempt to swap\-in their data will misbehave or |
796 -happening, or binaries that attempt to swap\-in their data will misbehave or |
792 -crash). |
797 +happening, or binaries that attempt to swap-in their data will misbehave or |
793 -.IP o |
798 crash). |
|
799 .IP o |
794 -The file\(cq\&s data will be in an inconsistent state during the transfer |
800 -The file\(cq\&s data will be in an inconsistent state during the transfer |
795 -and will be left that way if the transfer is interrupted or if an update |
801 +The file's data will be in an inconsistent state during the transfer |
796 -fails. |
802 and will be left that way if the transfer is interrupted or if an update |
797 -.IP o |
803 fails. |
798 -A file that rsync cannot write to cannot be updated. While a super user |
804 .IP o |
799 -can update any file, a normal user needs to be granted write permission for |
805 @@ -874,7 +879,7 @@ |
800 -the open of the file for writing to be successful. |
806 can update any file, a normal user needs to be granted write permission for |
801 -.IP o |
807 the open of the file for writing to be successful. |
|
808 .IP o |
802 -The efficiency of rsync\(cq\&s delta\-transfer algorithm may be reduced if |
809 -The efficiency of rsync\(cq\&s delta\-transfer algorithm may be reduced if |
803 -some data in the destination file is overwritten before it can be copied to |
810 +The efficiency of rsync's delta-transfer algorithm may be reduced if |
804 -a position later in the file. This does not apply if you use \fB\-\-backup\fP, |
811 some data in the destination file is overwritten before it can be copied to |
805 -since rsync is smart enough to use the backup file as the basis file for the |
812 a position later in the file. This does not apply if you use \fB\-\-backup\fP, |
806 -transfer. |
813 since rsync is smart enough to use the backup file as the basis file for the |
807 -.RE |
814 @@ -885,9 +890,9 @@ |
808 - |
|
809 -.IP |
|
810 WARNING: you should not use this option to update files that are being |
815 WARNING: you should not use this option to update files that are being |
811 accessed by others, so be careful when choosing to use this for a copy. |
816 accessed by others, so be careful when choosing to use this for a copy. |
812 .IP |
817 .IP |
813 -This option is useful for transferring large files with block\-based changes |
818 -This option is useful for transferring large files with block\-based changes |
814 +This option is useful for transfer of large files with block-based changes |
819 +This option is useful for transferring large files with block-based changes |
815 or appended data, and also on systems that are disk bound, not network |
820 or appended data, and also on systems that are disk bound, not network |
816 -bound. It can also help keep a copy\-on\-write filesystem snapshot from |
821 -bound. It can also help keep a copy\-on\-write filesystem snapshot from |
817 -diverging the entire contents of a file that only has minor changes. |
822 +bound. It can also help keep a copy-on-write filesystem snapshot from |
818 +bound. |
823 diverging the entire contents of a file that only has minor changes. |
819 .IP |
824 .IP |
820 The option implies \fB\-\-partial\fP (since an interrupted transfer does not delete |
825 The option implies \fB\-\-partial\fP (since an interrupted transfer does not delete |
821 the file), but conflicts with \fB\-\-partial\-dir\fP and \fB\-\-delay\-updates\fP. |
826 @@ -901,18 +906,18 @@ |
822 @@ -881,18 +857,18 @@ |
|
823 the receiving side is identical with the start of the file on the sending |
827 the receiving side is identical with the start of the file on the sending |
824 side. If a file needs to be transferred and its size on the receiver is |
828 side. If a file needs to be transferred and its size on the receiver is |
825 the same or longer than the size on the sender, the file is skipped. This |
829 the same or longer than the size on the sender, the file is skipped. This |
826 -does not interfere with the updating of a file\(cq\&s non\-content attributes |
830 -does not interfere with the updating of a file\(cq\&s non\-content attributes |
827 +does not interfere with the updating of a file's non-content attributes |
831 +does not interfere with the updating of a file's non-content attributes |
887 +an rsync that is too old to understand \fB\-K\fP \(em in that case, the \fB\-L\fP option |
890 +an rsync that is too old to understand \fB\-K\fP \(em in that case, the \fB\-L\fP option |
888 +will still have the side-effect of \fB\-K\fP on that older receiving rsync. |
891 +will still have the side-effect of \fB\-K\fP on that older receiving rsync. |
889 .IP |
892 .IP |
890 .IP "\fB\-\-copy\-unsafe\-links\fP" |
893 .IP "\fB\-\-copy\-unsafe\-links\fP" |
891 This tells rsync to copy the referent of |
894 This tells rsync to copy the referent of |
892 @@ -949,7 +925,7 @@ |
895 @@ -969,7 +974,7 @@ |
893 .IP "\fB\-k, \-\-copy\-dirlinks\fP" |
896 .IP "\fB\-k, \-\-copy\-dirlinks\fP" |
894 This option causes the sending side to treat |
897 This option causes the sending side to treat |
895 a symlink to a directory as though it were a real directory. This is |
898 a symlink to a directory as though it were a real directory. This is |
896 -useful if you don\(cq\&t want symlinks to non\-directories to be affected, as |
899 -useful if you don\(cq\&t want symlinks to non\-directories to be affected, as |
897 +useful if you don't want symlinks to non-directories to be affected, as |
900 +useful if you don't want symlinks to non-directories to be affected, as |
898 they would be using \fB\-\-copy\-links\fP. |
901 they would be using \fB\-\-copy\-links\fP. |
899 .IP |
902 .IP |
900 Without this option, if the sending side has replaced a directory with a |
903 Without this option, if the sending side has replaced a directory with a |
901 @@ -960,32 +936,18 @@ |
904 @@ -986,26 +991,26 @@ |
902 See also \fB\-\-keep\-dirlinks\fP for an analogous option for the receiving |
905 to make the paths match up right. For example: |
903 side. |
906 .IP |
904 .IP |
907 .RS |
905 -\fB\-\-copy\-dirlinks\fP applies to all symlinks to directories in the source. If |
|
906 -you want to follow only a few specified symlinks, a trick you can use is to |
|
907 -pass them as additional source args with a trailing slash, using \fB\-\-relative\fP |
|
908 -to make the paths match up right. For example: |
|
909 -.IP |
|
910 -.RS |
|
911 -\f(CWrsync \-r \-\-relative src/./ src/./follow\-me/ dest/\fP |
908 -\f(CWrsync \-r \-\-relative src/./ src/./follow\-me/ dest/\fP |
912 -.RE |
909 +\f(CWrsync \-r \-\-relative src/./ src/./follo-me/ dest/\fP |
913 - |
910 .RE |
914 -.IP |
911 |
915 -This works because rsync calls \fBlstat\fP(2) on the source arg as given, and the |
912 .IP |
916 -trailing slash makes \fBlstat\fP(2) follow the symlink, giving rise to a directory |
913 This works because rsync calls \fBlstat\fP(2) on the source arg as given, and the |
|
914 trailing slash makes \fBlstat\fP(2) follow the symlink, giving rise to a directory |
917 -in the file\-list which overrides the symlink found during the scan of \(dq\&src/./\(dq\&. |
915 -in the file\-list which overrides the symlink found during the scan of \(dq\&src/./\(dq\&. |
918 -.IP |
916 +in the file-list which overrides the symlink found during the scan of \(lqsrc/./\(rq. |
|
917 .IP |
919 .IP "\fB\-K, \-\-keep\-dirlinks\fP" |
918 .IP "\fB\-K, \-\-keep\-dirlinks\fP" |
920 This option causes the receiving side to treat |
919 This option causes the receiving side to treat |
921 a symlink to a directory as though it were a real directory, but only if it |
920 a symlink to a directory as though it were a real directory, but only if it |
922 matches a real directory from the sender. Without this option, the |
921 matches a real directory from the sender. Without this option, the |
923 -receiver\(cq\&s symlink would be deleted and replaced with a real directory. |
922 -receiver\(cq\&s symlink would be deleted and replaced with a real directory. |
935 +\fB\-\-keep\-dirlinks\fP, the receiver keeps the symlink and \(lqfile\(rq ends up in |
934 +\fB\-\-keep\-dirlinks\fP, the receiver keeps the symlink and \(lqfile\(rq ends up in |
936 +\(lqbar\(rq. |
935 +\(lqbar\(rq. |
937 .IP |
936 .IP |
938 One note of caution: if you use \fB\-\-keep\-dirlinks\fP, you must trust all |
937 One note of caution: if you use \fB\-\-keep\-dirlinks\fP, you must trust all |
939 the symlinks in the copy! If it is possible for an untrusted user to |
938 the symlinks in the copy! If it is possible for an untrusted user to |
940 @@ -998,32 +960,21 @@ |
939 @@ -1018,7 +1023,7 @@ |
941 See also \fB\-\-copy\-dirlinks\fP for an analogous option for the sending side. |
940 See also \fB\-\-copy\-dirlinks\fP for an analogous option for the sending side. |
942 .IP |
941 .IP |
943 .IP "\fB\-H, \-\-hard\-links\fP" |
942 .IP "\fB\-H, \-\-hard\-links\fP" |
944 -This tells rsync to look for hard\-linked files in |
943 -This tells rsync to look for hard\-linked files in |
945 -the source and link together the corresponding files on the destination. |
|
946 -Without this option, hard\-linked files in the source are treated |
|
947 +This tells rsync to look for hard-linked files in |
944 +This tells rsync to look for hard-linked files in |
948 +the transfer and link together the corresponding files on the receiving |
945 the source and link together the corresponding files on the destination. |
949 +side. Without this option, hard-linked files in the transfer are treated |
946 Without this option, hard\-linked files in the source are treated |
950 as though they were separate files. |
947 as though they were separate files. |
951 .IP |
948 @@ -1029,10 +1034,10 @@ |
952 -This option does NOT necessarily ensure that the pattern of hard links on the |
949 .IP |
953 -destination exactly matches that on the source. Cases in which the |
950 .RS |
954 -destination may end up with extra hard links include the following: |
951 .IP o |
955 +When you are updating a non-empty destination, this option only ensures |
|
956 +that files that are hard-linked together on the source are hard-linked |
|
957 +together on the destination. It does NOT currently endeavor to break |
|
958 +already existing hard links on the destination that do not exist between |
|
959 +the source files. Note, however, that if one or more extra-linked files |
|
960 +have content changes, they will become unlinked when updated (assuming you |
|
961 +are not using the \fB\-\-inplace\fP option). |
|
962 .IP |
|
963 -.RS |
|
964 -.IP o |
|
965 -If the destination contains extraneous hard\-links (more linking than |
952 -If the destination contains extraneous hard\-links (more linking than |
966 -what is present in the source file list), the copying algorithm will not |
953 +If the destination contains extraneous hard-links (more linking than |
967 -break them explicitly. However, if one or more of the paths have content |
954 what is present in the source file list), the copying algorithm will not |
|
955 break them explicitly. However, if one or more of the paths have content |
968 -differences, the normal file\-update process will break those extra links |
956 -differences, the normal file\-update process will break those extra links |
969 -(unless you are using the \fB\-\-inplace\fP option). |
957 +differences, the normal file-update process will break those extra links |
970 -.IP o |
958 (unless you are using the \fB\-\-inplace\fP option). |
971 -If you specify a \fB\-\-link\-dest\fP directory that contains hard links, |
959 .IP o |
972 -the linking of the destination files against the \fB\-\-link\-dest\fP files can |
960 If you specify a \fB\-\-link\-dest\fP directory that contains hard links, |
973 -cause some paths in the destination to become linked together due to the |
961 @@ -1043,7 +1048,7 @@ |
974 -\fB\-\-link\-dest\fP associations. |
962 |
975 -.RE |
963 .IP |
976 - |
|
977 -.IP |
|
978 Note that rsync can only detect hard links between files that are inside |
964 Note that rsync can only detect hard links between files that are inside |
979 -the transfer set. If rsync updates a file that has extra hard\-link |
965 -the transfer set. If rsync updates a file that has extra hard\-link |
980 +the transfer set. If rsync updates a file that has extra hard-link |
966 +the transfer set. If rsync updates a file that has extra hard-link |
981 connections to files outside the transfer, that linkage will be broken. If |
967 connections to files outside the transfer, that linkage will be broken. If |
982 you are tempted to use the \fB\-\-inplace\fP option to avoid this breakage, be |
968 you are tempted to use the \fB\-\-inplace\fP option to avoid this breakage, be |
983 very careful that you know how your files are being updated so that you are |
969 very careful that you know how your files are being updated so that you are |
984 @@ -1031,12 +982,9 @@ |
970 @@ -1051,11 +1056,11 @@ |
985 see the \fB\-\-inplace\fP option for more caveats). |
971 see the \fB\-\-inplace\fP option for more caveats). |
986 .IP |
972 .IP |
987 If incremental recursion is active (see \fB\-\-recursive\fP), rsync may transfer |
973 If incremental recursion is active (see \fB\-\-recursive\fP), rsync may transfer |
988 -a missing hard\-linked file before it finds that another link for that contents |
974 -a missing hard\-linked file before it finds that another link for that contents |
989 +a missing hard-linked file before it finds that another link for that contents |
975 +a missing hard-linked file before it finds that another link for that contents |
990 exists elsewhere in the hierarchy. This does not affect the accuracy of |
976 exists elsewhere in the hierarchy. This does not affect the accuracy of |
991 -the transfer (i.e. which files are hard\-linked together), just its efficiency |
977 -the transfer (i.e. which files are hard\-linked together), just its efficiency |
992 -(i.e. copying the data for a new, early copy of a hard\-linked file that could |
978 -(i.e. copying the data for a new, early copy of a hard\-linked file that could |
993 -have been found later in the transfer in another member of the hard\-linked |
979 -have been found later in the transfer in another member of the hard\-linked |
994 -set of files). One way to avoid this inefficiency is to disable |
980 +the transfer (i.e. which files are hard-linked together), just its efficiency |
995 +the transfer, just its efficiency. One way to avoid this is to disable |
981 +(i.e. copying the data for a new, early copy of a hard-linked file that could |
|
982 +have been found later in the transfer in another member of the hard-linked |
|
983 set of files). One way to avoid this inefficiency is to disable |
996 incremental recursion using the \fB\-\-no\-inc\-recursive\fP option. |
984 incremental recursion using the \fB\-\-no\-inc\-recursive\fP option. |
997 .IP |
985 .IP |
998 .IP "\fB\-p, \-\-perms\fP" |
986 @@ -1073,24 +1078,24 @@ |
999 @@ -1053,10 +1001,10 @@ |
|
1000 permissions, though the \fB\-\-executability\fP option might change just |
987 permissions, though the \fB\-\-executability\fP option might change just |
1001 the execute permission for the file. |
988 the execute permission for the file. |
1002 .IP o |
989 .IP o |
1003 -New files get their \(dq\&normal\(dq\& permission bits set to the source |
990 -New files get their \(dq\&normal\(dq\& permission bits set to the source |
1004 -file\(cq\&s permissions masked with the receiving directory\(cq\&s default |
991 -file\(cq\&s permissions masked with the receiving directory\(cq\&s default |
1074 +To make a file executable, rsync turns on each \(oqx\(cq permission that |
1060 +To make a file executable, rsync turns on each \(oqx\(cq permission that |
1075 +has a corresponding \(oqr\(cq permission enabled. |
1061 +has a corresponding \(oqr\(cq permission enabled. |
1076 .RE |
1062 .RE |
1077 |
1063 |
1078 .IP |
1064 .IP |
1079 @@ -1130,35 +1078,28 @@ |
1065 @@ -1153,32 +1158,32 @@ |
1080 and restore ACLs that are not compatible. |
1066 This option causes rsync to update the destination |
1081 .IP |
1067 extended attributes to be the same as the source ones. |
1082 .IP "\fB\-X, \-\-xattrs\fP" |
|
1083 -This option causes rsync to update the destination |
|
1084 -extended attributes to be the same as the source ones. |
|
1085 +This option causes rsync to update the remote |
|
1086 +extended attributes to be the same as the local ones. |
|
1087 .IP |
1068 .IP |
1088 -For systems that support extended\-attribute namespaces, a copy being done by a |
1069 -For systems that support extended\-attribute namespaces, a copy being done by a |
1089 -super\-user copies all namespaces except system.*. A normal user only copies |
1070 -super\-user copies all namespaces except system.*. A normal user only copies |
1090 -the user.* namespace. To be able to backup and restore non\-user namespaces as |
1071 -the user.* namespace. To be able to backup and restore non\-user namespaces as |
1091 +For systems that support extended-attribute namespaces, a copy being done by a |
1072 +For systems that support extended-attribute namespaces, a copy being done by a |
1092 +super-user copies all namespaces except system.*. A normal user only copies |
1073 +super-user copies all namespaces except system.*. A normal user only copies |
1093 +the user.* namespace. To be able to backup and restore non-user namespaces as |
1074 +the user.* namespace. To be able to backup and restore non-user namespaces as |
1094 a normal user, see the \fB\-\-fake\-super\fP option. |
1075 a normal user, see the \fB\-\-fake\-super\fP option. |
1095 .IP |
1076 .IP |
1096 -Note that this option does not copy rsyncs special xattr values (e.g. those |
1077 Note that this option does not copy rsyncs special xattr values (e.g. those |
1097 -used by \fB\-\-fake\-super\fP) unless you repeat the option (e.g. \-XX). This |
1078 used by \fB\-\-fake\-super\fP) unless you repeat the option (e.g. \-XX). This |
1098 -\(dq\© all xattrs\(dq\& mode cannot be used with \fB\-\-fake\-super\fP. |
1079 -\(dq\© all xattrs\(dq\& mode cannot be used with \fB\-\-fake\-super\fP. |
1099 -.IP |
1080 +\(lqcopy all xattrs\(rq mode cannot be used with \fB\-\-fake\-super\fP. |
|
1081 .IP |
1100 .IP "\fB\-\-chmod\fP" |
1082 .IP "\fB\-\-chmod\fP" |
1101 This option tells rsync to apply one or more |
1083 This option tells rsync to apply one or more |
1102 -comma\-separated \(dq\&chmod\(dq\& strings to the permission of the files in the |
1084 -comma\-separated \(dq\&chmod\(dq\& modes to the permission of the files in the |
1103 -transfer. The resulting value is treated as though it were the permissions |
1085 +comma-separated \(lqchmod\(rq modes to the permission of the files in the |
1104 +comma-separated \(lqchmod\(rq strings to the permission of the files in the |
1086 transfer. The resulting value is treated as though it were the permissions |
1105 +transfer. The resulting value is treated as though it was the permissions |
|
1106 that the sending side supplied for the file, which means that this option |
1087 that the sending side supplied for the file, which means that this option |
1107 can seem to have no effect on existing files if \fB\-\-perms\fP is not enabled. |
1088 can seem to have no effect on existing files if \fB\-\-perms\fP is not enabled. |
1108 .IP |
1089 .IP |
1109 In addition to the normal parsing rules specified in the \fBchmod\fP(1) |
1090 In addition to the normal parsing rules specified in the \fBchmod\fP(1) |
1110 manpage, you can specify an item that should only apply to a directory by |
1091 manpage, you can specify an item that should only apply to a directory by |
1111 -prefixing it with a \(cq\&D\(cq\&, or specify an item that should only apply to a |
1092 -prefixing it with a \(cq\&D\(cq\&, or specify an item that should only apply to a |
1112 -file by prefixing it with a \(cq\&F\(cq\&. For example, the following will ensure |
1093 -file by prefixing it with a \(cq\&F\(cq\&. For example, the following will ensure |
1113 -that all directories get marked set\-gid, that no files are other\-writable, |
1094 -that all directories get marked set\-gid, that no files are other\-writable, |
1114 -that both are user\-writable and group\-writable, and that both have |
1095 -that both are user\-writable and group\-writable, and that both have |
1115 -consistent executability across all bits: |
1096 +prefixing it with a 'D', or specify an item that should only apply to a |
1116 +prefixing it with a \(oqD\(cq, or specify an item that should only apply to a |
1097 +file by prefixing it with a 'F'. For example, the following will ensure |
1117 +file by prefixing it with a \(oqF\(cq. For example: |
1098 +that all directories get marked set-gid, that no files are other-writable, |
|
1099 +that both are user\-writable and group-writable, and that both have |
|
1100 consistent executability across all bits: |
1118 .IP |
1101 .IP |
1119 .RS |
1102 .RS |
1120 -\-\-chmod=Dg+s,ug+w,Fo\-w,+X |
1103 -\-\-chmod=Dg+s,ug+w,Fo\-w,+X |
1121 +\-\-chmod=Dg+s,ug+w,Fo-w,+X |
1104 +\-\-chmod=Dg+s,ug+w,Fo-w,+X |
1122 .RE |
1105 .RE |
1123 |
1106 |
1124 .IP |
1107 .IP |
1125 @@ -1171,7 +1112,7 @@ |
1108 @@ -1191,7 +1196,7 @@ |
1126 .IP "\fB\-o, \-\-owner\fP" |
1109 .IP "\fB\-o, \-\-owner\fP" |
1127 This option causes rsync to set the owner of the |
1110 This option causes rsync to set the owner of the |
1128 destination file to be the same as the source file, but only if the |
1111 destination file to be the same as the source file, but only if the |
1129 -receiving rsync is being run as the super\-user (see also the \fB\-\-super\fP |
1112 -receiving rsync is being run as the super\-user (see also the \fB\-\-super\fP |
1130 +receiving rsync is being run as the super-user (see also the \fB\-\-super\fP |
1113 +receiving rsync is being run as the super-user (see also the \fB\-\-super\fP |
1131 and \fB\-\-fake\-super\fP options). |
1114 and \fB\-\-fake\-super\fP options). |
1132 Without this option, the owner of new and/or transferred files are set to |
1115 Without this option, the owner of new and/or transferred files are set to |
1133 the invoking user on the receiving side. |
1116 the invoking user on the receiving side. |
1134 @@ -1183,7 +1124,7 @@ |
1117 @@ -1203,7 +1208,7 @@ |
1135 .IP "\fB\-g, \-\-group\fP" |
1118 .IP "\fB\-g, \-\-group\fP" |
1136 This option causes rsync to set the group of the |
1119 This option causes rsync to set the group of the |
1137 destination file to be the same as the source file. If the receiving |
1120 destination file to be the same as the source file. If the receiving |
1138 -program is not running as the super\-user (or if \fB\-\-no\-super\fP was |
1121 -program is not running as the super\-user (or if \fB\-\-no\-super\fP was |
1139 +program is not running as the super-user (or if \fB\-\-no\-super\fP was |
1122 +program is not running as the super-user (or if \fB\-\-no\-super\fP was |
1140 specified), only groups that the invoking user on the receiving side |
1123 specified), only groups that the invoking user on the receiving side |
1141 is a member of will be preserved. |
1124 is a member of will be preserved. |
1142 Without this option, the group is set to the default group of the invoking |
1125 Without this option, the group is set to the default group of the invoking |
1143 @@ -1197,7 +1138,7 @@ |
1126 @@ -1217,7 +1222,7 @@ |
1144 This option causes rsync to transfer character and |
1127 This option causes rsync to transfer character and |
1145 block device files to the remote system to recreate these devices. |
1128 block device files to the remote system to recreate these devices. |
1146 This option has no effect if the receiving rsync is not run as the |
1129 This option has no effect if the receiving rsync is not run as the |
1147 -super\-user (see also the \fB\-\-super\fP and \fB\-\-fake\-super\fP options). |
1130 -super\-user (see also the \fB\-\-super\fP and \fB\-\-fake\-super\fP options). |
1148 +super-user (see also the \fB\-\-super\fP and \fB\-\-fake\-super\fP options). |
1131 +super-user (see also the \fB\-\-super\fP and \fB\-\-fake\-super\fP options). |
1149 .IP |
1132 .IP |
1150 .IP "\fB\-\-specials\fP" |
1133 .IP "\fB\-\-specials\fP" |
1151 This option causes rsync to transfer special files |
1134 This option causes rsync to transfer special files |
1152 @@ -1212,8 +1153,8 @@ |
1135 @@ -1232,8 +1237,8 @@ |
1153 option is not used, the optimization that excludes files that have not been |
1136 option is not used, the optimization that excludes files that have not been |
1154 modified cannot be effective; in other words, a missing \fB\-t\fP or \fB\-a\fP will |
1137 modified cannot be effective; in other words, a missing \fB\-t\fP or \fB\-a\fP will |
1155 cause the next transfer to behave as if it used \fB\-I\fP, causing all files to be |
1138 cause the next transfer to behave as if it used \fB\-I\fP, causing all files to be |
1156 -updated (though rsync\(cq\&s delta\-transfer algorithm will make the update fairly efficient |
1139 -updated (though rsync\(cq\&s delta\-transfer algorithm will make the update fairly efficient |
1157 -if the files haven\(cq\&t actually changed, you\(cq\&re much better off using \fB\-t\fP). |
1140 -if the files haven\(cq\&t actually changed, you\(cq\&re much better off using \fB\-t\fP). |
1158 +updated (though rsync's delta-transfer algorithm will make the update fairly efficient |
1141 +updated (though rsync's delta-transfer algorithm will make the update fairly efficient |
1159 +if the files haven't actually changed, you're much better off using \fB\-t\fP). |
1142 +if the files haven't actually changed, you're much better off using \fB\-t\fP). |
1160 .IP |
1143 .IP |
1161 .IP "\fB\-O, \-\-omit\-dir\-times\fP" |
1144 .IP "\fB\-O, \-\-omit\-dir\-times\fP" |
1162 This tells rsync to omit directories when |
1145 This tells rsync to omit directories when |
1163 @@ -1222,58 +1163,62 @@ |
1146 @@ -1242,58 +1247,58 @@ |
1164 This option is inferred if you use \fB\-\-backup\fP without \fB\-\-backup\-dir\fP. |
1147 This option is inferred if you use \fB\-\-backup\fP without \fB\-\-backup\-dir\fP. |
1165 .IP |
1148 .IP |
1166 .IP "\fB\-\-super\fP" |
1149 .IP "\fB\-\-super\fP" |
1167 -This tells the receiving side to attempt super\-user |
1150 -This tells the receiving side to attempt super\-user |
1168 -activities even if the receiving rsync wasn\(cq\&t run by the super\-user. These |
1151 -activities even if the receiving rsync wasn\(cq\&t run by the super\-user. These |
1233 Try to handle sparse files efficiently so they take |
1216 Try to handle sparse files efficiently so they take |
1234 -up less space on the destination. Conflicts with \fB\-\-inplace\fP because it\(cq\&s |
1217 -up less space on the destination. Conflicts with \fB\-\-inplace\fP because it\(cq\&s |
1235 +up less space on the destination. Conflicts with \fB\-\-inplace\fP because it's |
1218 +up less space on the destination. Conflicts with \fB\-\-inplace\fP because it's |
1236 not possible to overwrite data in a sparse fashion. |
1219 not possible to overwrite data in a sparse fashion. |
1237 .IP |
1220 .IP |
1238 +NOTE: Don't use this option when the destination is a Solaris \(lqtmpfs\(rq |
|
1239 +filesystem. It doesn't seem to handle seeks over null regions |
|
1240 +correctly and ends up corrupting the files. |
|
1241 +.IP |
|
1242 .IP "\fB\-n, \-\-dry\-run\fP" |
1221 .IP "\fB\-n, \-\-dry\-run\fP" |
1243 -This makes rsync perform a trial run that doesn\(cq\&t |
1222 -This makes rsync perform a trial run that doesn\(cq\&t |
1244 +This makes rsync perform a trial run that doesn't |
1223 +This makes rsync perform a trial run that doesn't |
1245 make any changes (and produces mostly the same output as a real run). It |
1224 make any changes (and produces mostly the same output as a real run). It |
1246 is most commonly used in combination with the \fB\-v, \-\-verbose\fP and/or |
1225 is most commonly used in combination with the \fB\-v, \-\-verbose\fP and/or |
1247 \fB\-i, \-\-itemize\-changes\fP options to see what an rsync command is going |
1226 \fB\-i, \-\-itemize\-changes\fP options to see what an rsync command is going |
1248 @@ -1281,39 +1226,38 @@ |
1227 @@ -1301,50 +1306,50 @@ |
1249 .IP |
1228 .IP |
1250 The output of \fB\-\-itemize\-changes\fP is supposed to be exactly the same on a |
1229 The output of \fB\-\-itemize\-changes\fP is supposed to be exactly the same on a |
1251 dry run and a subsequent real run (barring intentional trickery and system |
1230 dry run and a subsequent real run (barring intentional trickery and system |
1252 -call failures); if it isn\(cq\&t, that\(cq\&s a bug. Other output should be mostly |
1231 -call failures); if it isn\(cq\&t, that\(cq\&s a bug. Other output should be mostly |
1253 -unchanged, but may differ in some areas. Notably, a dry run does not |
1232 +call failures); if it isn't, that's a bug. Other output should be mostly |
1254 +call failures); if it isn't, that's a bug. Other output is the same to the |
1233 unchanged, but may differ in some areas. Notably, a dry run does not |
1255 +extent practical, but may differ in some areas. Notably, a dry run does not |
|
1256 send the actual data for file transfers, so \fB\-\-progress\fP has no effect, |
1234 send the actual data for file transfers, so \fB\-\-progress\fP has no effect, |
1257 -the \(dq\&bytes sent\(dq\&, \(dq\&bytes received\(dq\&, \(dq\&literal data\(dq\&, and \(dq\&matched data\(dq\& |
1235 -the \(dq\&bytes sent\(dq\&, \(dq\&bytes received\(dq\&, \(dq\&literal data\(dq\&, and \(dq\&matched data\(dq\& |
1258 -statistics are too small, and the \(dq\&speedup\(dq\& value is equivalent to a run |
1236 -statistics are too small, and the \(dq\&speedup\(dq\& value is equivalent to a run |
1259 -where no file transfers were needed. |
|
1260 +the \(lqbytes sent\(rq, \(lqbytes received\(rq, \(lqliteral data\(rq, and \(lqmatched data\(rq |
1237 +the \(lqbytes sent\(rq, \(lqbytes received\(rq, \(lqliteral data\(rq, and \(lqmatched data\(rq |
1261 +statistics are too small, and the \(lqspeedup\(rq value is equivalent to a run |
1238 +statistics are too small, and the \(lqspeedup\(rq value is equivalent to a run |
1262 +where no file transfers are needed. |
1239 where no file transfers were needed. |
1263 .IP |
1240 .IP |
1264 .IP "\fB\-W, \-\-whole\-file\fP" |
1241 .IP "\fB\-W, \-\-whole\-file\fP" |
1265 -With this option rsync\(cq\&s delta\-transfer algorithm |
1242 -With this option rsync\(cq\&s delta\-transfer algorithm |
1266 -is not used and the whole file is sent as\-is instead. The transfer may be |
1243 -is not used and the whole file is sent as\-is instead. The transfer may be |
1267 +With this option rsync's delta-transfer algorithm |
1244 +With this option rsync's delta-transfer algorithm |
1268 +is not used and the whole file is sent as-is instead. The transfer may be |
1245 +is not used and the whole file is sent as-is instead. The transfer may be |
1269 faster if this option is used when the bandwidth between the source and |
1246 faster if this option is used when the bandwidth between the source and |
1270 destination machines is higher than the bandwidth to disk (especially when the |
1247 destination machines is higher than the bandwidth to disk (especially when the |
1271 -\(dq\&disk\(dq\& is actually a networked filesystem). This is the default when both |
1248 -\(dq\&disk\(dq\& is actually a networked filesystem). This is the default when both |
1272 -the source and destination are specified as local paths, but only if no |
1249 +\(lqdisk\(rq is actually a networked filesystem). This is the default when both |
|
1250 the source and destination are specified as local paths, but only if no |
1273 -batch\-writing option is in effect. |
1251 -batch\-writing option is in effect. |
1274 +\(lqdisk\(rq is actually a networked filesystem). This is the default when both |
1252 +batch-writing option is in effect. |
1275 +the source and destination are specified as local paths. |
|
1276 .IP |
1253 .IP |
1277 .IP "\fB\-x, \-\-one\-file\-system\fP" |
1254 .IP "\fB\-x, \-\-one\-file\-system\fP" |
1278 This tells rsync to avoid crossing a |
1255 This tells rsync to avoid crossing a |
1279 -filesystem boundary when recursing. This does not limit the user\(cq\&s ability |
1256 -filesystem boundary when recursing. This does not limit the user\(cq\&s ability |
1280 -to specify items to copy from multiple filesystems, just rsync\(cq\&s recursion |
1257 -to specify items to copy from multiple filesystems, just rsync\(cq\&s recursion |
1298 \fB\-\-copy\-unsafe\-links\fP), a symlink to a directory on another device is |
1275 \fB\-\-copy\-unsafe\-links\fP), a symlink to a directory on another device is |
1299 -treated like a mount\-point. Symlinks to non\-directories are unaffected |
1276 -treated like a mount\-point. Symlinks to non\-directories are unaffected |
1300 +treated like a mount-point. Symlinks to non-directories are unaffected |
1277 +treated like a mount-point. Symlinks to non-directories are unaffected |
1301 by this option. |
1278 by this option. |
1302 .IP |
1279 .IP |
1303 .IP "\fB\-\-existing, \-\-ignore\-non\-existing\fP" |
1280 -.IP "\fB\-\-existing, \-\-ignore\-non\-existing\fP" |
1304 @@ -1323,8 +1267,8 @@ |
1281 +.IP "\fB\-\-existing, \-\-ignore-non-existing\fP" |
|
1282 This tells rsync to skip |
|
1283 creating files (including directories) that do not exist |
|
1284 yet on the destination. If this option is |
1305 combined with the \fB\-\-ignore\-existing\fP option, no files will be updated |
1285 combined with the \fB\-\-ignore\-existing\fP option, no files will be updated |
1306 (which can be useful if all you want to do is delete extraneous files). |
1286 (which can be useful if all you want to do is delete extraneous files). |
1307 .IP |
1287 .IP |
1308 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
1288 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
1309 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
1289 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
1310 +This option is a transfer rule, not an exclude, so it doesn't affect the |
1290 +This option is a transfer rule, not an exclude, so it doesn't affect the |
1311 +data that goes into the file-lists, and thus it doesn't affect deletions. |
1291 +data that goes into the file-lists, and thus it doesn't affect deletions. |
1312 It just limits the files that the receiver requests to be transferred. |
1292 It just limits the files that the receiver requests to be transferred. |
1313 .IP |
1293 .IP |
1314 .IP "\fB\-\-ignore\-existing\fP" |
1294 .IP "\fB\-\-ignore\-existing\fP" |
1315 @@ -1332,8 +1276,8 @@ |
1295 @@ -1352,41 +1357,41 @@ |
1316 already exist on the destination (this does \fInot\fP ignore existing |
1296 already exist on the destination (this does \fInot\fP ignore existing |
1317 directories, or nothing would get done). See also \fB\-\-existing\fP. |
1297 directories, or nothing would get done). See also \fB\-\-existing\fP. |
1318 .IP |
1298 .IP |
1319 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
1299 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
1320 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
1300 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
1321 +This option is a transfer rule, not an exclude, so it doesn't affect the |
1301 +This option is a transfer rule, not an exclude, so it doesn't affect the |
1322 +data that goes into the file-lists, and thus it doesn't affect deletions. |
1302 +data that goes into the file-lists, and thus it doesn't affect deletions. |
1323 It just limits the files that the receiver requests to be transferred. |
1303 It just limits the files that the receiver requests to be transferred. |
1324 .IP |
1304 .IP |
1325 This option can be useful for those doing backups using the \fB\-\-link\-dest\fP |
1305 This option can be useful for those doing backups using the \fB\-\-link\-dest\fP |
1326 @@ -1340,23 +1284,23 @@ |
|
1327 option when they need to continue a backup run that got interrupted. Since |
1306 option when they need to continue a backup run that got interrupted. Since |
1328 a \fB\-\-link\-dest\fP run is copied into a new directory hierarchy (when it is |
1307 a \fB\-\-link\-dest\fP run is copied into a new directory hierarchy (when it is |
1329 used properly), using \fB\-\-ignore existing\fP will ensure that the |
1308 used properly), using \fB\-\-ignore existing\fP will ensure that the |
1330 -already\-handled files don\(cq\&t get tweaked (which avoids a change in |
1309 -already\-handled files don\(cq\&t get tweaked (which avoids a change in |
1331 -permissions on the hard\-linked files). This does mean that this option |
|
1332 +already-handled files don't get tweaked (which avoids a change in |
1310 +already-handled files don't get tweaked (which avoids a change in |
1333 +permissions on the hard-linked files). This does mean that this option |
1311 permissions on the hard\-linked files). This does mean that this option |
1334 is only looking at the existing files in the destination hierarchy itself. |
1312 is only looking at the existing files in the destination hierarchy itself. |
1335 .IP |
1313 .IP |
1336 .IP "\fB\-\-remove\-source\-files\fP" |
1314 .IP "\fB\-\-remove\-source\-files\fP" |
1337 This tells rsync to remove from the sending |
1315 This tells rsync to remove from the sending |
1338 -side the files (meaning non\-directories) that are a part of the transfer |
1316 -side the files (meaning non\-directories) that are a part of the transfer |
1339 +side the files (meaning non-directories) that are a part of the transfer |
1317 +side the files (meaning non-directories) that are a part of the transfer |
1340 and have been successfully duplicated on the receiving side. |
1318 and have been successfully duplicated on the receiving side. |
|
1319 .IP |
|
1320 Note that you should only use this option on source files that are quiescent. |
|
1321 If you are using this to move files that show up in a particular directory over |
|
1322 to another host, make sure that the finished files get renamed into the source |
|
1323 -directory, not directly written into it, so that rsync can\(cq\&t possibly transfer |
|
1324 -a file that is not yet fully written. If you can\(cq\&t first write the files into |
|
1325 +directory, not directly written into it, so that rsync can't possibly transfer |
|
1326 +a file that is not yet fully written. If you can't first write the files into |
|
1327 a different directory, you should use a naming idiom that lets rsync avoid |
|
1328 -transferring files that are not yet finished (e.g. name the file \(dq\&foo.new\(dq\& when |
|
1329 -it is written, rename it to \(dq\&foo\(dq\& when it is done, and then use the option |
|
1330 +transferring files that are not yet finished (e.g. name the file \(lqfoo.new\(rq when |
|
1331 +it is written, rename it to \(lqfoo\(rq when it is done, and then use the option |
|
1332 \fB\-\-exclude='\&*.new'\&\fP for the rsync transfer). |
1341 .IP |
1333 .IP |
1342 .IP "\fB\-\-delete\fP" |
1334 .IP "\fB\-\-delete\fP" |
1343 This tells rsync to delete extraneous files from the |
1335 This tells rsync to delete extraneous files from the |
1344 -receiving side (ones that aren\(cq\&t on the sending side), but only for the |
1336 -receiving side (ones that aren\(cq\&t on the sending side), but only for the |
1345 +receiving side (ones that aren't on the sending side), but only for the |
1337 +receiving side (ones that aren't on the sending side), but only for the |
1491 +\(lqMB\(rq, or \(lqGB\(rq. (Note: lower-case is also accepted for all values.) |
1473 +\(lqMB\(rq, or \(lqGB\(rq. (Note: lower-case is also accepted for all values.) |
1492 +Finally, if the suffix ends in either \(lq+1\(rq or \(lq\-1\(rq, the value will |
1474 +Finally, if the suffix ends in either \(lq+1\(rq or \(lq\-1\(rq, the value will |
1493 be offset by one byte in the indicated direction. |
1475 be offset by one byte in the indicated direction. |
1494 .IP |
1476 .IP |
1495 Examples: \-\-max\-size=1.5mb\-1 is 1499999 bytes, and \-\-max\-size=2g+1 is |
1477 Examples: \-\-max\-size=1.5mb\-1 is 1499999 bytes, and \-\-max\-size=2g+1 is |
1496 @@ -1492,7 +1436,7 @@ |
1478 @@ -1522,7 +1527,7 @@ |
1497 .IP |
1479 .IP |
1498 .IP "\fB\-B, \-\-block\-size=BLOCKSIZE\fP" |
1480 .IP "\fB\-B, \-\-block\-size=BLOCKSIZE\fP" |
1499 This forces the block size used in |
1481 This forces the block size used in |
1500 -rsync\(cq\&s delta\-transfer algorithm to a fixed value. It is normally selected based on |
1482 -rsync\(cq\&s delta\-transfer algorithm to a fixed value. It is normally selected based on |
1501 +rsync's delta-transfer algorithm to a fixed value. It is normally selected based on |
1483 +rsync's delta-transfer algorithm to a fixed value. It is normally selected based on |
1502 the size of each file being updated. See the technical report for details. |
1484 the size of each file being updated. See the technical report for details. |
1503 .IP |
1485 .IP |
1504 .IP "\fB\-e, \-\-rsh=COMMAND\fP" |
1486 .IP "\fB\-e, \-\-rsh=COMMAND\fP" |
1505 @@ -1505,27 +1449,27 @@ |
1487 @@ -1535,27 +1540,27 @@ |
1506 remote shell \fICOMMAND\fP will be used to run an rsync daemon on the |
1488 remote shell \fICOMMAND\fP will be used to run an rsync daemon on the |
1507 remote host, and all data will be transmitted through that remote |
1489 remote host, and all data will be transmitted through that remote |
1508 shell connection, rather than through a direct socket connection to a |
1490 shell connection, rather than through a direct socket connection to a |
1509 -running rsync daemon on the remote host. See the section \(dq\&USING |
1491 -running rsync daemon on the remote host. See the section \(dq\&USING |
1510 -RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& above. |
1492 -RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& above. |
1611 +The first option turns on the per-directory scanning for the .cvsignore |
1585 +The first option turns on the per-directory scanning for the .cvsignore |
1612 +file. The second option does a one-time import of the CVS excludes |
1586 +file. The second option does a one-time import of the CVS excludes |
1613 mentioned above. |
1587 mentioned above. |
1614 .IP |
1588 .IP |
1615 .IP "\fB\-f, \-\-filter=RULE\fP" |
1589 .IP "\fB\-f, \-\-filter=RULE\fP" |
1616 @@ -1607,17 +1551,17 @@ |
1590 @@ -1637,17 +1642,17 @@ |
1617 your command. The first time it is used is a shorthand for this rule: |
1591 your command. The first time it is used is a shorthand for this rule: |
1618 .IP |
1592 .IP |
1619 .RS |
1593 .RS |
1620 -\f(CW \-\-filter='\&dir\-merge /.rsync\-filter'\&\fP |
1594 -\f(CW \-\-filter='\&dir\-merge /.rsync\-filter'\&\fP |
1621 +\f(CW \-\-filter='dir\-merge /.rsync\-filter'\fP |
1595 +\f(CW \-\-filter='dir\-merge /.rsync\-filter'\fP |
1622 .RE |
1596 .RE |
1623 |
1597 |
1624 .IP |
1598 .IP |
1625 -This tells rsync to look for per\-directory .rsync\-filter files that have |
1599 -This tells rsync to look for per\-directory .rsync\-filter files that have |
1626 +This tells rsync to look for per-directory .rsync\-filter files that have |
1600 +This tells rsync to look for per-directory .rsync-filter files that have |
1627 been sprinkled through the hierarchy and use their rules to filter the |
1601 been sprinkled through the hierarchy and use their rules to filter the |
1628 files in the transfer. If \fB\-F\fP is repeated, it is a shorthand for this |
1602 files in the transfer. If \fB\-F\fP is repeated, it is a shorthand for this |
1629 rule: |
1603 rule: |
1630 .IP |
1604 .IP |
1631 .RS |
1605 .RS |
1632 -\f(CW \-\-filter='\&exclude .rsync\-filter'\&\fP |
1606 -\f(CW \-\-filter='\&exclude .rsync\-filter'\&\fP |
1633 +\f(CW \-\-filter='exclude .rsync\-filter'\fP |
1607 +\f(CW \-\-filter='exclude .rsync\-filter'\fP |
1634 .RE |
1608 .RE |
1635 |
1609 |
1636 .IP |
1610 .IP |
1637 @@ -1629,7 +1573,7 @@ |
1611 @@ -1659,27 +1664,27 @@ |
1638 .IP "\fB\-\-exclude=PATTERN\fP" |
1612 .IP "\fB\-\-exclude=PATTERN\fP" |
1639 This option is a simplified form of the |
1613 This option is a simplified form of the |
1640 \fB\-\-filter\fP option that defaults to an exclude rule and does not allow |
1614 \fB\-\-filter\fP option that defaults to an exclude rule and does not allow |
1641 -the full rule\-parsing syntax of normal filter rules. |
1615 -the full rule\-parsing syntax of normal filter rules. |
1642 +the full rule-parsing syntax of normal filter rules. |
1616 +the full rule-parsing syntax of normal filter rules. |
1643 .IP |
1617 .IP |
1644 See the FILTER RULES section for detailed information on this option. |
1618 See the FILTER RULES section for detailed information on this option. |
1645 .IP |
1619 .IP |
1646 @@ -1636,13 +1580,13 @@ |
|
1647 .IP "\fB\-\-exclude\-from=FILE\fP" |
1620 .IP "\fB\-\-exclude\-from=FILE\fP" |
1648 This option is related to the \fB\-\-exclude\fP |
1621 This option is related to the \fB\-\-exclude\fP |
1649 option, but it specifies a FILE that contains exclude patterns (one per line). |
1622 option, but it specifies a FILE that contains exclude patterns (one per line). |
1650 -Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1623 -Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1651 +Blank lines in the file and lines starting with \(oq;\(cq or \(oq#\(cq are ignored. |
1624 +Blank lines in the file and lines starting with \(oq;\(cq or \(oq#\(cq are ignored. |
1724 +(the host must match one end of the transfer). As a short-cut, you can |
1695 +(the host must match one end of the transfer). As a short-cut, you can |
1725 +specify just a prefix of \(lq:\(rq to mean \(lquse the remote end of the |
1696 +specify just a prefix of \(lq:\(rq to mean \(lquse the remote end of the |
1726 +transfer\(rq. For example: |
1697 +transfer\(rq. For example: |
1727 .IP |
1698 .IP |
1728 .RS |
1699 .RS |
1729 \f(CW rsync \-a \-\-files\-from=:/path/file\-list src:/ /tmp/copy\fP |
1700 -\f(CW rsync \-a \-\-files\-from=:/path/file\-list src:/ /tmp/copy\fP |
1730 @@ -1712,39 +1656,32 @@ |
1701 +\f(CW rsync \-a \-\-files\-from=:/path/file-list src:/ /tmp/copy\fP |
1731 .RE |
1702 .RE |
1732 |
1703 |
1733 .IP |
1704 .IP |
1734 -This would copy all the files specified in the /path/file\-list file that |
1705 -This would copy all the files specified in the /path/file\-list file that |
1735 -was located on the remote \(dq\&src\(dq\& host. |
1706 -was located on the remote \(dq\&src\(dq\& host. |
1736 +This would copy all the files specified in the /path/file-list file that |
1707 +This would copy all the files specified in the /path/file-list file that |
1737 +was located on the remote \(lqsrc\(rq host. |
1708 +was located on the remote \(lqsrc\(rq host. |
1738 .IP |
1709 .IP |
1739 -If the \fB\-\-iconv\fP and \fB\-\-protect\-args\fP options are specified and the |
1710 If the \fB\-\-iconv\fP and \fB\-\-protect\-args\fP options are specified and the |
1740 -\fB\-\-files\-from\fP filenames are being sent from one host to another, the |
1711 \fB\-\-files\-from\fP filenames are being sent from one host to another, the |
1741 -filenames will be translated from the sending host\(cq\&s charset to the |
1712 -filenames will be translated from the sending host\(cq\&s charset to the |
1742 -receiving host\(cq\&s charset. |
1713 -receiving host\(cq\&s charset. |
1743 -.IP |
1714 +filenames will be translated from the sending host's charset to the |
1744 -NOTE: sorting the list of files in the \-\-files\-from input helps rsync to be |
1715 +receiving host's charset. |
1745 -more efficient, as it will avoid re\-visiting the path elements that are shared |
1716 .IP |
1746 -between adjacent entries. If the input is not sorted, some path elements |
1717 NOTE: sorting the list of files in the \-\-files\-from input helps rsync to be |
1747 -(implied directories) may end up being scanned multiple times, and rsync will |
1718 more efficient, as it will avoid re\-visiting the path elements that are shared |
|
1719 between adjacent entries. If the input is not sorted, some path elements |
|
1720 (implied directories) may end up being scanned multiple times, and rsync will |
1748 -eventually unduplicate them after they get turned into file\-list elements. |
1721 -eventually unduplicate them after they get turned into file\-list elements. |
1749 -.IP |
1722 +eventually unduplicate them after they get turned into file-list elements. |
|
1723 .IP |
1750 .IP "\fB\-0, \-\-from0\fP" |
1724 .IP "\fB\-0, \-\-from0\fP" |
1751 This tells rsync that the rules/filenames it reads from a |
1725 This tells rsync that the rules/filenames it reads from a |
1752 -file are terminated by a null (\(cq\&\e0\(cq\&) character, not a NL, CR, or CR+LF. |
1726 -file are terminated by a null (\(cq\&\e0\(cq\&) character, not a NL, CR, or CR+LF. |
1753 +file are terminated by a null ('\e0') character, not a NL, CR, or CR+LF. |
1727 +file are terminated by a null ('\e0') character, not a NL, CR, or CR+LF. |
1754 This affects \fB\-\-exclude\-from\fP, \fB\-\-include\-from\fP, \fB\-\-files\-from\fP, and any |
1728 This affects \fB\-\-exclude\-from\fP, \fB\-\-include\-from\fP, \fB\-\-files\-from\fP, and any |
1755 merged files specified in a \fB\-\-filter\fP rule. |
1729 merged files specified in a \fB\-\-filter\fP rule. |
1756 It does not affect \fB\-\-cvs\-exclude\fP (since all names read from a .cvsignore |
1730 It does not affect \fB\-\-cvs\-exclude\fP (since all names read from a .cvsignore |
1757 file are split on whitespace). |
1731 @@ -1767,14 +1772,14 @@ |
1758 .IP |
|
1759 +If the \fB\-\-iconv\fP and \fB\-\-protect\-args\fP options are specified and the |
|
1760 +\fB\-\-files\-from\fP filenames are being sent from one host to another, the |
|
1761 +filenames will be translated from the sending host's charset to the |
|
1762 +receiving host's charset. |
|
1763 +.IP |
|
1764 .IP "\fB\-s, \-\-protect\-args\fP" |
1732 .IP "\fB\-s, \-\-protect\-args\fP" |
1765 -This option sends all filenames and most options to |
1733 This option sends all filenames and most options to |
1766 +This option sends all filenames and some options to |
|
1767 the remote rsync without allowing the remote shell to interpret them. This |
1734 the remote rsync without allowing the remote shell to interpret them. This |
1768 -means that spaces are not split in names, and any non\-wildcard special |
1735 -means that spaces are not split in names, and any non\-wildcard special |
1769 +means that spaces are not split in names, and any non-wildcard special |
1736 +means that spaces are not split in names, and any non-wildcard special |
1770 characters are not translated (such as ~, $, ;, &, etc.). Wildcards are |
1737 characters are not translated (such as ~, $, ;, &, etc.). Wildcards are |
1771 expanded on the remote host by rsync (instead of the shell doing it). |
1738 expanded on the remote host by rsync (instead of the shell doing it). |
1772 .IP |
1739 .IP |
1773 -If you use this option with \fB\-\-iconv\fP, the args related to the remote |
1740 If you use this option with \fB\-\-iconv\fP, the args related to the remote |
1774 -side will also be translated |
1741 side will also be translated |
1775 -from the local to the remote character\-set. The translation happens before |
1742 -from the local to the remote character\-set. The translation happens before |
1776 -wild\-cards are expanded. See also the \fB\-\-files\-from\fP option. |
1743 -wild\-cards are expanded. See also the \fB\-\-files\-from\fP option. |
1777 +If you use this option with \fB\-\-iconv\fP, the args will also be translated |
|
1778 +from the local to the remote character-set. The translation happens before |
1744 +from the local to the remote character-set. The translation happens before |
1779 +wild-cards are expanded. See also the \fB\-\-files\-from\fP option. |
1745 +wild-cards are expanded. See also the \fB\-\-files\-from\fP option. |
1780 .IP |
1746 .IP |
1781 .IP "\fB\-T, \-\-temp\-dir=DIR\fP" |
1747 .IP "\fB\-T, \-\-temp\-dir=DIR\fP" |
1782 This option instructs rsync to use DIR as a |
1748 This option instructs rsync to use DIR as a |
1783 @@ -1769,25 +1706,25 @@ |
1749 @@ -1799,25 +1804,25 @@ |
1784 If you are using this option for reasons other than a shortage of disk |
1750 If you are using this option for reasons other than a shortage of disk |
1785 space, you may wish to combine it with the \fB\-\-delay\-updates\fP option, |
1751 space, you may wish to combine it with the \fB\-\-delay\-updates\fP option, |
1786 which will ensure that all copied files get put into subdirectories in the |
1752 which will ensure that all copied files get put into subdirectories in the |
1787 -destination hierarchy, awaiting the end of the transfer. If you don\(cq\&t |
1753 -destination hierarchy, awaiting the end of the transfer. If you don\(cq\&t |
1788 +destination hierarchy, awaiting the end of the transfer. If you don't |
1754 +destination hierarchy, awaiting the end of the transfer. If you don't |
1810 -fuzzy\-match files, so either use \fB\-\-delete\-after\fP or specify some |
1776 -fuzzy\-match files, so either use \fB\-\-delete\-after\fP or specify some |
1811 +fuzzy-match files, so either use \fB\-\-delete\-after\fP or specify some |
1777 +fuzzy-match files, so either use \fB\-\-delete\-after\fP or specify some |
1812 filename exclusions if you need to prevent this. |
1778 filename exclusions if you need to prevent this. |
1813 .IP |
1779 .IP |
1814 .IP "\fB\-\-compare\-dest=DIR\fP" |
1780 .IP "\fB\-\-compare\-dest=DIR\fP" |
1815 @@ -1795,7 +1732,7 @@ |
1781 @@ -1825,7 +1830,7 @@ |
1816 the destination machine as an additional hierarchy to compare destination |
1782 the destination machine as an additional hierarchy to compare destination |
1817 files against doing transfers (if the files are missing in the destination |
1783 files against doing transfers (if the files are missing in the destination |
1818 directory). If a file is found in \fIDIR\fP that is identical to the |
1784 directory). If a file is found in \fIDIR\fP that is identical to the |
1819 -sender\(cq\&s file, the file will NOT be transferred to the destination |
1785 -sender\(cq\&s file, the file will NOT be transferred to the destination |
1820 +sender's file, the file will NOT be transferred to the destination |
1786 +sender's file, the file will NOT be transferred to the destination |
1821 directory. This is useful for creating a sparse backup of just files that |
1787 directory. This is useful for creating a sparse backup of just files that |
1822 have changed from an earlier backup. |
1788 have changed from an earlier backup. |
1823 .IP |
1789 .IP |
1824 @@ -1815,7 +1752,7 @@ |
1790 @@ -1845,7 +1850,7 @@ |
1825 rsync will also copy unchanged files found in \fIDIR\fP to the destination |
1791 rsync will also copy unchanged files found in \fIDIR\fP to the destination |
1826 directory using a local copy. |
1792 directory using a local copy. |
1827 This is useful for doing transfers to a new destination while leaving |
1793 This is useful for doing transfers to a new destination while leaving |
1828 -existing files intact, and then doing a flash\-cutover when all files have |
1794 -existing files intact, and then doing a flash\-cutover when all files have |
1829 +existing files intact, and then doing a flash-cutover when all files have |
1795 +existing files intact, and then doing a flash-cutover when all files have |
1830 been successfully transferred. |
1796 been successfully transferred. |
1831 .IP |
1797 .IP |
1832 Multiple \fB\-\-copy\-dest\fP directories may be provided, which will cause |
1798 Multiple \fB\-\-copy\-dest\fP directories may be provided, which will cause |
1833 @@ -1838,10 +1775,10 @@ |
1799 @@ -1868,10 +1873,10 @@ |
1834 .RE |
1800 .RE |
1835 |
1801 |
1836 .IP |
1802 .IP |
1837 -If file\(cq\&s aren\(cq\&t linking, double\-check their attributes. Also check if some |
1803 -If file\(cq\&s aren\(cq\&t linking, double\-check their attributes. Also check if some |
1838 -attributes are getting forced outside of rsync\(cq\&s control, such a mount option |
1804 -attributes are getting forced outside of rsync\(cq\&s control, such a mount option |
1872 -being transmitted \-\- something that is useful over a slow connection. |
1838 -being transmitted \-\- something that is useful over a slow connection. |
1873 +being transmitted \(em something that is useful over a slow connection. |
1839 +being transmitted \(em something that is useful over a slow connection. |
1874 .IP |
1840 .IP |
1875 Note that this option typically achieves better compression ratios than can |
1841 Note that this option typically achieves better compression ratios than can |
1876 be achieved by using a compressing remote shell or a compressing transport |
1842 be achieved by using a compressing remote shell or a compressing transport |
1877 @@ -1885,7 +1822,7 @@ |
1843 @@ -1915,7 +1920,7 @@ |
1878 .IP |
1844 .IP |
1879 .IP "\fB\-\-compress\-level=NUM\fP" |
1845 .IP "\fB\-\-compress\-level=NUM\fP" |
1880 Explicitly set the compression level to use |
1846 Explicitly set the compression level to use |
1881 -(see \fB\-\-compress\fP) instead of letting it default. If NUM is non\-zero, |
1847 -(see \fB\-\-compress\fP) instead of letting it default. If NUM is non\-zero, |
1882 +(see \fB\-\-compress\fP) instead of letting it default. If NUM is non-zero, |
1848 +(see \fB\-\-compress\fP) instead of letting it default. If NUM is non-zero, |
1883 the \fB\-\-compress\fP option is implied. |
1849 the \fB\-\-compress\fP option is implied. |
1884 .IP |
1850 .IP |
1885 .IP "\fB\-\-skip\-compress=LIST\fP" |
1851 .IP "\fB\-\-skip\-compress=LIST\fP" |
1886 @@ -1895,13 +1832,13 @@ |
1852 @@ -1925,13 +1930,13 @@ |
1887 .IP |
1853 .IP |
1888 You may specify an empty string to indicate that no file should be skipped. |
1854 You may specify an empty string to indicate that no file should be skipped. |
1889 .IP |
1855 .IP |
1890 -Simple character\-class matching is supported: each must consist of a list |
1856 -Simple character\-class matching is supported: each must consist of a list |
1891 +Simple character-class matching is supported: each must consist of a list |
1857 +Simple character-class matching is supported: each must consist of a list |
1892 of letters inside the square brackets (e.g. no special classes, such as |
1858 of letters inside the square brackets (e.g. no special classes, such as |
1893 -\(dq\&[:alpha:]\(dq\&, are supported, and \(cq\&\-\(cq\& has no special meaning). |
1859 -\(dq\&[:alpha:]\(dq\&, are supported, and \(cq\&\-\(cq\& has no special meaning). |
1894 +\(lq[:alpha:]\(rq, are supported). |
1860 +\(lq[:alpha:]\(rq, are supported, and '\-' has no special meaning). |
1895 .IP |
1861 .IP |
1896 -The characters asterisk (*) and question\-mark (?) have no special meaning. |
1862 -The characters asterisk (*) and question\-mark (?) have no special meaning. |
1897 +The characters asterisk (*) and question-mark (?) have no special meaning. |
1863 +The characters asterisk (*) and question-mark (?) have no special meaning. |
1898 .IP |
1864 .IP |
1899 -Here\(cq\&s an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1865 -Here\(cq\&s an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1900 +Here's an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1866 +Here's an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1901 matches 2 suffixes): |
1867 matches 2 suffixes): |
1902 .IP |
1868 .IP |
1903 .nf |
1869 .nf |
1904 @@ -1909,30 +1846,17 @@ |
1870 @@ -1962,7 +1967,7 @@ |
1905 .fi |
|
1906 |
|
1907 .IP |
|
1908 -The default list of suffixes that will not be compressed is this (in this |
|
1909 -version of rsync): |
|
1910 +The default list of suffixes that will not be compressed is this (several |
|
1911 +of these are newly added for 3.0.0): |
|
1912 .IP |
|
1913 -\fB7z\fP |
|
1914 -\fBavi\fP |
|
1915 -\fBbz2\fP |
|
1916 -\fBdeb\fP |
|
1917 -\fBgz\fP |
|
1918 -\fBiso\fP |
|
1919 -\fBjpeg\fP |
|
1920 -\fBjpg\fP |
|
1921 -\fBmov\fP |
|
1922 -\fBmp3\fP |
|
1923 -\fBmp4\fP |
|
1924 -\fBogg\fP |
|
1925 -\fBrpm\fP |
|
1926 -\fBtbz\fP |
|
1927 -\fBtgz\fP |
|
1928 -\fBz\fP |
|
1929 -\fBzip\fP |
|
1930 +.nf |
|
1931 + gz/zip/z/rpm/deb/iso/bz2/t[gb]z/7z/mp[34]/mov/avi/ogg/jpg/jpeg |
|
1932 +.fi |
|
1933 + |
|
1934 .IP |
1871 .IP |
1935 This list will be replaced by your \fB\-\-skip\-compress\fP list in all but one |
1872 This list will be replaced by your \fB\-\-skip\-compress\fP list in all but one |
1936 situation: a copy from a daemon rsync will add your skipped suffixes to |
1873 situation: a copy from a daemon rsync will add your skipped suffixes to |
1937 -its list of non\-compressing files (and its list may be configured to a |
1874 -its list of non\-compressing files (and its list may be configured to a |
1938 +its list of non-compressing files (and its list may be configured to a |
1875 +its list of non-compressing files (and its list may be configured to a |
1939 different default). |
1876 different default). |
1940 .IP |
1877 .IP |
1941 .IP "\fB\-\-numeric\-ids\fP" |
1878 .IP "\fB\-\-numeric\-ids\fP" |
1942 @@ -1948,8 +1872,8 @@ |
1879 @@ -1978,8 +1983,8 @@ |
1943 If a user or group has no name on the source system or it has no match |
1880 If a user or group has no name on the source system or it has no match |
1944 on the destination system, then the numeric ID |
1881 on the destination system, then the numeric ID |
1945 from the source system is used instead. See also the comments on the |
1882 from the source system is used instead. See also the comments on the |
1946 -\(dq\&use chroot\(dq\& setting in the rsyncd.conf manpage for information on how |
1883 -\(dq\&use chroot\(dq\& setting in the rsyncd.conf manpage for information on how |
1947 -the chroot setting affects rsync\(cq\&s ability to look up the names of the |
1884 -the chroot setting affects rsync\(cq\&s ability to look up the names of the |
1948 +\(lquse chroot\(rq setting in the rsyncd.conf manpage for information on how |
1885 +\(lquse chroot\(rq setting in the rsyncd.conf manpage for information on how |
1949 +the chroot setting affects rsync's ability to look up the names of the |
1886 +the chroot setting affects rsync's ability to look up the names of the |
1950 users and groups and what you can do about it. |
1887 users and groups and what you can do about it. |
1951 .IP |
1888 .IP |
1952 .IP "\fB\-\-timeout=TIMEOUT\fP" |
1889 .IP "\fB\-\-timeout=TIMEOUT\fP" |
1953 @@ -1971,7 +1895,7 @@ |
1890 @@ -2001,7 +2006,7 @@ |
1954 .IP "\fB\-\-port=PORT\fP" |
1891 .IP "\fB\-\-port=PORT\fP" |
1955 This specifies an alternate TCP port number to use |
1892 This specifies an alternate TCP port number to use |
1956 rather than the default of 873. This is only needed if you are using the |
1893 rather than the default of 873. This is only needed if you are using the |
1957 -double\-colon (::) syntax to connect with an rsync daemon (since the URL |
1894 -double\-colon (::) syntax to connect with an rsync daemon (since the URL |
1958 +double-colon (::) syntax to connect with an rsync daemon (since the URL |
1895 +double-colon (::) syntax to connect with an rsync daemon (since the URL |
1959 syntax has a way to specify the port as a part of the URL). See also this |
1896 syntax has a way to specify the port as a part of the URL). See also this |
1960 option in the \fB\-\-daemon\fP mode section. |
1897 option in the \fB\-\-daemon\fP mode section. |
1961 .IP |
1898 .IP |
1962 @@ -1991,21 +1915,21 @@ |
1899 @@ -2021,21 +2026,21 @@ |
1963 This tells rsync to use blocking I/O when launching |
1900 This tells rsync to use blocking I/O when launching |
1964 a remote shell transport. If the remote shell is either rsh or remsh, |
1901 a remote shell transport. If the remote shell is either rsh or remsh, |
1965 rsync defaults to using |
1902 rsync defaults to using |
1966 -blocking I/O, otherwise it defaults to using non\-blocking I/O. (Note that |
1903 -blocking I/O, otherwise it defaults to using non\-blocking I/O. (Note that |
1967 -ssh prefers non\-blocking I/O.) |
1904 -ssh prefers non\-blocking I/O.) |
2261 -You can also set the partial\-dir value the RSYNC_PARTIAL_DIR environment |
2200 -You can also set the partial\-dir value the RSYNC_PARTIAL_DIR environment |
2262 +You can also set the partial-dir value the RSYNC_PARTIAL_DIR environment |
2201 +You can also set the partial-dir value the RSYNC_PARTIAL_DIR environment |
2263 variable. Setting this in the environment does not force \fB\-\-partial\fP to be |
2202 variable. Setting this in the environment does not force \fB\-\-partial\fP to be |
2264 enabled, but rather it affects where partial files go when \fB\-\-partial\fP is |
2203 enabled, but rather it affects where partial files go when \fB\-\-partial\fP is |
2265 specified. For instance, instead of using \fB\-\-partial\-dir=.rsync\-tmp\fP |
2204 specified. For instance, instead of using \fB\-\-partial\-dir=.rsync\-tmp\fP |
2266 @@ -2270,7 +2194,7 @@ |
2205 @@ -2300,7 +2305,7 @@ |
2267 specified (since \fB\-\-inplace\fP conflicts with \fB\-\-partial\-dir\fP), and (2) when |
2206 specified (since \fB\-\-inplace\fP conflicts with \fB\-\-partial\-dir\fP), and (2) when |
2268 \fB\-\-delay\-updates\fP was specified (see below). |
2207 \fB\-\-delay\-updates\fP was specified (see below). |
2269 .IP |
2208 .IP |
2270 -For the purposes of the daemon\-config\(cq\&s \(dq\&refuse options\(dq\& setting, |
2209 -For the purposes of the daemon\-config\(cq\&s \(dq\&refuse options\(dq\& setting, |
2271 +For the purposes of the daemon-config's \(lqrefuse options\(rq setting, |
2210 +For the purposes of the daemon-config's \(lqrefuse options\(rq setting, |
2272 \fB\-\-partial\-dir\fP does \fInot\fP imply \fB\-\-partial\fP. This is so that a |
2211 \fB\-\-partial\-dir\fP does \fInot\fP imply \fB\-\-partial\fP. This is so that a |
2273 refusal of the \fB\-\-partial\fP option can be used to disallow the overwriting |
2212 refusal of the \fB\-\-partial\fP option can be used to disallow the overwriting |
2274 of destination files with a partial transfer, while still allowing the |
2213 of destination files with a partial transfer, while still allowing the |
2275 @@ -2281,12 +2205,12 @@ |
2214 @@ -2311,12 +2316,12 @@ |
2276 updated file into a holding directory until the end of the |
2215 updated file into a holding directory until the end of the |
2277 transfer, at which time all the files are renamed into place in rapid |
2216 transfer, at which time all the files are renamed into place in rapid |
2278 succession. This attempts to make the updating of the files a little more |
2217 succession. This attempts to make the updating of the files a little more |
2279 -atomic. By default the files are placed into a directory named \(dq\&.~tmp~\(dq\& in |
2218 -atomic. By default the files are placed into a directory named \(dq\&.~tmp~\(dq\& in |
2280 -each file\(cq\&s destination directory, but if you\(cq\&ve specified the |
2219 -each file\(cq\&s destination directory, but if you\(cq\&ve specified the |
2379 +These statistics can be misleading if rsync's delta-transfer algorithm is |
2318 +These statistics can be misleading if rsync's delta-transfer algorithm is |
2380 +in use. For example, if the sender's file consists of the basis file |
2319 +in use. For example, if the sender's file consists of the basis file |
2381 followed by additional data, the reported rate will probably drop |
2320 followed by additional data, the reported rate will probably drop |
2382 dramatically when the receiver gets to the literal data, and the transfer |
2321 dramatically when the receiver gets to the literal data, and the transfer |
2383 will probably take much longer to finish than the receiver estimated as it |
2322 will probably take much longer to finish than the receiver estimated as it |
2384 @@ -2376,7 +2300,7 @@ |
2323 @@ -2406,7 +2411,7 @@ |
2385 summary line that looks like this: |
2324 summary line that looks like this: |
2386 .IP |
2325 .IP |
2387 .nf |
2326 .nf |
2388 - 1238099 100% 146.38kB/s 0:00:08 (xfer#5, to\-check=169/396) |
2327 - 1238099 100% 146.38kB/s 0:00:08 (xfer#5, to\-check=169/396) |
2389 + 1238099 100% 146.38kB/s 0:00:08 (xfer#5, to-check=169/396) |
2328 + 1238099 100% 146.38kB/s 0:00:08 (xfer#5, to-check=169/396) |
2390 .fi |
2329 .fi |
2391 |
2330 |
2392 .IP |
2331 .IP |
2393 @@ -2384,8 +2308,8 @@ |
2332 @@ -2414,8 +2419,8 @@ |
2394 of transfer for the whole file was 146.38 kilobytes per second over the 8 |
2333 of transfer for the whole file was 146.38 kilobytes per second over the 8 |
2395 seconds that it took to complete, it was the 5th transfer of a regular file |
2334 seconds that it took to complete, it was the 5th transfer of a regular file |
2396 during the current rsync session, and there are 169 more files for the |
2335 during the current rsync session, and there are 169 more files for the |
2397 -receiver to check (to see if they are up\-to\-date or not) remaining out of |
2336 -receiver to check (to see if they are up\-to\-date or not) remaining out of |
2398 -the 396 total files in the file\-list. |
2337 -the 396 total files in the file\-list. |
2399 +receiver to check (to see if they are up-to-date or not) remaining out of |
2338 +receiver to check (to see if they are up-to-date or not) remaining out of |
2400 +the 396 total files in the file-list. |
2339 +the 396 total files in the file-list. |
2401 .IP |
2340 .IP |
2402 .IP "\fB\-P\fP" |
2341 .IP "\fB\-P\fP" |
2403 The \fB\-P\fP option is equivalent to \fB\-\-partial\fP \fB\-\-progress\fP. Its |
2342 The \fB\-P\fP option is equivalent to \fB\-\-partial\fP \fB\-\-progress\fP. Its |
2404 @@ -2395,14 +2319,13 @@ |
2343 @@ -2429,10 +2434,10 @@ |
2405 .IP "\fB\-\-password\-file\fP" |
2344 other lines are ignored). |
2406 This option allows you to provide a password in a |
|
2407 file for accessing an rsync daemon. The file must not be world readable. |
|
2408 -It should contain just the password as the first line of the file (all |
|
2409 -other lines are ignored). |
|
2410 +It should contain just the password as a single line. |
|
2411 .IP |
2345 .IP |
2412 This option does not supply a password to a remote shell transport such as |
2346 This option does not supply a password to a remote shell transport such as |
2413 -ssh; to learn how to do that, consult the remote shell\(cq\&s documentation. |
2347 -ssh; to learn how to do that, consult the remote shell\(cq\&s documentation. |
2414 +ssh; to learn how to do that, consult the remote shell's documentation. |
2348 +ssh; to learn how to do that, consult the remote shell's documentation. |
2415 When accessing an rsync daemon using a remote shell as the transport, this |
2349 When accessing an rsync daemon using a remote shell as the transport, this |
2446 +need to expand a directory's content), or turn on recursion and exclude |
2380 +need to expand a directory's content), or turn on recursion and exclude |
2447 +the content of subdirectories: \fB\-r \-\-exclude='/*/*'\fP. |
2381 +the content of subdirectories: \fB\-r \-\-exclude='/*/*'\fP. |
2448 .IP |
2382 .IP |
2449 .IP "\fB\-\-bwlimit=KBPS\fP" |
2383 .IP "\fB\-\-bwlimit=KBPS\fP" |
2450 This option allows you to specify a maximum |
2384 This option allows you to specify a maximum |
2451 @@ -2440,7 +2363,7 @@ |
2385 @@ -2470,7 +2475,7 @@ |
2452 .IP |
2386 .IP |
2453 .IP "\fB\-\-write\-batch=FILE\fP" |
2387 .IP "\fB\-\-write\-batch=FILE\fP" |
2454 Record a file that can later be applied to |
2388 Record a file that can later be applied to |
2455 -another identical destination with \fB\-\-read\-batch\fP. See the \(dq\&BATCH MODE\(dq\& |
2389 -another identical destination with \fB\-\-read\-batch\fP. See the \(dq\&BATCH MODE\(dq\& |
2456 +another identical destination with \fB\-\-read\-batch\fP. See the \(lqBATCH MODE\(rq |
2390 +another identical destination with \fB\-\-read\-batch\fP. See the \(lqBATCH MODE\(rq |
2457 section for details, and also the \fB\-\-only\-write\-batch\fP option. |
2391 section for details, and also the \fB\-\-only\-write\-batch\fP option. |
2458 .IP |
2392 .IP |
2459 .IP "\fB\-\-only\-write\-batch=FILE\fP" |
2393 .IP "\fB\-\-only\-write\-batch=FILE\fP" |
2460 @@ -2452,20 +2375,20 @@ |
2394 @@ -2482,58 +2487,58 @@ |
2461 Note that you can feel free to write the batch directly to some portable |
2395 Note that you can feel free to write the batch directly to some portable |
2462 media: if this media fills to capacity before the end of the transfer, you |
2396 media: if this media fills to capacity before the end of the transfer, you |
2463 can just apply that partial transfer to the destination and repeat the |
2397 can just apply that partial transfer to the destination and repeat the |
2464 -whole process to get the rest of the changes (as long as you don\(cq\&t mind a |
2398 -whole process to get the rest of the changes (as long as you don\(cq\&t mind a |
2465 -partially updated destination system while the multi\-update cycle is |
2399 -partially updated destination system while the multi\-update cycle is |
2530 -daemon uses the charset specified in its \(dq\&charset\(dq\& configuration parameter |
2463 -daemon uses the charset specified in its \(dq\&charset\(dq\& configuration parameter |
2531 +daemon uses the charset specified in its \(lqcharset\(rq configuration parameter |
2464 +daemon uses the charset specified in its \(lqcharset\(rq configuration parameter |
2532 regardless of the remote charset you actually pass. Thus, you may feel free to |
2465 regardless of the remote charset you actually pass. Thus, you may feel free to |
2533 specify just the local charset for a daemon transfer (e.g. \fB\-\-iconv=utf8\fP). |
2466 specify just the local charset for a daemon transfer (e.g. \fB\-\-iconv=utf8\fP). |
2534 .IP |
2467 .IP |
2535 @@ -2554,7 +2477,7 @@ |
2468 @@ -2584,7 +2589,7 @@ |
2536 run as a daemon with the \fB\-\-daemon\fP option. The \fB\-\-address\fP option |
2469 run as a daemon with the \fB\-\-daemon\fP option. The \fB\-\-address\fP option |
2537 allows you to specify a specific IP address (or hostname) to bind to. This |
2470 allows you to specify a specific IP address (or hostname) to bind to. This |
2538 makes virtual hosting possible in conjunction with the \fB\-\-config\fP option. |
2471 makes virtual hosting possible in conjunction with the \fB\-\-config\fP option. |
2539 -See also the \(dq\&address\(dq\& global option in the rsyncd.conf manpage. |
2472 -See also the \(dq\&address\(dq\& global option in the rsyncd.conf manpage. |
2540 +See also the \(lqaddress\(rq global option in the rsyncd.conf manpage. |
2473 +See also the \(lqaddress\(rq global option in the rsyncd.conf manpage. |
2541 .IP |
2474 .IP |
2542 .IP "\fB\-\-bwlimit=KBPS\fP" |
2475 .IP "\fB\-\-bwlimit=KBPS\fP" |
2543 This option allows you to specify a maximum |
2476 This option allows you to specify a maximum |
2544 @@ -2567,7 +2490,7 @@ |
2477 @@ -2597,7 +2602,7 @@ |
2545 This specifies an alternate config file than |
2478 This specifies an alternate config file than |
2546 the default. This is only relevant when \fB\-\-daemon\fP is specified. |
2479 the default. This is only relevant when \fB\-\-daemon\fP is specified. |
2547 The default is /etc/rsyncd.conf unless the daemon is running over |
2480 The default is /etc/rsyncd.conf unless the daemon is running over |
2548 -a remote shell program and the remote user is not the super\-user; in that case |
2481 -a remote shell program and the remote user is not the super\-user; in that case |
2549 +a remote shell program and the remote user is not the super-user; in that case |
2482 +a remote shell program and the remote user is not the super-user; in that case |
2550 the default is rsyncd.conf in the current directory (typically $HOME). |
2483 the default is rsyncd.conf in the current directory (typically $HOME). |
2551 .IP |
2484 .IP |
2552 .IP "\fB\-\-no\-detach\fP" |
2485 .IP "\fB\-\-no\-detach\fP" |
2553 @@ -2575,7 +2498,7 @@ |
2486 @@ -2605,25 +2610,25 @@ |
2554 rsync to not detach itself and become a background process. This |
2487 rsync to not detach itself and become a background process. This |
2555 option is required when running as a service on Cygwin, and may also |
2488 option is required when running as a service on Cygwin, and may also |
2556 be useful when rsync is supervised by a program such as |
2489 be useful when rsync is supervised by a program such as |
2557 -\fBdaemontools\fP or AIX\(cq\&s \fBSystem Resource Controller\fP. |
2490 -\fBdaemontools\fP or AIX\(cq\&s \fBSystem Resource Controller\fP. |
2558 +\fBdaemontools\fP or AIX's \fBSystem Resource Controller\fP. |
2491 +\fBdaemontools\fP or AIX's \fBSystem Resource Controller\fP. |
2559 \fB\-\-no\-detach\fP is also recommended when rsync is run under a |
2492 \fB\-\-no\-detach\fP is also recommended when rsync is run under a |
2560 debugger. This option has no effect if rsync is run from inetd or |
2493 debugger. This option has no effect if rsync is run from inetd or |
2561 sshd. |
2494 sshd. |
2562 @@ -2582,18 +2505,18 @@ |
|
2563 .IP |
2495 .IP |
2564 .IP "\fB\-\-port=PORT\fP" |
2496 .IP "\fB\-\-port=PORT\fP" |
2565 This specifies an alternate TCP port number for the |
2497 This specifies an alternate TCP port number for the |
2566 -daemon to listen on rather than the default of 873. See also the \(dq\&port\(dq\& |
2498 -daemon to listen on rather than the default of 873. See also the \(dq\&port\(dq\& |
2567 +daemon to listen on rather than the default of 873. See also the \(lqport\(rq |
2499 +daemon to listen on rather than the default of 873. See also the \(lqport\(rq |
2580 +given FORMAT string instead of using the \(lqlog format\(rq setting in the config |
2512 +given FORMAT string instead of using the \(lqlog format\(rq setting in the config |
2581 +file. It also enables \(lqtransfer logging\(rq unless the string is empty, in which |
2513 +file. It also enables \(lqtransfer logging\(rq unless the string is empty, in which |
2582 case transfer logging is turned off. |
2514 case transfer logging is turned off. |
2583 .IP |
2515 .IP |
2584 .IP "\fB\-\-sockopts\fP" |
2516 .IP "\fB\-\-sockopts\fP" |
2585 @@ -2603,8 +2526,8 @@ |
2517 @@ -2633,15 +2638,15 @@ |
2586 .IP "\fB\-v, \-\-verbose\fP" |
2518 .IP "\fB\-v, \-\-verbose\fP" |
2587 This option increases the amount of information the |
2519 This option increases the amount of information the |
2588 daemon logs during its startup phase. After the client connects, the |
2520 daemon logs during its startup phase. After the client connects, the |
2589 -daemon\(cq\&s verbosity level will be controlled by the options that the client |
2521 -daemon\(cq\&s verbosity level will be controlled by the options that the client |
2590 -used and the \(dq\&max verbosity\(dq\& setting in the module\(cq\&s config section. |
2522 -used and the \(dq\&max verbosity\(dq\& setting in the module\(cq\&s config section. |
2591 +daemon's verbosity level will be controlled by the options that the client |
2523 +daemon's verbosity level will be controlled by the options that the client |
2592 +used and the \(lqmax verbosity\(rq setting in the module's config section. |
2524 +used and the \(lqmax verbosity\(rq setting in the module's config section. |
2593 .IP |
2525 .IP |
2594 .IP "\fB\-4, \-\-ipv4\fP or \fB\-6, \-\-ipv6\fP" |
2526 .IP "\fB\-4, \-\-ipv4\fP or \fB\-6, \-\-ipv6\fP" |
2595 Tells rsync to prefer IPv4/IPv6 |
2527 Tells rsync to prefer IPv4/IPv6 |
2596 @@ -2611,7 +2534,7 @@ |
|
2597 when creating the incoming sockets that the rsync daemon will use to |
2528 when creating the incoming sockets that the rsync daemon will use to |
2598 listen for connections. One of these options may be required in older |
2529 listen for connections. One of these options may be required in older |
2599 versions of Linux to work around an IPv6 bug in the kernel (if you see |
2530 versions of Linux to work around an IPv6 bug in the kernel (if you see |
2600 -an \(dq\&address already in use\(dq\& error when nothing else is using the port, |
2531 -an \(dq\&address already in use\(dq\& error when nothing else is using the port, |
2601 +an \(lqaddress already in use\(rq error when nothing else is using the port, |
2532 +an \(lqaddress already in use\(rq error when nothing else is using the port, |
2602 try specifying \fB\-\-ipv6\fP or \fB\-\-ipv4\fP when starting the daemon). |
2533 try specifying \fB\-\-ipv6\fP or \fB\-\-ipv4\fP when starting the daemon). |
2603 .IP |
2534 .IP |
2604 If rsync was complied without support for IPv6, the \fB\-\-ipv6\fP option |
2535 If rsync was complied without support for IPv6, the \fB\-\-ipv6\fP option |
2605 @@ -2639,7 +2562,7 @@ |
2536 @@ -2669,7 +2674,7 @@ |
2606 filename is not skipped. |
2537 filename is not skipped. |
2607 .PP |
2538 .PP |
2608 Rsync builds an ordered list of filter rules as specified on the |
2539 Rsync builds an ordered list of filter rules as specified on the |
2609 -command\-line. Filter rules have the following syntax: |
2540 -command\-line. Filter rules have the following syntax: |
2610 +command-line. Filter rules have the following syntax: |
2541 +command-line. Filter rules have the following syntax: |
2611 .PP |
2542 .PP |
2612 .RS |
2543 .RS |
2613 \f(CWRULE [PATTERN_OR_FILENAME]\fP |
2544 \f(CWRULE [PATTERN_OR_FILENAME]\fP |
2614 @@ -2650,7 +2573,7 @@ |
2545 @@ -2680,7 +2685,7 @@ |
2615 |
2546 |
2616 .PP |
2547 .PP |
2617 You have your choice of using either short or long RULE names, as described |
2548 You have your choice of using either short or long RULE names, as described |
2618 -below. If you use a short\-named rule, the \(cq\&,\(cq\& separating the RULE from the |
2549 -below. If you use a short\-named rule, the \(cq\&,\(cq\& separating the RULE from the |
2619 +below. If you use a short-named rule, the \(oq,\(cq separating the RULE from the |
2550 +below. If you use a short-named rule, the \(oq,\(cq separating the RULE from the |
2620 MODIFIERS is optional. The PATTERN or FILENAME that follows (when present) |
2551 MODIFIERS is optional. The PATTERN or FILENAME that follows (when present) |
2621 must come after either a single space or an underscore (_). |
2552 must come after either a single space or an underscore (_). |
2622 Here are the available rule prefixes: |
2553 Here are the available rule prefixes: |
2623 @@ -2660,9 +2583,9 @@ |
2554 @@ -2690,9 +2695,9 @@ |
2624 .br |
2555 .br |
2625 \fBinclude, +\fP specifies an include pattern. |
2556 \fBinclude, +\fP specifies an include pattern. |
2626 .br |
2557 .br |
2627 -\fBmerge, .\fP specifies a merge\-file to read for more rules. |
2558 -\fBmerge, .\fP specifies a merge\-file to read for more rules. |
2628 +\fBmerge, .\fP specifies a merge-file to read for more rules. |
2559 +\fBmerge, .\fP specifies a merge-file to read for more rules. |
2693 +any point in the hierarchy where a \(lqfoo\(rq was found within a directory |
2623 +any point in the hierarchy where a \(lqfoo\(rq was found within a directory |
2694 +named \(lqsub\(rq. See the section on ANCHORING INCLUDE/EXCLUDE PATTERNS for |
2624 +named \(lqsub\(rq. See the section on ANCHORING INCLUDE/EXCLUDE PATTERNS for |
2695 a full discussion of how to specify a pattern that matches at the root |
2625 a full discussion of how to specify a pattern that matches at the root |
2696 of the transfer. |
2626 of the transfer. |
2697 .IP o |
2627 .IP o |
2698 @@ -2727,44 +2650,44 @@ |
2628 @@ -2757,44 +2762,44 @@ |
2699 .IP o |
2629 .IP o |
2700 rsync chooses between doing a simple string match and wildcard |
2630 rsync chooses between doing a simple string match and wildcard |
2701 matching by checking if the pattern contains one of these three wildcard |
2631 matching by checking if the pattern contains one of these three wildcard |
2702 -characters: \(cq\&*\(cq\&, \(cq\&?\(cq\&, and \(cq\&[\(cq\& . |
2632 -characters: \(cq\&*\(cq\&, \(cq\&?\(cq\&, and \(cq\&[\(cq\& . |
2703 +characters: \(oq*\(cq, \(oq?\(cq, and \(oq[\(cq . |
2633 +characters: \(oq*\(cq, \(oq?\(cq, and \(oq[\(cq . |
2704 .IP o |
2634 .IP o |
2705 -a \(cq\&*\(cq\& matches any path component, but it stops at slashes. |
2635 -a \(cq\&*\(cq\& matches any path component, but it stops at slashes. |
2706 +a \(oq*\(cq matches any path component, but it stops at slashes. |
2636 +a \(oq*\(cq matches any path component, but it stops at slashes. |
2707 .IP o |
2637 .IP o |
2708 -use \(cq\&**\(cq\& to match anything, including slashes. |
2638 -use \(cq\&**\(cq\& to match anything, including slashes. |
2709 +use '**' to match anything, including slashes. |
2639 +use \(oq**\(cq to match anything, including slashes. |
2710 .IP o |
2640 .IP o |
2711 -a \(cq\&?\(cq\& matches any character except a slash (/). |
2641 -a \(cq\&?\(cq\& matches any character except a slash (/). |
2712 +a \(oq?\(cq matches any character except a slash (/). |
2642 +a \(oq?\(cq matches any character except a slash (/). |
2713 .IP o |
2643 .IP o |
2714 -a \(cq\&[\(cq\& introduces a character class, such as [a\-z] or [[:alpha:]]. |
2644 -a \(cq\&[\(cq\& introduces a character class, such as [a\-z] or [[:alpha:]]. |
2931 also disabled). |
2868 also disabled). |
2932 .IP o |
2869 .IP o |
2933 -You may also specify any of the modifiers for the \(dq\&+\(dq\& or \(dq\&\-\(dq\& rules |
2870 -You may also specify any of the modifiers for the \(dq\&+\(dq\& or \(dq\&\-\(dq\& rules |
2934 +You may also specify any of the modifiers for the \(lq+\(rq or \(lq\-\(rq rules |
2871 +You may also specify any of the modifiers for the \(lq+\(rq or \(lq\-\(rq rules |
2935 (above) in order to have the rules that are read in from the file |
2872 (above) in order to have the rules that are read in from the file |
2936 -default to having that modifier set (except for the \fB!\fP modifier, which |
2873 default to having that modifier set (except for the \fB!\fP modifier, which |
2937 -would not be useful). For instance, \(dq\&merge,\-/ .excl\(dq\& would |
2874 -would not be useful). For instance, \(dq\&merge,\-/ .excl\(dq\& would |
2938 -treat the contents of .excl as absolute\-path excludes, |
2875 -treat the contents of .excl as absolute\-path excludes, |
2939 -while \(dq\&dir\-merge,s .filt\(dq\& and \(dq\&:sC\(dq\& would each make all their |
2876 -while \(dq\&dir\-merge,s .filt\(dq\& and \(dq\&:sC\(dq\& would each make all their |
2940 -per\-directory rules apply only on the sending side. If the merge rule |
2877 -per\-directory rules apply only on the sending side. If the merge rule |
2941 -specifies sides to affect (via the \fBs\fP or \fBr\fP modifier or both), |
2878 +would not be useful). For instance, \(lqmerge,\-/ .excl\(rq would |
2942 -then the rules in the file must not specify sides (via a modifier or |
|
2943 -a rule prefix such as \fBhide\fP). |
|
2944 +default to having that modifier set. For instance, \(lqmerge,\-/ .excl\(rq would |
|
2945 +treat the contents of .excl as absolute-path excludes, |
2879 +treat the contents of .excl as absolute-path excludes, |
2946 +while \(lqdir-merge,s .filt\(rq and \(lq:sC\(rq would each make all their |
2880 +while \(lqdir-merge,s .filt\(rq and \(lq:sC\(rq would each make all their |
2947 +per-directory rules apply only on the sending side. |
2881 +per-directory rules apply only on the sending side. If the merge rule |
|
2882 specifies sides to affect (via the \fBs\fP or \fBr\fP modifier or both), |
|
2883 then the rules in the file must not specify sides (via a modifier or |
|
2884 a rule prefix such as \fBhide\fP). |
2948 |
2885 |
2949 .PP |
2886 .PP |
2950 -Per\-directory rules are inherited in all subdirectories of the directory |
2887 -Per\-directory rules are inherited in all subdirectories of the directory |
2951 -where the merge\-file was found unless the \(cq\&n\(cq\& modifier was used. Each |
2888 -where the merge\-file was found unless the \(cq\&n\(cq\& modifier was used. Each |
2952 -subdirectory\(cq\&s rules are prefixed to the inherited per\-directory rules |
2889 -subdirectory\(cq\&s rules are prefixed to the inherited per\-directory rules |
2962 +the spot where the merge-file was specified, so it is possible to override |
2899 +the spot where the merge-file was specified, so it is possible to override |
2963 +dir-merge rules via a rule that got specified earlier in the list of global |
2900 +dir-merge rules via a rule that got specified earlier in the list of global |
2964 +rules. When the list-clearing rule (\(lq!\(rq) is read from a per-directory |
2901 +rules. When the list-clearing rule (\(lq!\(rq) is read from a per-directory |
2965 file, it only clears the inherited rules for the current merge file. |
2902 file, it only clears the inherited rules for the current merge file. |
2966 .PP |
2903 .PP |
2967 -Another way to prevent a single rule from a dir\-merge file from being inherited is to |
2904 Another way to prevent a single rule from a dir\-merge file from being inherited is to |
2968 -anchor it with a leading slash. Anchored rules in a per\-directory |
2905 anchor it with a leading slash. Anchored rules in a per\-directory |
2969 -merge\-file are relative to the merge\-file\(cq\&s directory, so a pattern \(dq\&/foo\(dq\& |
2906 -merge\-file are relative to the merge\-file\(cq\&s directory, so a pattern \(dq\&/foo\(dq\& |
2970 -would only match the file \(dq\&foo\(dq\& in the directory where the dir\-merge filter |
2907 -would only match the file \(dq\&foo\(dq\& in the directory where the dir\-merge filter |
2971 +Another way to prevent a single rule from a dir-merge file from being inherited is to |
2908 +merge\-file are relative to the merge\-file's directory, so a pattern \(lq/foo\(rq |
2972 +anchor it with a leading slash. Anchored rules in a per-directory |
2909 +would only match the file \(lqfoo\(rq in the directory where the dir\-merge filter |
2973 +merge-file are relative to the merge-file's directory, so a pattern \(lq/foo\(rq |
|
2974 +would only match the file \(lqfoo\(rq in the directory where the dir-merge filter |
|
2975 file was found. |
2910 file was found. |
2976 .PP |
2911 .PP |
2977 -Here\(cq\&s an example filter file which you\(cq\&d specify via \fB\-\-filter=\(dq\&. file\(dq\&:\fP |
2912 -Here\(cq\&s an example filter file which you\(cq\&d specify via \fB\-\-filter=\(dq\&. file\(dq\&:\fP |
2978 +Here's an example filter file which you'd specify via \fB\-\-filter=". file":\fP |
2913 +Here's an example filter file which you'd specify via \fB\-\-filter=". file":\fP |
2979 .PP |
2914 .PP |
2980 .RS |
2915 .RS |
2981 \f(CWmerge /home/user/.global\-filter\fP |
2916 \f(CWmerge /home/user/.global\-filter\fP |
2982 @@ -2967,18 +2886,18 @@ |
2917 @@ -2996,58 +3001,58 @@ |
2983 |
2918 .RE |
2984 .PP |
2919 |
2985 This will merge the contents of the /home/user/.global\-filter file at the |
2920 .PP |
|
2921 -This will merge the contents of the /home/user/.global\-filter file at the |
2986 -start of the list and also turns the \(dq\&.rules\(dq\& filename into a per\-directory |
2922 -start of the list and also turns the \(dq\&.rules\(dq\& filename into a per\-directory |
|
2923 +This will merge the contents of the /home/user/.global-filter file at the |
2987 +start of the list and also turns the \(lq.rules\(rq filename into a per-directory |
2924 +start of the list and also turns the \(lq.rules\(rq filename into a per-directory |
2988 filter file. All rules read in prior to the start of the directory scan |
2925 filter file. All rules read in prior to the start of the directory scan |
2989 follow the global anchoring rules (i.e. a leading slash matches at the root |
2926 follow the global anchoring rules (i.e. a leading slash matches at the root |
2990 of the transfer). |
2927 of the transfer). |
2991 .PP |
2928 .PP |
3191 -rsync \-av \-\-filter=\(cq\&: .rules\(cq\& \-\-filter=\(cq\&. /my/extra.rules\(cq\& |
3129 -rsync \-av \-\-filter=\(cq\&: .rules\(cq\& \-\-filter=\(cq\&. /my/extra.rules\(cq\& |
3192 +rsync \-av \-\-filter=': .rules' \-\-filter='. /my/extra.rules' |
3130 +rsync \-av \-\-filter=': .rules' \-\-filter='. /my/extra.rules' |
3193 \-\-delete host:src/dir /dest |
3131 \-\-delete host:src/dir /dest |
3194 .fi |
3132 .fi |
3195 |
3133 |
3196 @@ -3174,17 +3093,17 @@ |
3134 @@ -3204,17 +3209,17 @@ |
3197 In the above example the extra.rules file can affect both sides of the |
3135 In the above example the extra.rules file can affect both sides of the |
3198 transfer, but (on the sending side) the rules are subservient to the rules |
3136 transfer, but (on the sending side) the rules are subservient to the rules |
3199 merged from the .rules files because they were specified after the |
3137 merged from the .rules files because they were specified after the |
3200 -per\-directory merge rule. |
3138 -per\-directory merge rule. |
3201 +per-directory merge rule. |
3139 +per-directory merge rule. |
3202 .PP |
3140 .PP |
3203 In one final example, the remote side is excluding the .rsync\-filter |
3141 -In one final example, the remote side is excluding the .rsync\-filter |
3204 files from the transfer, but we want to use our own .rsync\-filter files |
3142 -files from the transfer, but we want to use our own .rsync\-filter files |
|
3143 +In one final example, the remote side is excluding the .rsync-filter |
|
3144 +files from the transfer, but we want to use our own .rsync-filter files |
3205 to control what gets deleted on the receiving side. To do this we must |
3145 to control what gets deleted on the receiving side. To do this we must |
3206 -specifically exclude the per\-directory merge files (so that they don\(cq\&t get |
3146 -specifically exclude the per\-directory merge files (so that they don\(cq\&t get |
3207 +specifically exclude the per-directory merge files (so that they don't get |
3147 +specifically exclude the per-directory merge files (so that they don't get |
3208 deleted) and then put rules into the local files to control what else |
3148 deleted) and then put rules into the local files to control what else |
3209 should not get deleted. Like one of these commands: |
3149 should not get deleted. Like one of these commands: |
3310 -protocol version in the batch file is too new for the batch\-reading rsync |
3250 -protocol version in the batch file is too new for the batch\-reading rsync |
3311 +protocol version in the batch file is too new for the batch-reading rsync |
3251 +protocol version in the batch file is too new for the batch-reading rsync |
3312 to handle. See also the \fB\-\-protocol\fP option for a way to have the |
3252 to handle. See also the \fB\-\-protocol\fP option for a way to have the |
3313 creating rsync generate a batch file that an older rsync can understand. |
3253 creating rsync generate a batch file that an older rsync can understand. |
3314 (Note that batch files changed format in version 2.6.3, so mixing versions |
3254 (Note that batch files changed format in version 2.6.3, so mixing versions |
3315 @@ -3291,8 +3210,8 @@ |
|
3316 older than that with newer versions will not work.) |
3255 older than that with newer versions will not work.) |
3317 .PP |
3256 .PP |
3318 When reading a batch file, rsync will force the value of certain options |
3257 When reading a batch file, rsync will force the value of certain options |
3319 -to match the data in the batch file if you didn\(cq\&t set them to the same |
3258 -to match the data in the batch file if you didn\(cq\&t set them to the same |
3320 -as the batch\-writing command. Other options can (and should) be changed. |
3259 -as the batch\-writing command. Other options can (and should) be changed. |
3321 +to match the data in the batch file if you didn't set them to the same |
3260 +to match the data in the batch file if you didn't set them to the same |
3322 +as the batch-writing command. Other options can (and should) be changed. |
3261 +as the batch-writing command. Other options can (and should) be changed. |
3323 For instance \fB\-\-write\-batch\fP changes to \fB\-\-read\-batch\fP, |
3262 For instance \fB\-\-write\-batch\fP changes to \fB\-\-read\-batch\fP, |
3324 \fB\-\-files\-from\fP is dropped, and the |
3263 \fB\-\-files\-from\fP is dropped, and the |
3325 \fB\-\-filter\fP/\fB\-\-include\fP/\fB\-\-exclude\fP options are not needed unless |
3264 \fB\-\-filter\fP/\fB\-\-include\fP/\fB\-\-exclude\fP options are not needed unless |
3326 @@ -3299,13 +3218,13 @@ |
|
3327 one of the \fB\-\-delete\fP options is specified. |
3265 one of the \fB\-\-delete\fP options is specified. |
3328 .PP |
3266 .PP |
3329 The code that creates the BATCH.sh file transforms any filter/include/exclude |
3267 The code that creates the BATCH.sh file transforms any filter/include/exclude |
3330 -options into a single list that is appended as a \(dq\&here\(dq\& document to the |
3268 -options into a single list that is appended as a \(dq\&here\(dq\& document to the |
3331 +options into a single list that is appended as a \(lqhere\(rq document to the |
3269 +options into a single list that is appended as a \(lqhere\(rq document to the |
3353 -If \fB\-\-copy\-links\fP is specified, then symlinks are \(dq\&collapsed\(dq\& by |
3291 -If \fB\-\-copy\-links\fP is specified, then symlinks are \(dq\&collapsed\(dq\& by |
3354 +If \fB\-\-copy\-links\fP is specified, then symlinks are \(lqcollapsed\(rq by |
3292 +If \fB\-\-copy\-links\fP is specified, then symlinks are \(lqcollapsed\(rq by |
3355 copying their referent, rather than the symlink. |
3293 copying their referent, rather than the symlink. |
3356 .PP |
3294 .PP |
3357 -Rsync can also distinguish \(dq\&safe\(dq\& and \(dq\&unsafe\(dq\& symbolic links. An |
3295 -Rsync can also distinguish \(dq\&safe\(dq\& and \(dq\&unsafe\(dq\& symbolic links. An |
3358 -example where this might be used is a web site mirror that wishes to |
3296 +Rsync can also distinguish \(lqsafe\(rq and \(lqunsafe\(rq symbolic links. An |
3359 -ensure that the rsync module that is copied does not include symbolic links to |
3297 example where this might be used is a web site mirror that wishes to |
3360 +rsync also distinguishes \(lqsafe\(rq and \(lqunsafe\(rq symbolic links. An |
3298 ensure that the rsync module that is copied does not include symbolic links to |
3361 +example where this might be used is a web site mirror that wishes |
|
3362 +ensure the rsync module they copy does not include symbolic links to |
|
3363 \fB/etc/passwd\fP in the public section of the site. Using |
3299 \fB/etc/passwd\fP in the public section of the site. Using |
3364 \fB\-\-copy\-unsafe\-links\fP will cause any links to be copied as the file |
3300 @@ -3364,11 +3369,11 @@ |
3365 they point to on the destination. Using \fB\-\-safe\-links\fP will cause |
|
3366 @@ -3334,11 +3253,11 @@ |
|
3367 \fB\-\-links\fP for \fB\-\-safe\-links\fP to have any effect.) |
3301 \fB\-\-links\fP for \fB\-\-safe\-links\fP to have any effect.) |
3368 .PP |
3302 .PP |
3369 Symbolic links are considered unsafe if they are absolute symlinks |
3303 Symbolic links are considered unsafe if they are absolute symlinks |
3370 -(start with \fB/\fP), empty, or if they contain enough \(dq\&..\(dq\& |
3304 -(start with \fB/\fP), empty, or if they contain enough \(dq\&..\(dq\& |
3371 +(start with \fB/\fP), empty, or if they contain enough \(lq..\(rq |
3305 +(start with \fB/\fP), empty, or if they contain enough \(lq..\(rq |
3376 +Here's a summary of how the symlink options are interpreted. The list is |
3310 +Here's a summary of how the symlink options are interpreted. The list is |
3377 +in order of precedence, so if your combination of options isn't mentioned, |
3311 +in order of precedence, so if your combination of options isn't mentioned, |
3378 use the first line that is a complete subset of your options: |
3312 use the first line that is a complete subset of your options: |
3379 .PP |
3313 .PP |
3380 .IP "\fB\-\-copy\-links\fP" |
3314 .IP "\fB\-\-copy\-links\fP" |
3381 @@ -3364,8 +3283,8 @@ |
3315 @@ -3394,8 +3399,8 @@ |
3382 |
3316 |
3383 .PP |
3317 .PP |
3384 rsync occasionally produces error messages that may seem a little |
3318 rsync occasionally produces error messages that may seem a little |
3385 -cryptic. The one that seems to cause the most confusion is \(dq\&protocol |
3319 -cryptic. The one that seems to cause the most confusion is \(dq\&protocol |
3386 -version mismatch \-\- is your shell clean?\(dq\&. |
3320 -version mismatch \-\- is your shell clean?\(dq\&. |
3387 +cryptic. The one that seems to cause the most confusion is \(lqprotocol |
3321 +cryptic. The one that seems to cause the most confusion is \(lqprotocol |
3388 +version mismatch \(em is your shell clean?\(rq. |
3322 +version mismatch \(em is your shell clean?\(rq. |
3389 .PP |
3323 .PP |
3390 This message is usually caused by your startup scripts or remote shell |
3324 This message is usually caused by your startup scripts or remote shell |
3391 facility producing unwanted garbage on the stream that rsync is using |
3325 facility producing unwanted garbage on the stream that rsync is using |
3392 @@ -3383,7 +3302,7 @@ |
3326 @@ -3413,7 +3418,7 @@ |
3393 data. Look at the contents and try to work out what is producing |
3327 data. Look at the contents and try to work out what is producing |
3394 it. The most common cause is incorrectly configured shell startup |
3328 it. The most common cause is incorrectly configured shell startup |
3395 scripts (such as .cshrc or .profile) that contain output statements |
3329 scripts (such as .cshrc or .profile) that contain output statements |
3396 -for non\-interactive logins. |
3330 -for non\-interactive logins. |
3397 +for non-interactive logins. |
3331 +for non-interactive logins. |
3398 .PP |
3332 .PP |
3399 If you are having trouble debugging filter patterns, then |
3333 If you are having trouble debugging filter patterns, then |
3400 try specifying the \fB\-vv\fP option. At this level of verbosity rsync will |
3334 try specifying the \fB\-vv\fP option. At this level of verbosity rsync will |
3401 @@ -3402,13 +3321,13 @@ |
3335 @@ -3432,13 +3437,13 @@ |
3402 Errors selecting input/output files, dirs |
3336 Errors selecting input/output files, dirs |
3403 .IP "\fB4\fP" |
3337 .IP "\fB4\fP" |
3404 Requested action not supported: an attempt |
3338 Requested action not supported: an attempt |
3405 -was made to manipulate 64\-bit files on a platform that cannot support |
3339 -was made to manipulate 64\-bit files on a platform that cannot support |
3406 +was made to manipulate 64-bit files on a platform that cannot support |
3340 +was made to manipulate 64-bit files on a platform that cannot support |
3439 -The HOME environment variable is used to find the user\(cq\&s |
3364 -The HOME environment variable is used to find the user\(cq\&s |
3440 +The HOME environment variable is used to find the user's |
3365 +The HOME environment variable is used to find the user's |
3441 default .cvsignore file. |
3366 default .cvsignore file. |
3442 |
3367 |
3443 .PP |
3368 .PP |
3444 @@ -3486,7 +3405,7 @@ |
3369 @@ -3516,7 +3521,7 @@ |
3445 .PP |
3370 .PP |
3446 times are transferred as *nix time_t values |
3371 times are transferred as *nix time_t values |
3447 .PP |
3372 .PP |
3448 -When transferring to FAT filesystems rsync may re\-sync |
3373 -When transferring to FAT filesystems rsync may re\-sync |
3449 +When transferring to FAT filesystems rsync may re-sync |
3374 +When transferring to FAT filesystems rsync may re-sync |
3450 unmodified files. |
3375 unmodified files. |
3451 See the comments on the \fB\-\-modify\-window\fP option. |
3376 See the comments on the \fB\-\-modify\-window\fP option. |
3452 .PP |
3377 .PP |
3453 @@ -3501,7 +3420,7 @@ |
3378 @@ -3552,27 +3557,27 @@ |
3454 .SH "VERSION" |
|
3455 |
|
3456 .PP |
|
3457 -This man page is current for version 3.0.8 of rsync. |
|
3458 +This man page is current for version 3.0.6 of rsync. |
|
3459 .PP |
|
3460 .SH "INTERNAL OPTIONS" |
|
3461 |
|
3462 @@ -3522,7 +3441,7 @@ |
|
3463 .PP |
3379 .PP |
3464 A WEB site is available at |
3380 A WEB site is available at |
3465 http://rsync.samba.org/. The site |
3381 http://rsync.samba.org/. The site |
3466 -includes an FAQ\-O\-Matic which may cover questions unanswered by this |
3382 -includes an FAQ\-O\-Matic which may cover questions unanswered by this |
3467 +includes an FAQ-O-Matic which may cover questions unanswered by this |
3383 +includes an FAQ-O-Matic which may cover questions unanswered by this |
3468 manual page. |
3384 manual page. |
3469 .PP |
3385 .PP |
3470 The primary ftp site for rsync is |
3386 The primary ftp site for rsync is |
3471 @@ -3529,20 +3448,20 @@ |
|
3472 ftp://rsync.samba.org/pub/rsync. |
3387 ftp://rsync.samba.org/pub/rsync. |
3473 .PP |
3388 .PP |
3474 We would be delighted to hear from you if you like this program. |
3389 We would be delighted to hear from you if you like this program. |
3475 -Please contact the mailing\-list at [email protected]. |
3390 -Please contact the mailing\-list at [email protected]. |
3476 +Please contact the mailing-list at [email protected]. |
3391 +Please contact the mailing-list at [email protected]. |