Home Explore Blog CI



man-pages

28th chunk of `rsync.man`
ccc698be64614a2dd57f12e7e152cde25307951ea320dafb0000000100001006
       cursive option.

       --perms, -p
              This  option  causes  the  receiving rsync to set the destination
              permissions to be the same as the source permissions.  (See  also
              the --chmod option for a way to modify what rsync considers to be
              the source permissions.)

              When this option is off, permissions are set as follows:

              o      Existing  files (including updated files) retain their ex‐
                     isting  permissions,  though  the  --executability  option
                     might change just the execute permission for the file.

              o      New  files  get  their "normal" permission bits set to the
                     source file’s permissions masked with the receiving direc‐
                     tory’s default permissions (either the receiving process’s
                     umask, or the permissions specified  via  the  destination
                     directory’s  default  ACL),  and  their special permission
                     bits disabled except in the case where a new directory in‐
                     herits a setgid bit from its parent directory.

              Thus, when --perms and --executability are both disabled, rsync’s
              behavior is the same as that of other file‐copy  utilities,  such
              as cp(1) and tar(1).

              In  summary:  to  give  destination  files (both old and new) the
              source permissions, use --perms.  To give new files the  destina‐
              tion‐default   permissions  (while  leaving  existing  files  un‐
              changed), make sure that  the  --perms  option  is  off  and  use
              --chmod=ugo=rwX  (which  ensures that all non‐masked bits get en‐
              abled).  If you’d care to make this  latter  behavior  easier  to
              type,  you could define a popt alias for it, such as putting this
              line in the file ~/.popt (the following defines  the  -Z  option,
              and  includes  --no‐g to use the default group of the destination
              dir):

                  rsync alias ‐Z ‐‐no‐p ‐‐no‐g ‐‐chmod=ugo=rwX

              You could then use this new option in a command such as this one:

                  rsync ‐avZ src/ dest/

              (Caveat: make sure that -a does not follow -Z, or it will  re‐en‐
              able the two --no‐* options mentioned above.)

              The preservation of the destination’s setgid bit on newly‐created
              directories  when --perms is off was added in rsync 2.6.7.  Older
              rsync versions erroneously preserved the three special permission
              bits for newly‐created files when --perms was off, while overrid‐
              ing the destination’s setgid bit setting on a  newly‐created  di‐
              rectory.   Default  ACL observance was added to the ACL patch for
              rsync 2.6.7, so older (or non‐ACL‐enabled) rsyncs use  the  umask
              even  if  default ACLs are present.  (Keep in mind that it is the
              version of the receiving rsync that affects these behaviors.)

       --executability, -E
              This option causes rsync to preserve the executability  (or  non‐
              executability)  of  regular files when --perms is not enabled.  A
              regular file is considered to be executable if at least  one  ’x’
              is  turned  on  in its permissions.  When an existing destination
              file’s executability  differs  from  that  of  the  corresponding
              source file, rsync modifies the destination file’s permissions as
              follows:

              o      To make a file non‐executable, rsync turns off all its ’x’
                     permissions.

              o      To make a file executable, rsync turns on each ’x’ permis‐
                     sion that has a corresponding ’r’ permission enabled.

              If --perms is enabled,

Title: Rsync Options: Permissions and Executability (Continued)
Summary
This section continues the explanation of the '--perms' option, detailing how rsync sets permissions when it's disabled: existing files retain permissions, new files are masked by the destination directory's defaults, and special permission bits are handled. It also illustrates how to achieve similar behavior to 'cp' or 'tar' when '--perms' is off. Then, it introduces the '--executability' option, which preserves the executability of files when '--perms' is disabled by toggling 'x' permissions based on corresponding 'r' permissions.