mailto(rsync-bugs@samba.org)
-manpage(rsync)(1)(19 Feb 2006)()()
+manpage(rsync)(1)(11 Mar 2006)()()
manpagename(rsync)(faster, flexible replacement for rcp)
manpagesynopsis()
"path/foo/file", which might fail if the duplicated symlink did not point
to a directory on the receiving side. Another way to avoid this sending of
a symlink as an implied directory is to use bf(--copy-unsafe-links), or
-bf(--copy-dirlinks) (which will also affect symlinks to directories in the
-rest of the transfer).
+bf(--copy-dirlinks) (both of which also affect symlinks in the rest of the
+transfer -- see their descriptions for full details).
dit(bf(-b, --backup)) With this option, preexisting destination files are
renamed as each file is transferred or deleted. You can control where the
on the file transfer, allowing you to tell how effective the rsync
algorithm is for your data.
-The current statistics are as follows: itemize(
+The current statistics are as follows: quote(itemize(
it() bf(Number of files) is the count of all "files" (in the generic
sense), which includes directories, symlinks, etc.
it() bf(Number of files transferred) is the count of normal files that
rsync received by the client side from the server side. "Non-message"
bytes means that we don't count the bytes for a verbose message that the
server sent to us, which makes the stats more consistent.
-)
+))
dit(bf(-8, --8-bit-output)) This tells rsync to leave all high-bit characters
unescaped in the output instead of trying to test them to see if they're
single line.
dit(bf(--list-only)) This option will cause the source files to be listed
-instead of transferred. This option is inferred if there is no destination
-specified, so its main uses are: (1) to turn a copy command that includes a
+instead of transferred. This option is inferred if there is a single source
+arg and no destination specified, so its main uses are: (1) to turn a copy
+command that includes a
destination arg into a file-listing command, (2) to be able to specify more
than one local source arg (note: be sure to include the destination), or
(3) to avoid the automatically added "bf(-r --exclude='/*/*')" options that
rsync usually uses as a compatibility kluge when generating a non-recursive
-listing.
+listing. Caution: keep in mind that a source arg with a wild-card is expanded
+by the shell into multiple args, so it is never safe to try to list such an arg
+without using this option. For example:
+
+verb( rsync -av --list-only foo* dest/)
dit(bf(--bwlimit=KBPS)) This option allows you to specify a maximum
transfer rate in kilobytes per second. This option is most effective when
of the transfer.
it() if the pattern ends with a / then it will only match a
directory, not a file, link, or device.
-
it() rsync chooses between doing a simple string match and wildcard
matching by checking if the pattern contains one of these three wildcard
characters: '*', '?', and '[' .
manpagesection(VERSION)
-This man page is current for version 2.6.7pre2 of rsync.
+This man page is current for version 2.6.7 of rsync.
manpagesection(CREDITS)