X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/2e3c14179559362dbdf1878b57d3df41c3d7b65c..81dc5750ca131658e42f3a830443849a9b6d119b:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 0af8eb0f..084bcc5e 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() @@ -245,6 +245,7 @@ verb( --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 @@ -452,6 +453,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. @@ -484,13 +489,13 @@ then use the --delete-after switch. 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. +dit(bf(--force)) This option used to alter the behavior of the --delete +option to force deletion of non-empty directories, but that happens now +anyway because rsync does deletes in depth-first order. The only known +difference that --force makes now is an obscure case where the source is a +non-directory (for example a file or a symlink) but the destination is a +directory that contains a directory by the same name as the source while +--recursive mode is in effect. dit(bf(-B , --block-size=BLOCKSIZE)) This controls the block size used in the rsync algorithm. See the technical report for details. @@ -965,15 +970,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.