X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/eb06fa95e422822e67e986e5e9c3818afbba45bb..93689aa51a1541cbc53bd9fa261b9c01ce0d0a95:/rsync.yo diff --git a/rsync.yo b/rsync.yo index c53aaaf6..035a352c 100644 --- a/rsync.yo +++ b/rsync.yo @@ -1,5 +1,5 @@ mailto(rsync-bugs@samba.org) -manpage(rsync)(1)(14 Dec 2001)()() +manpage(rsync)(1)(25 Jan 2002)()() manpagename(rsync)(faster, flexible replacement for rcp) manpagesynopsis() @@ -239,12 +239,14 @@ verb( -S, --sparse handle sparse files efficiently -n, --dry-run show what would have been transferred -W, --whole-file copy whole files, no incremental checks + --no-whole-file turn off --whole-file -x, --one-file-system don't cross filesystem boundaries -B, --block-size=SIZE checksum blocking size (default 700) -e, --rsh=COMMAND specify rsh replacement --rsync-path=PATH specify path to rsync on the remote machine -C, --cvs-exclude auto ignore files in the same way CVS does --existing only update files that already exist + --ignore-existing ignore files that already exist on the receiving side --delete delete files that don't exist on the sending side --delete-excluded also delete excluded files on the receiving side --delete-after delete after transferring, not before @@ -272,13 +274,14 @@ verb( --config=FILE specify alternate rsyncd.conf file --port=PORT specify alternate rsyncd port number --blocking-io use blocking IO for the remote shell + --no-blocking-io turn off --blocking-io --stats give some file transfer stats --progress show progress during transfer --log-format=FORMAT log file transfers using specified format --password-file=FILE get password from FILE --bwlimit=KBPS limit I/O bandwidth, KBytes per second - -f, --read-batch=FILE read batch file - -F, --write-batch write batch file + --read-batch=FILE read batch file + --write-batch write batch file -h, --help show this help screen @@ -410,6 +413,9 @@ target machines is higher than the bandwidth to disk (especially when the "disk" is actually a networked file system). This is the default when both the source and target are on the local machine. +dit(bf(--no-whole-file)) Turn off --whole-file, for use when it is the +default. + dit(bf(-p, --perms)) This option causes rsync to update the remote permissions to be the same as the local permissions. @@ -452,6 +458,10 @@ contents of only one filesystem. dit(bf(--existing)) This tells rsync not to create any new files - only update files that already exist on the destination. +dit(bf(--ignore-existing)) +This tells rsync not to update files that already exist on +the destination. + dit(bf(--max-delete=NUM)) This tells rsync not to delete more than NUM files or directories. This is useful when mirroring very large trees to prevent disasters. @@ -485,12 +495,9 @@ dit(bf(--ignore-errors)) Tells --delete to go ahead and delete files even when there are IO errors. dit(bf(--force)) This options tells rsync to delete directories even if -they are not empty. This applies to both the --delete option and to -cases where rsync tries to copy a normal file but the destination -contains a directory of the same name. - -Since this option was added, deletions were reordered to be done depth-first -so it is hardly ever needed anymore except in very obscure cases. +they are not empty when they are to be replaced by non-directories. This +is only relevant without --delete because deletions are now done depth-first. +Requires the --recursive option (which is implied by -a) to have any effect. dit(bf(-B , --block-size=BLOCKSIZE)) This controls the block size used in the rsync algorithm. See the technical report for details. @@ -655,6 +662,9 @@ the default "rsh", this defaults to blocking IO, otherwise it defaults to non-blocking IO. You may find the --blocking-io option is needed for some remote shells that can't handle non-blocking IO. Ssh prefers blocking IO. +dit(bf(--no-blocking-io)) Turn off --blocking-io, for use when it is the +default. + dit(bf(--log-format=FORMAT)) This allows you to specify exactly what the rsync client logs to stdout on a per-file basis. The log format is specified using the same format conventions as the log format option in @@ -793,12 +803,15 @@ itemize( manpagesection(BATCH MODE) +bf(Note:) Batch mode should be considered experimental in this version +of rsync. The interface or behaviour may change before it stabilizes. + The following call generates 4 files that encapsulate the information for synchronizing the contents of bf(target_dir) with the updates found in bf(src_dir) quote( -$ rsync -F [other rsync options here] \nl() +$ rsync --write-batch [other rsync options here] \nl() /somewhere/src_dir /somewhere/target_dir ) @@ -962,15 +975,22 @@ Jean-loup Gailly and Mark Adler. manpagesection(THANKS) Thanks to Richard Brent, Brendan Mackay, Bill Waite, Stephen Rothwell -and David Bell for helpful suggestions and testing of rsync. I've -probably missed some people, my apologies if I have. +and David Bell for helpful suggestions, patches and testing of rsync. +I've probably missed some people, my apologies if I have. + +Especial thanks also to: David Dykstra, Jos Backus, Sebastian Krahmer. manpageauthor() -rsync was written by Andrew Tridgell and Paul Mackerras. +rsync was written by Andrew Tridgell and Paul +Mackerras. -rsync is now maintained by Martin Pool . +rsync is now maintained by Martin Pool . Mailing lists for support and development are available at -url(http://lists.samba.org)(lists.samba.org) +url(http://lists.samba.org)(lists.samba.org) + +If you suspect you have found a security vulnerability in rsync, +please send it directly to Martin Pool and Andrew Tridgell. For other +enquiries, please use the mailing list.