fs: add support for relative ACL changes

[openafs.git] / doc / man-pages / pod1 / fs_setacl.pod

diff --git a/doc/man-pages/pod1/fs_setacl.pod b/doc/man-pages/pod1/fs_setacl.pod
index cbe0e4d..fea5a5a 100644 (file)
--- a/doc/man-pages/pod1/fs_setacl.pod
+++ b/doc/man-pages/pod1/fs_setacl.pod
@@ -94,7 +94,9 @@ A user name or group name as listed in the Protection Database.
 =item *
 
 One or more ACL permissions, indicated either by combining the individual
-letters or by one of the four acceptable shorthand words.
+letters or by one of the four acceptable shorthand words, optionally
+followed by a single plus (+) or minus (-) chracter to request a relative
+ACL change
 
 =back
 
@@ -296,6 +298,22 @@ and its F<public> subdirectory).
       pat rlidwka
       pat:friends rli
 
+The following example demonstrates the use of the + and - options to
+modfiy ACLs relative to the existing set
+
+   % fs setacl dir . -acl pat:friends r-
+   % fs listacl -path .
+   Access list for . is
+   Normal rights:
+      pat rlidwka
+      pat:friends li
+   % fs setacl dir . acl pat:friends w+
+   % fs listacl -path .
+   Access list for . is
+   Normal rights:
+      pat rlidwka
+      pat:friends wli
+
 =head1 PRIVILEGE REQUIRED
 
 The issuer must have the C<a> (administer) permission on the directory's