ACL_ADD_PERM
Section: C Library Functions (3)
Page Index
BSD mandoc
Linux ACL
NAME
acl_add_perm
- add a permission to an ACL permission set
LIBRARY
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 perm
DESCRIPTION
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_perm
ERRORS
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 ("POSIX.1e", 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 .