Linux Access Control Lists library (libacl, -lacl).


SYNOPSIS

     int
     acl_add_perm(acl_permset_t permset_d, acl_perm_t perm)


DESCRIPTION

     The acl_add_perm() function adds the permission contained in the argument
     perm to the permission set referred to by the argument permset_d. An at­
     tempt to add a permission that is already contained in the permission set
     is not considered an error.

     Any existing descriptors that refer to permset_d continue to refer to
     that permission set.


RETURN VALUE

     The acl_add_perm() function returns the value 0 if successful; otherwise
     the value -1 is returned and the global variable errno is set to indicate
     the error.


ERRORS

     If any of the following conditions occur, the acl_add_perm() function re­
     turns -1 and sets errno to the corresponding value:

     [EINVAL]      The argument permset_d is not a valid descriptor for a per­
                   mission set within an ACL entry.

                   The argument perm does not contain a valid acl_perm_t val­
                   ue.


STANDARDS

     IEEE Std 1003.1e draft 17 ("POSIX.1e", abandoned)


SEE ALSO

     acl_clear_perms(3),  acl_delete_perm(3),  acl_get_perm(3),
     acl_get_permset(3),  acl_set_permset(3),  acl(5)


AUTHOR

     Derived from the FreeBSD manual pages written by Robert N M Watson
     <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher
     <a.gruenbacher@computer.org>.

 Linux ACL                      March 23, 2002                               1

Man(1) output converted with man2html