NAME

acl_add_perm − Adds a permission to a set of permissions belonging to an ACL entry

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> int acl_add_perm(
acl_permset_t permset_d
acl_perm_t perm_d);

PARAMETERS

permset_dSpecifies the permission set of the working storage internal representation of an ACL entry. 

perm_dSpecifies 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 standard. The function may change as the P1003.6 standard is finalized. 

The acl_add_perm() function adds the permission specified by perm_dcontained in the perms parameter to the permission set referred to by the permset_d parameter.  Any permissions 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:

[EINVAL]The perm_d parameter does not refer to a valid ACL entry.  The permset_d parameter does not contain valid file permission bits.  SH RELATED INFORMATION

acl_clear_perm(3),acl_delete_perm(3), acl_get_permset(3), acl_set_permset(3),acl_get_entry(3)

Security