X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/8641d287403abe135af13afa02f1d287f878f514..2873603ab5e7451ad8fd3ee75b859d709ae0378a:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 75edc768..b80c160e 100644 --- a/rsync.yo +++ b/rsync.yo @@ -1,5 +1,5 @@ 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() @@ -337,15 +337,15 @@ to the detailed description below for a complete description. verb( -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 @@ -387,7 +387,9 @@ to the detailed description below for a complete description. verb( --progress show progress during transfer -P same as --partial --progress -i, --itemize-changes output a change-summary for all updates - --log-format=FORMAT output filenames using the specified format + --out-format=FORMAT output updates using the specified FORMAT + --log-file=FILE log what we're doing to the specified FILE + --log-file-format=FMT log updates using the specified FMT --password-file=FILE read password from FILE --list-only list the files instead of copying them --bwlimit=KBPS limit I/O bandwidth; KBytes per second @@ -410,6 +412,7 @@ accepted: verb( --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 @@ -905,12 +908,14 @@ treated like a mount-point. Symlinks to non-directories are unaffected 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 @@ -1430,12 +1435,29 @@ the string "*deleting" for each item that is being removed (assuming that 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 a percent (%) character. For a list of the possible escape characters, see the "log format" setting in the rsyncd.conf manpage. (Note that this -option does not affect what a daemon logs to its logfile.) +option does not affect what a daemon logs to its log file.) Specifying this option will mention each file, dir, etc. that gets updated in a significant way (a transferred file, a recreated symlink/device, or a @@ -1782,6 +1804,10 @@ dit(bf(--port=PORT)) This specifies an alternate TCP port number for the 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. @@ -2499,7 +2525,7 @@ url(http://rsync.samba.org/)(http://rsync.samba.org/) 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)