Home Explore Blog CI



man-pages

60th chunk of `rsync.man`
ec9591543c698b9e56c90707fa3079befa1dfc2917c85f200000000100000fe9
 client, you might see the
                     s flag combined with t instead of the proper  T  flag  for
                     this time‐setting failure.)

              o      A  p means the permissions are different and are being up‐
                     dated to the sender’s value (requires --perms).

              o      An o means the owner is different and is being updated  to
                     the sender’s value (requires --owner and super‐user privi‐
                     leges).

              o      A  g  means the group is different and is being updated to
                     the sender’s value (requires --group and the authority  to
                     set the group).

              o

                     o      A u|n|b indicates the following information:

                            u   means the access (use) time is different and is
                            being  updated  to  the  sender’s  value  (requires
                            --atimes)

                     o      n  means the create time (newness) is different and
                            is being updated to the  sender’s  value  (requires
                            --crtimes)

                     o      b  means  that both the access and create times are
                            being updated

              o      The a means that the ACL information is being changed.

              o      The x means that the extended attribute information is be‐
                     ing changed.

              One other output is possible: when deleting files, the "%i"  will
              output the string "*deleting" for each item that is being removed
              (assuming  that  you are talking to a recent enough rsync that it
              logs deletions instead of outputting them as a verbose message).

       --out‐format=FORMAT
              This allows you to specify exactly what the rsync client  outputs
              to  the  user on a per‐update basis.  The format is a text string
              containing embedded single‐character  escape  sequences  prefixed
              with  a percent (%) character.  A default format of "%n%L" is as‐
              sumed if either --info=name or -v is specified  (this  tells  you
              just  the  name  of the file and, if the item is a link, where it
              points).  For a full list of the possible escape characters,  see
              the log format setting in the rsyncd.conf manpage.

              Specifying  the  --out‐format  option implies the --info=name op‐
              tion, which will mention each file, dir, etc. that  gets  updated
              in a significant way (a transferred file, a recreated symlink/de‐
              vice,  or  a  touched  directory).   In addition, if the itemize‐
              changes escape (%i) is  included  in  the  string  (e.g.  if  the
              --itemize‐changes  option  was  used),  the  logging of names in‐
              creases to mention any item that is changed in any way  (as  long
              as  the  receiving  side  is at least 2.6.4).  See the --itemize‐
              changes option for a description of the output of "%i".

              Rsync will output the out‐format string prior to a file’s  trans‐
              fer unless one of the transfer‐statistic escapes is requested, in
              which case the logging is done at the end of the file’s transfer.
              When this late logging is in effect and --progress is also speci‐
              fied,  rsync  will  also output the name of the file being trans‐
              ferred prior to its progress information (followed, of course, by
              the out‐format output).

       --log‐file=FILE
              This option causes rsync to log what it is doing to a file.  This
              is similar to the logging that a daemon  does,  but  can  be  re‐
              quested  for the client side and/or the server side of a non‐dae‐
              mon transfer.  If specified

Title: Rsync Itemized Changes Output Continued, Out-Format, and Log-File Options
Summary
This section continues the detailed explanation of rsync's itemized changes output, focusing on access, create, and combined times (u, n, b), ACL changes (a), and extended attribute changes (x). It also describes the '*deleting' output for deleted files. Then, the documentation covers the `--out-format` option, which allows users to customize the output format with embedded escape sequences. Finally, the `--log-file` option is explained, enabling rsync to log its activity to a specified file, similar to daemon logging.