Home Explore Blog CI



man-pages

63th chunk of `rsync.man`
53ffb9fee141f439aa8c3cb3f4b3852e5798662f7dd9f4830000000100000fe8
 bytes received is the count of all non‐message bytes
                     that  rsync  received  by  the client side from the server
                     side. "Non‐message" bytes means that we  don’t  count  the
                     bytes  for  a  verbose message that the server sent to us,
                     which makes the stats more consistent.

       --8‐bit‐output, -8
              This tells rsync to leave all high‐bit  characters  unescaped  in
              the output instead of trying to test them to see if they’re valid
              in the current locale and escaping the invalid ones.  All control
              characters  (but  never  tabs)  are always escaped, regardless of
              this option’s setting.

              The escape idiom that started in 2.6.7 is  to  output  a  literal
              backslash (\) and a hash (#), followed by exactly 3 octal digits.
              For  example, a newline would output as "\#012".  A literal back‐
              slash that is in a filename is not escaped unless it is  followed
              by a hash and 3 digits (0‐9).

       --human‐readable, -h
              Output numbers in a more human‐readable format.  There are 3 pos‐
              sible levels:

              1.     output numbers with a separator between each set of 3 dig‐
                     its (either a comma or a period, depending on if the deci‐
                     mal point is represented by a period or a comma).

              2.     output  numbers  in units of 1000 (with a character suffix
                     for larger units -- see below).

              3.     output numbers in units of 1024.

              The default is human‐readable level 1.  Each -h option  increases
              the  level  by  one.  You can take the level down to 0 (to output
              numbers as pure digits)  by  specifying  the  --no‐human‐readable
              (--no‐h) option.

              The  unit  letters  that  are  appended  in levels 2 and 3 are: K
              (kilo), M (mega), G (giga), T (tera), or P (peta).  For  example,
              a  1234567‐byte  file  would output as 1.23M in level‐2 (assuming
              that a period is your local decimal point).

              Backward compatibility note: versions of rsync prior to 3.1.0  do
              not  support human‐readable level 1, and they default to level 0.
              Thus, specifying one or two -h options will behave in a  compara‐
              ble  manner in old and new versions as long as you didn’t specify
              a --no‐h option prior to one or more -h options.  See the --list‐
              only option for one difference.

       --partial
              By default, rsync will delete any partially transferred  file  if
              the  transfer  is  interrupted.  In some circumstances it is more
              desirable to keep partially transferred files.  Using the  --par‐
              tial  option  tells  rsync  to keep the partial file which should
              make a subsequent transfer of the rest of the file much faster.

       --partial‐dir=DIR
              This option modifies the behavior of the --partial  option  while
              also  implying  that  it  be enabled.  This enhanced partial‐file
              method puts any partially transferred files  into  the  specified
              DIR  instead  of  writing the partial file out to the destination
              file.  On the next transfer, rsync will use a file found in  this
              dir  as  data to speed up the resumption of the transfer and then
              delete it after it has served its purpose.

              Note that if --whole‐file is specified (or implied), any partial‐
              dir files that are found for a file that is  being  updated  will
              simply  be  removed  (since  rsync is sending files without using
              rsync’s delta‐transfer algorithm).

              Rsync will create the DIR if it is missing,

Title: Rsync Options: 8-bit Output, Human-Readable Numbers, Partial Transfers
Summary
This section details several rsync options: `--8-bit-output` to control high-bit character escaping, `--human-readable` to format numbers for easier reading, `--partial` to keep partially transferred files, and `--partial-dir` to store partial files in a specified directory for faster resumption of transfers. It explains how these options affect rsync's behavior and output.