Commit 3b2bebbf authored by Wayne Davison's avatar Wayne Davison

Improved the "log format" section some more.

parent 4f90eb43
...@@ -360,8 +360,10 @@ directories, and the sysadmin doesn't want those files to be seen at all. ...@@ -360,8 +360,10 @@ directories, and the sysadmin doesn't want those files to be seen at all.
dit(bf(transfer logging)) The "transfer logging" option enables per-file dit(bf(transfer logging)) The "transfer logging" option enables per-file
logging of downloads and uploads in a format somewhat similar to that logging of downloads and uploads in a format somewhat similar to that
used by ftp daemons. If you want to customize the log formats look at used by ftp daemons. The server always logs the transfer at the end, so
the log format option. if a transfer is aborted, no mention will be made in the log file.
If you want to customize the log lines, see the "log format" option.
dit(bf(log format)) The "log format" option allows you to specify the dit(bf(log format)) The "log format" option allows you to specify the
format used for logging file transfers when transfer logging is format used for logging file transfers when transfer logging is
...@@ -376,8 +378,8 @@ quote(itemize( ...@@ -376,8 +378,8 @@ quote(itemize(
it() %l for the length of the file in bytes it() %l for the length of the file in bytes
it() %p for the process ID of this rsync session it() %p for the process ID of this rsync session
it() %o for the operation, which is either "send" or "recv" it() %o for the operation, which is either "send" or "recv"
it() %f for the filename (long form) it() %f for the filename (long form on server; no trailing "/")
it() %n for the filename (short form) it() %n for the filename (short form; trailing "/" on dir)
it() %L either the string " -> SYMLINK" or "" if not a symlink it() %L either the string " -> SYMLINK" or "" if not a symlink
it() %P for the module path it() %P for the module path
it() %m for the module name it() %m for the module name
...@@ -393,21 +395,24 @@ The default log format is "%o %h [%a] %m (%u) %l %f%L", and a "%t [%p] " ...@@ -393,21 +395,24 @@ The default log format is "%o %h [%a] %m (%u) %l %f%L", and a "%t [%p] "
is always prefixed when using the "log file" option. is always prefixed when using the "log file" option.
A perl script called rsyncstats to summarize this format is included A perl script called rsyncstats to summarize this format is included
in the rsync source code distribution. in the rsync source code distribution in the "support" subdirectory.
The %i format is a set of cryptic characters that are output as follows: The %i format is a set of cryptic characters that are output as follows:
quote(tt( *Xcstpog ITEM_NAME)) quote(tt( *Xcstpog ITEM_NAME))
The bf(*) is either bf(<) (receive), bf(>) (send), or bf(*) (--dry-run) if The bf(*) is either bf(<) (receive), bf(>) (send), or bf(*) (--dry-run) if
the item is being updated, otherwise it is a space. the item is being transferred, otherwise it is a space. This lets you
distinguish between a file that is getting its attributes changed and a
file whose content is being updated. Note that when a symlink or a device
gets its value changed, that is considered to be a transfer.
The bf(X) will be replaced by one of the following: an "f" for a file, a The bf(X) will be replaced by one of the following: an "f" for a file, a
"d" for a dir, an "L" for a symlink, or a "D" for a device. "d" for a dir, an "L" for a symlink, or a "D" for a device.
The rest of the letters in the string above are the actual letters that The rest of the letters in the string above are the actual letters that
will be output if the associated attribute for the item is being updated; will be output if the associated attribute for the item is being updated;
otherwise the letter will be replaced by either a "." for no change, a "+" otherwise the letter will be replaced by a "." for no change, a "+"
for a new item, or a "?" if the attribute is not known (which happens when for a new item, or a "?" if the attribute is not known (which happens when
talking to an older rsync). The meanings of the attribute letters are as talking to an older rsync). The meanings of the attribute letters are as
follows: follows:
...@@ -417,15 +422,17 @@ quote(itemize( ...@@ -417,15 +422,17 @@ quote(itemize(
updated by the file transfer (requries bf(--checksum)). updated by the file transfer (requries bf(--checksum)).
it() A bf(s) means the size of the file is different and will be updated it() A bf(s) means the size of the file is different and will be updated
by the file transfer. by the file transfer.
it() A bf(t) means the modified time is being updated to the server's it() A bf(t) means the modified time is different and is being updated to
value (requires --times). An alternate value of bf(T) means that the the server's value (requires bf(--times)). An alternate value of bf(T)
time is being set to the transfer time, which happens when symlinks are means that the time will be set to the transfer time, which happens
updated, or when a file or device is updated without --times. anytime a symlink is transferred, or when a file or device is transferred
it() A bf(p) means the permissions are being updated (requires without bf(--times).
bf(--perms)). it() A bf(p) means the permissions are different and are being updated to
the server's value (requires bf(--perms)).
it() An bf(o) means the owner is being updated (requires bf(--owner) and it() An bf(o) means the owner is being updated (requires bf(--owner) and
root privileges). root privileges).
it() A bf(g) means the group is being updated (requires bf(--group)). it() A bf(g) means the group is being updated (requires bf(--group) and
the authority to set the requested group).
)) ))
dit(bf(timeout)) The "timeout" option allows you to override the dit(bf(timeout)) The "timeout" option allows you to override the
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment