acl_add_perm (3) Linux Manual Page

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 [at] FreeBSD.org , and adapted for Linux by An Andreas Gruenbacher Aq a.gruenbacher [at] bestbits.at .