summaryrefslogtreecommitdiffstats
path: root/bin/setfacl
diff options
context:
space:
mode:
authorcsjp <csjp@FreeBSD.org>2008-07-06 20:29:35 +0000
committercsjp <csjp@FreeBSD.org>2008-07-06 20:29:35 +0000
commit05c2789f33c730e889d36df7147bfead717bc1e7 (patch)
tree472ab82de1df2339e3d1a2bf45d5fbeee4c08862 /bin/setfacl
parent64ff5656f84549e4571b91718fac257eef278458 (diff)
downloadFreeBSD-src-05c2789f33c730e889d36df7147bfead717bc1e7.zip
FreeBSD-src-05c2789f33c730e889d36df7147bfead717bc1e7.tar.gz
Document default ACLs and how to use them.
MFC after: 1 week
Diffstat (limited to 'bin/setfacl')
-rw-r--r--bin/setfacl/setfacl.116
1 files changed, 16 insertions, 0 deletions
diff --git a/bin/setfacl/setfacl.1 b/bin/setfacl/setfacl.1
index 2e409a4..4e9a951 100644
--- a/bin/setfacl/setfacl.1
+++ b/bin/setfacl/setfacl.1
@@ -234,9 +234,25 @@ ACL entry.
.Pp
Multiple ACL entries specified on the command line are
separated by commas.
+.Pp
+It is possible for files and directories to inherit ACL entries from their
+parent directory. This is accomplished through the use of the default ACL.
+It should be noted that before you can specify a default ACL, the mandatory
+ACL entries for user, group, other and mask must be set. For more details
+see the examples below. Default ACLs can be created by using
+.Fl d .
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
+.Dl setfacl -d -m u::rwx,g::rx,o::rx,mask::rwx dir
+.Dl setfacl -d -m g:admins:rwx dir
+.Pp
+The first command sets the mandatory elements of the default ACL. The second
+command specifies that users in group admins can have read, write, and execute
+permissions for directory named "dir". It should be noted that any files
+or directories created underneath "dir" will inherit these default ACLs upon
+creation.
+.Pp
.Dl setfacl -m u::rwx,g:mail:rw file
.Pp
Sets read, write, and execute permissions for the
OpenPOWER on IntegriCloud