NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       int acl_add_perm(
               acl_permset_t permset_d,
               acl_perm_t perm_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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 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    [Toc]    [Back]

       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    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

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

       Security



                                                  acl_add_perm(3)