--out-format=FORMAT
This allows you to specify exactly what the rsync client outputs to the user on a per-update basis. The format is
a text string containing embedded single-character escape sequences prefixed with a percent (%) character. A
default format of "%n%L" is assumed if -v is specified (which reports the name of the file and, if the item is a
link, where it points). For a full list of the possible escape characters, see the "log format" setting in the
rsyncd.conf manpage.
Specifying the --out-format option will mention each file, dir, etc. that gets updated in a significant way (a
transferred file, a recreated symlink/device, or a touched directory). In addition, if the itemize-changes escape
(%i) is included in the string (e.g. if the --itemize-changes option was used), the logging of names increases to
mention any item that is changed in any way (as long as the receiving side is at least 2.6.4). See the --item‐
ize-changes option for a description of the output of "%i".
Rsync will output the out-format string prior to a file’s transfer unless one of the transfer-statistic escapes is
requested, in which case the logging is done at the end of the file’s transfer. When this late logging is in
effect and --progress is also specified, rsync will also output the name of the file being transferred prior to
its progress information (followed, of course, by the out-format output).
--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 be enabled with a default format of "%i %n%L". See the --log-file-format
option if you wish to override this.
Here’s a example command that requests the remote side to log what is happening:
rsync -av --rsync-path="rsync --log-file=/tmp/rlog" src/ dest/
This is very useful if you need to debug why a connection is closing unexpectedly.
--log-file-format=FORMAT
This allows you to specify exactly what per-update logging is put into the file specified by the --log-file option
(which must also be specified for this option to have any effect). If you specify an empty string, updated files
will not be mentioned in the log file. For a list of the possible escape characters, see the "log format" setting
in the rsyncd.conf manpage.
The default FORMAT used if --log-file is specified and this option is not is ’%i %n%L’.
Bookmarks