1 .\" Access Control Lists manual pages
3 .\" (C) 2002 Andreas Gruenbacher, <a.gruenbacher@bestbits.at>
5 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
6 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
7 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
9 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
10 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
11 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
12 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
13 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
14 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22 .Nd add a permission to an ACL permission set
24 Linux Access Control Lists library (libacl, \-lacl).
29 .Fn acl_add_perm "acl_permset_t permset_d" "acl_perm_t perm"
33 function adds the permission contained in the argument
35 to the permission set referred to by the argument
37 An attempt to add a permission that is already contained in the permission
38 set is not considered an error.
40 Any existing descriptors that refer to
42 continue to refer to that permission set.
46 If any of the following conditions occur, the
52 to the corresponding value:
57 is not a valid descriptor for a permission set within an ACL entry.
61 does not contain a valid
66 IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned)
68 .Xr acl_clear_perms 3 ,
69 .Xr acl_delete_perm 3 ,
71 .Xr acl_get_permset 3 ,
72 .Xr acl_set_permset 3 ,
75 Derived from the FreeBSD manual pages written by
76 .An "Robert N M Watson" Aq rwatson@FreeBSD.org ,
77 and adapted for Linux by
78 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .