acl_add_perm(3) 					     Library Functions Manual						   acl_add_perm(3)

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

       Specifies  the permissions set of the working storage internal representation 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 standard.

       The acl_add_perm() function adds the permission specified by perm_d to the permission set referred to by the permset_d parameter.  Any per-
       missions not designated in the perm_d parameter are left unchanged in the ACL entry.  An attempt to add a permission already in the permis-
       sion 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.

RELATED INFORMATION

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

       Security delim off

																   acl_add_perm(3)