Home Explore Blog CI



man-pages

35th chunk of `rsync.man`
44022899456ef236719efc95b131e19fdc7333d3841c52460000000100000fdd
          tion file (if combined with --inplace) or for testing the  check‐
              sum‐based update algorithm.

              See also the --whole‐file option.

       --checksum‐choice=STR, --cc=STR
              This  option overrides the checksum algorithms.  If one algorithm
              name is specified, it is used for both the transfer checksums and
              (assuming --checksum is specified)  the  pre‐transfer  checksums.
              If two comma‐separated names are supplied, the first name affects
              the  transfer  checksums,  and  the  second name affects the pre‐
              transfer checksums (-c).

              The checksum options that you may be able to use are:

              o      auto (the default automatic choice)

              o      xxh128

              o      xxh3

              o      xxh64 (aka xxhash)

              o      md5

              o      md4

              o      sha1

              o      none

              Run rsync --version to see the  default  checksum  list  compiled
              into your version (which may differ from the list above).

              If "none" is specified for the first (or only) name, the --whole‐
              file  option  is  forced  on and no checksum verification is per‐
              formed on the transferred data.  If "none" is specified  for  the
              second (or only) name, the --checksum option cannot be used.

              The "auto" option is the default, where rsync bases its algorithm
              choice on a negotiation between the client and the server as fol‐
              lows:

              When both sides of the transfer are at least 3.2.0, rsync chooses
              the  first algorithm in the client’s list of choices that is also
              in the server’s list of choices.  If no common checksum choice is
              found, rsync exits with an error.  If the remote rsync is too old
              to support checksum negotiation, a value is chosen based  on  the
              protocol  version  (which chooses between MD5 and various flavors
              of MD4 based on protocol age).

              The default order can be customized by  setting  the  environment
              variable RSYNC_CHECKSUM_LIST to a space‐separated list of accept‐
              able  checksum names.  If the string contains a "&" character, it
              is separated into the "client string & server string",  otherwise
              the  same  string applies to both.  If the string (or string por‐
              tion) contains no non‐whitespace characters, the default checksum
              list is used.  This method does not  allow  you  to  specify  the
              transfer  checksum separately from the pre‐transfer checksum, and
              it discards "auto" and all unknown checksum names.  A  list  with
              only invalid names results in a failed negotiation.

              The  use  of the --checksum‐choice option overrides this environ‐
              ment list.

       --one‐file‐system, -x
              This tells rsync to avoid crossing a filesystem boundary when re‐
              cursing.  This does not limit the user’s ability to specify items
              to copy from multiple filesystems, just rsync’s recursion through
              the hierarchy of each directory that the user specified, and also
              the analogous recursion on the receiving  side  during  deletion.
              Also  keep  in  mind that rsync treats a "bind" mount to the same
              device as being on the same filesystem.

              If this option is repeated, rsync omits all mount‐point  directo‐
              ries from the copy.  Otherwise, it includes an empty directory at
              each  mount‐point  it  encounters  (using  the  attributes of the
              mounted directory because those of the underlying mount‐point di‐
              rectory are inaccessible).

              If rsync has been

Title: Rsync Options: Checksum Choice and One File System
Summary
This section describes the '--checksum-choice' option, which allows users to override the checksum algorithms used by rsync, specifying different algorithms for transfer and pre-transfer checksums. It details the available checksum options, including 'auto', 'xxh128', 'xxh3', 'xxh64', 'md5', 'md4', 'sha1', and 'none', and explains how rsync negotiates the checksum algorithm. It also covers the '--one-file-system' option, which prevents rsync from crossing filesystem boundaries during recursion, and its behavior when repeated.