mailto(rsync-bugs@samba.org)
-manpage(rsync)(1)(19 Feb 2006)()()
+manpage(rsync)(1)(2 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
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
manpagesection(VERSION)
-This man page is current for version 2.6.7pre2 of rsync.
+This man page is current for version 2.6.7pre3 of rsync.
manpagesection(CREDITS)