acl_add_perm(3)acl_add_perm(3)NAMEacl_add_perm - Adds a permission to a set of permissions belonging to
an ACL entry
SYNOPSIS
#include <sys/acl.h>
int acl_add_perm(
acl_permset_t permset_d,
acl_perm_t perm_d );
LIBRARY
Security Library (libpacl.a)
PARAMETERS
Specifies the permissions set of the working storage internal represen‐
tation of an ACL entry. Specifies the permission to be added to the
permission set (a combination of ACL_EXECUTE, ACL_WRITE, and ACL_READ).
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan‐
dard.
The acl_add_perm() function adds the permission specified by perm_d to
the permission set referred to by the permset_d parameter. Any permis‐
sions not designated in the perm_d parameter are left unchanged in the
ACL entry. An attempt to add a permission already in the permission set
is not treated as an error.
RETURN VALUES
Upon successful completion, the acl_add_perm() function returns a value
of 0 (zero). Otherwise a value of -1 is returned, and errno is set.
ERRORS
If any of the following conditions occur, the acl_add_perm() function
sets errno to the corresponding value: The perm_d parameter does not
contain a valid acl_perm_t value.
The permset_d parameter does not contain valid file permission
bits.
SEE ALSOacl_clear_perm(3), acl_delete_perm(3), acl_get_permset(3),
acl_set_permset(3), acl_get_entry(3)
Security
acl_add_perm(3)