doc/man/apply-default-acl.1

   1 .TH apply-default-acl 1
   2
   3 .SH NAME
   4 apply-default-acl \- Apply default POSIX ACLs to files and directories.
   5
   6 .SH SYNOPSIS
   7
   8 \fBapply-default-acl\fR [\fB-rx\fR] \fIpath\fR [\fIpath2 ...\fR]
   9
  10 .SH DESCRIPTION
  11
  12 .P
  13 If the directory containing \fIpath\fR has a default ACL, the ACL on
  14 \fIpath\fR is replaced with that default. Neither symbolic nor hard
  15 links are followed.
  16
  17 .P
  18 By default, a heuristic is used to determine whether or not the
  19 execute bit is masked on \fIpath\fR. If \fIpath\fR is not a directory,
  20 and no user or group has \fBeffective\fR execute permissions on
  21 \fIpath\fR, then the execute bit will not masked. Otherwise, it is
  22 left alone. In effect we pretend that the \fBx\fR permission acts like
  23 the \fBX\fR (note the case difference) permission of \fBsetfacl\fR.
  24
  25 .P
  26 This behavior can be modified with the \fB--no-exec-mask\fR flag.
  27
  28 .SH OPTIONS
  29
  30 .IP \fB\-\-recursive\fR,\ \fB\-r\fR
  31 Apply default ACLs recursively. This works top-down, so if directory
  32 \fBfoo\fR is in another directory \fBbar\fR which has a default ACL,
  33 then \fBbar\fR's default ACL will be applied to \fBfoo\fR before the
  34 contents of \fBfoo\fR are processed.
  35
  36 .IP \fB\-\-no-exec-mask\fR,\ \fB\-x\fR
  37 Apply the default ACL literally; that is, don't use a heuristic to
  38 decide whether or not to mask the execute bit. This usually results in
  39 looser-than-necessary execute permissions.