acl_add_perm (3) - Linux Manuals

acl_add_perm: add a permission to an ACL permission set

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)

AUTHOR

Derived from the FreeBSD manual pages written by An Robert N M Watson Aq rwatson [at] FreeBSD.org , and adapted for Linux by An Andreas Gruenbacher Aq a.gruenbacher [at] bestbits.at .

SEE ALSO

acl_clear_perms3, acl_delete_perm3, acl_get_perm3, acl_get_permset3, acl_set_permset3, acl(5)