acl_add_perm(3) -- Linux man page

 

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 (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@computer.org .