a long variant, not a
short.
If the option takes a parameter, the parameter is only listed after the
long variant, even though it must also be specified for the short. When
specifying a parameter, you can either use the form --option=param,
--option param, -o=param, -o param, or -oparam (the latter choices as‐
sume that your option has a short variant).
The parameter may need to be quoted in some manner for it to survive the
shell’s command‐line parsing. Also keep in mind that a leading tilde
(~) in a pathname is substituted by your shell, so make sure that you
separate the option name from the pathname using a space if you want the
local shell to expand it.
--help Print a short help page describing the options available in rsync
and exit. You can also use -h for --help when it is used without
any other options (since it normally means --human‐readable).
--version, -V
Print the rsync version plus other info and exit. When repeated,
the information is output is a JSON format that is still fairly
readable (client side only).
The output includes a list of compiled‐in capabilities, a list of
optimizations, the default list of checksum algorithms, the de‐
fault list of compression algorithms, the default list of daemon
auth digests, a link to the rsync web site, and a few other
items.
--verbose, -v
This option increases the amount of information you are given
during the transfer. By default, rsync works silently. A single
-v will give you information about what files are being trans‐
ferred and a brief summary at the end. Two -v options will give
you information on what files are being skipped and slightly more
information at the end. More than two -v options should only be
used if you are debugging rsync.
The end‐of‐run summary tells you the number of bytes sent to the
remote rsync (which is the receiving side on a local copy), the
number of bytes received from the remote host, and the average
bytes per second of the transferred data computed over the entire
length of the rsync run. The second line shows the total size (in
bytes), which is the sum of all the file sizes that rsync consid‐
ered transferring. It also shows a "speedup" value, which is a
ratio of the total file size divided by the sum of the sent and
received bytes (which is really just a feel‐good bigger‐is‐better
number). Note that these byte values can be made more (or less)
human‐readable by using the --human‐readable (or --no‐human‐read‐
able) options.
In a modern rsync, the -v option is equivalent to the setting of
groups of --info and --debug options. You can choose to use
these newer options in addition to, or in place of using --ver‐
bose, as any fine‐grained settings override the implied settings
of -v. Both --info and --debug have a way to ask for help that
tells you exactly what flags are set for each increase in ver‐
bosity.
However, do keep in mind that a daemon’s "max verbosity" setting
will limit how high of a level the various individual flags can
be set on the daemon side. For instance, if the max is 2, then
any info and/or debug flag that is set to a higher value than
what would be set by -vv will be downgraded to the -vv level in
the daemon’s logging.
--info=FLAGS