X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/be92ac6c36086f0cf04c85ec7021266b4be20b04..f01b6368a50ebcb5a78750d8b2aff612359b5735:/rsync.yo diff --git a/rsync.yo b/rsync.yo index ee3474ee..15f7dad8 100644 --- a/rsync.yo +++ b/rsync.yo @@ -384,9 +384,9 @@ dit(bf(-I, --ignore-times)) Normally rsync will skip any files that are already the same size and have the same modification time-stamp. This option turns off this "quick check" behavior. -dit(bf(--size-only)) Normally rsync will skip any files that are +dit(bf(--size-only)) Normally rsync will not transfer any files that are already the same size and have the same modification time-stamp. With the ---size-only option files will be skipped if they have the same size, +--size-only option, files will not be transferred if they have the same size, regardless of timestamp. This is useful when starting to use rsync after using another mirroring system which may not preserve timestamps exactly. @@ -402,7 +402,7 @@ dit(bf(-c, --checksum)) This forces the sender to checksum all files using a 128-bit MD4 checksum before transfer. The checksum is then explicitly checked on the receiver and any files of the same name which already exist and have the same checksum and size on the -receiver are skipped. This option can be quite slow. +receiver are not transferred. This option can be quite slow. dit(bf(-a, --archive)) This is equivalent to -rlptgoD. It is a quick way of saying you want recursion and want to preserve almost @@ -712,6 +712,8 @@ was located on the remote "src" host. dit(bf(-0, --from0)) This tells rsync that the filenames it reads from a file are terminated by a null ('\0') character, not a NL, CR, or CR+LF. This affects --exclude-from, --include-from, and --files-from. +It does not affect --cvs-exclude (since all names read from a .cvsignore +file are split on whitespace). dit(bf(-T, --temp-dir=DIR)) This option instructs rsync to use DIR as a scratch directory when creating temporary copies of the files @@ -737,6 +739,11 @@ unchanged files. Files with changed ownership or permissions will not be linked. Like bf(--compare-dest) if DIR is a relative path, it is relative to the destination directory (which changes in a recursive transfer). +An example: + +verb( + rsync -av --link-dest=$PWD/prior_dir host:src_dir/ new_dir/ +) dit(bf(-z, --compress)) With this option, rsync compresses any data from the files that it sends to the destination machine. This @@ -909,30 +916,34 @@ option affects the path you need to use in your matching (in addition to changing how much of the file tree is duplicated on the destination system). The following examples demonstrate this. -Let's say that we want to match a source filename that has an absolute -path of "/home/me/foo/bar", here is how the various command choices can -differ: +Let's say that we want to match two source files, one with an absolute +path of "/home/me/foo/bar", and one with a path of "/home/you/bar/baz". +Here is how the various command choices differ for a 2-source transfer: verb( - Example cmd: rsync -a /home/me /dest - Source root: /home ("me" is part of transfer) + Example cmd: rsync -a /home/me /home/you /dest +/- pattern: /me/foo/bar + +/- pattern: /you/bar/baz Target file: /dest/me/foo/bar + Target file: /dest/you/bar/baz - Example cmd: rsync -a /home/me/ /dest - Source root: /home/me (due to trailing /) - +/- pattern: /foo/bar (note missing "me") + Example cmd: rsync -a /home/me/ /home/you/ /dest + +/- pattern: /foo/bar (note missing "me") + +/- pattern: /bar/baz (note missing "you") Target file: /dest/foo/bar + Target file: /dest/bar/baz - Example cmd: rsync -a --relative /home/me/ /dest - Source root: /home/me - +/- pattern: /home/me/foo/bar (note full path) + Example cmd: rsync -a --relative /home/me/ /home/you /dest + +/- pattern: /home/me/foo/bar (note full path) + +/- pattern: /home/you/bar/baz (ditto) Target file: /dest/home/me/foo/bar + Target file: /dest/home/you/bar/baz - Example cmd: cd /home; rsync -a --relative me/foo/ /dest - Source root: ./me/foo (source is not absolute) - +/- pattern: /me/foo/bar (only uses specified path) + Example cmd: cd /home; rsync -a --relative me/foo you/ /dest + +/- pattern: /me/foo/bar (starts at specified path) + +/- pattern: /you/bar/baz (ditto) Target file: /dest/me/foo/bar + Target file: /dest/you/bar/baz ) The easiest way to see what name you should include/exclude is to just @@ -982,11 +993,11 @@ itemize( it() if the pattern starts with "+ " (a plus followed by a space) then it is always considered an include pattern, even if specified as - part of an exclude option. The "+ " part is discarded before matching. + part of an exclude option. The prefix is discarded before matching. it() if the pattern starts with "- " (a minus followed by a space) then it is always considered an exclude pattern, even if specified as - part of an include option. The "- " part is discarded before matching. + part of an include option. The prefix is discarded before matching. it() if the pattern is a single exclamation mark ! then the current include/exclude list is reset, removing all previously defined patterns. @@ -1205,6 +1216,7 @@ password to a shell transport such as ssh. dit(bf(USER) or bf(LOGNAME)) The USER or LOGNAME environment variables are used to determine the default username sent to an rsync server. +If neither is set, the username defaults to "nobody". dit(bf(HOME)) The HOME environment variable is used to find the user's default .cvsignore file. @@ -1261,19 +1273,13 @@ Thanks to Richard Brent, Brendan Mackay, Bill Waite, Stephen Rothwell 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. - +Especial thanks also to: David Dykstra, Jos Backus, Sebastian Krahmer, +Martin Pool, Wayne Davison. manpageauthor() -rsync was written by Andrew Tridgell and Paul -Mackerras. - -rsync is now maintained by Martin Pool . +rsync was originally written by Andrew Tridgell and Paul Mackerras. +Many people have later contributed to it. Mailing lists for support and development are available at 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.