Home Explore Blog CI



man-pages

12th chunk of `rsync.man`
c18537388ae783f175a4c3d0e4e6560f327040b166509bad0000000100000fce
  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
            

Title: Rsync Options: Help, Version, Verbose, and Info
Summary
This section describes the rsync options '--help', '--version', '--verbose', and '--info'. The help option displays a short help page. The version option prints the rsync version and other information, with a JSON format available for repeated use. The verbose option increases the amount of information displayed during the transfer, with multiple '-v' options providing progressively more detail. The info option allows for fine-grained control over the information displayed, and is related to the verbose option. It also covers how to use parameters with short and long options, including quoting and tilde expansion.