www.LinuxHowtos.org
ACL_ADD_PERM
Section: C Library Functions (3)Index Return to Main Contents
BSD mandoc
Linux ACL
NAME
acl_add_perm - add a permission to an ACL permission setLIBRARY
Linux Access Control Lists library (libacl, -lacl).SYNOPSIS
In sys/types.h In sys/acl.h Ft int Fn acl_add_perm acl_permset_t permset_d acl_perm_t permDESCRIPTION
The Fn acl_add_perm function adds the permission contained in the argument perm to the permission set referred to by the argument permset_d An attempt 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
Rv -std acl_add_permERRORS
If any of the following conditions occur, the Fn acl_add_perm function returns -1 and sets errno to the corresponding value:- Bq Er EINVAL
-
The argument
permset_d
is not a valid descriptor for a permission set within an ACL entry.
The argument perm does not contain a valid acl_perm_t value.
STANDARDS
IEEE Std 1003.1e draft 17 (lqPOSIX.1erq, abandoned)SEE ALSO
acl_clear_perms3, acl_delete_perm3, acl_get_perm3, acl_get_permset3, acl_set_permset3, acl(5)AUTHOR
Derived from the FreeBSD manual pages written by An Robert N M Watson Aq rwatson@FreeBSD.org , and adapted for Linux by An Andreas Gruenbacher Aq a.gruenbacher@bestbits.at .