Home Explore Blog CI



man-pages

58th chunk of `rsync.man`
0c02d110bc0f2aa7d23c347b2b5ab50e9801303b992776460000000100000fc3
 its  connection to an rsync daemon to succeed.  If the
              timeout is reached, rsync exits with an error.

       --address=ADDRESS
              By default rsync will bind to the wildcard address when  connect‐
              ing to an rsync daemon.  The --address option allows you to spec‐
              ify a specific IP address (or hostname) to bind to.

              See also the daemon version of the --address option.

       --port=PORT
              This  specifies  an  alternate TCP port number to use rather than
              the default of 873.  This is only needed if  you  are  using  the
              double‐colon  (::)  syntax to connect with an rsync daemon (since
              the URL syntax has a way to specify the port as  a  part  of  the
              URL).

              See also the daemon version of the --port option.

       --sockopts=OPTIONS
              This  option  can provide endless fun for people who like to tune
              their systems to the utmost degree.  You can  set  all  sorts  of
              socket  options  which  may  make  transfers faster (or slower!).
              Read the manpage for the setsockopt() system call for details  on
              some  of  the options you may be able to set.  By default no spe‐
              cial socket options are set.  This  only  affects  direct  socket
              connections to a remote rsync daemon.

              See also the daemon version of the --sockopts option.

       --blocking‐io
              This  tells  rsync  to  use  blocking I/O when launching a remote
              shell transport.  If the remote shell is  either  rsh  or  remsh,
              rsync  defaults  to  using blocking I/O, otherwise it defaults to
              using non‐blocking I/O. (Note that ssh prefers non‐blocking I/O.)

       --outbuf=MODE
              This sets the output buffering mode.  The mode can be  None  (aka
              Unbuffered),  Line, or Block (aka Full).  You may specify as lit‐
              tle as a single letter for the mode, and use upper or lower case.

              The main use of this option is to change Full buffering  to  Line
              buffering when rsync’s output is going to a file or pipe.

       --itemize‐changes, -i
              Requests  a  simple  itemized  list of the changes that are being
              made to each file, including attribute changes.  This is  exactly
              the same as specifying --out‐format=’%i %n%L’.  If you repeat the
              option,  unchanged files will also be output, but only if the re‐
              ceiving rsync is at least version 2.6.7 (you  can  use  -vv  with
              older  versions  of  rsync,  but that also turns on the output of
              other verbose messages).

              The "%i" escape has a cryptic output that  is  11  letters  long.
              The general format is like the string YXcstpoguax, where Y is re‐
              placed  by  the  type  of update being done, X is replaced by the
              file‐type, and the other letters represent attributes that may be
              output if they are being modified.

              The update types that replace the Y are as follows:

              o      A < means that a file is being transferred to  the  remote
                     host (sent).

              o      A  >  means  that a file is being transferred to the local
                     host (received).

              o      A c means that a local change/creation  is  occurring  for
                     the  item  (such  as  the  creation  of a directory or the
                     changing of a symlink, etc.).

              o      A h means that the item is a hard  link  to  another  item
                     (requires --hard‐links).

              o      A  .  means  that the item is not being updated (though it
                     might have attributes that are being modified).

              o      A * means that the rest

Title: Rsync Options: Socket Tuning, Blocking I/O, Output Buffering, and Itemized Changes
Summary
This section explains several rsync options. It covers `--sockopts`, used for advanced socket tuning to optimize transfers. It describes `--blocking-io`, which forces the use of blocking I/O when launching a remote shell. It then discusses `--outbuf`, used to set the output buffering mode to None, Line, or Block. Finally, it explains `--itemize-changes` (-i), which requests an itemized list of changes being made to each file, including attribute modifications.