mailto(rsync-bugs@samba.org)
-manpage(rsync)(1)(12 Apr 2006)()()
+manpage(rsync)(1)(22 Apr 2006)()()
manpagename(rsync)(faster, flexible replacement for rcp)
manpagesynopsis()
-B, --block-size=SIZE force a fixed checksum block-size
-e, --rsh=COMMAND specify the remote shell to use
--rsync-path=PROGRAM specify the rsync to run on remote machine
- --existing ignore non-existing files on receiving side
- --ignore-existing ignore files that already exist on receiver
- --remove-sent-files sent files/symlinks are removed from sender
+ --existing skip creating new files on receiver
+ --ignore-existing skip updating files that exist on receiver
+ --remove-sent-files sender removes successfully sent files
--del an alias for --delete-during
- --delete delete files that don't exist on sender
+ --delete delete extraneous files from dest dirs
--delete-before receiver deletes before transfer (default)
--delete-during receiver deletes during xfer, not before
--delete-after receiver deletes after transfer, not before
- --delete-excluded also delete excluded files on receiver
+ --delete-excluded also delete excluded files from dest dirs
--ignore-errors delete even if there are I/O errors
--force force deletion of dirs even if not empty
--max-delete=NUM don't delete more than NUM files
--progress show progress during transfer
-P same as --partial --progress
-i, --itemize-changes output a change-summary for all updates
+ --log-file=FILE output what we're doing to a log file
--log-format=FORMAT output filenames using the specified format
--password-file=FILE read password from FILE
--list-only list the files instead of copying them
--config=FILE specify alternate rsyncd.conf file
--no-detach do not detach from the parent
--port=PORT listen on alternate port number
+ --log-file=FILE override the "log file" setting
--sockopts=OPTIONS specify custom TCP options
-v, --verbose increase verbosity
-4, --ipv4 prefer IPv4
by this option.
dit(bf(--existing, --ignore-non-existing)) This tells rsync to skip
-updating files that do not exist yet on the destination. If this option is
+creating files (including directories) that do not exist
+yet on the destination. If this option is
combined with the bf(--ignore-existing) option, no files will be updated
-(which can be useful if all you want to do is to delete missing files).
+(which can be useful if all you want to do is to delete extraneous files).
dit(bf(--ignore-existing)) This tells rsync to skip updating files that
-already exist on the destination. See also bf(--ignore-non-existing).
+already exist on the destination (this does em(not) ignore existing
+directores, or nothing would get done). See also bf(--existing).
dit(bf(--remove-sent-files)) This tells rsync to remove from the sending
side the files and/or symlinks that are newly created or whose content is
you are talking to a recent enough rsync that it logs deletions instead of
outputting them as a verbose message).
+dit(bf(--log-file=FILE)) This option causes rsync to log what it is doing
+to a file. This is similar to the logging that a daemon does, but can be
+requested for the client side and/or the server side of a non-daemon
+transfer. If specified as a client option, transfer logging will in effect
+if the bf(--log-format) option was either specified or implied (e.g.
+bf(--verbose) implies a basic log format). If explicitly sent to a server
+via the bf(--rsync-path) option, transfer logging will always occur using
+the default bf(--itemize-changes) format.
+
+Here's a example command that requests the remote side to log what is
+happening:
+
+verb( rsync -av --rsync-path="path --log-file=/tmp/rlog" src/ dest/)
+
+This is very useful if you need to debug why a connection is closing
+unexpectedly.
+
dit(bf(--log-format=FORMAT)) This allows you to specify exactly what the
rsync client outputs to the user on a per-file basis. The format is a text
string containing embedded single-character escape sequences prefixed with
daemon to listen on rather than the default of 873. See also the "port"
global option in the rsyncd.conf manpage.
+dit(bf(--log-file=FILE)) This option tells the rsync daemon to use the
+given log-file name instead of using the "log file" setting in the config
+file.
+
dit(bf(--sockopts)) This overrides the bf(socket options) setting in the
rsyncd.conf file and has the same syntax.
manpagesection(VERSION)
-This man page is current for version 2.6.8pre1 of rsync.
+This man page is current for version 2.6.8 of rsync.
manpagesection(CREDITS)