NAME    [Toc]    [Back]

       acl_get_permset  -  Retrieves a pointer to the permissions
       for a given ACL entry

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       int acl_get_permset(
               acl_entry_t entry_d,
               acl_permset_t *permset_p );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Specifies the descriptor of  a  working  storage  internal
       representation  ACL  entry.   Points to the location where
       the file permissions are to be stored.

DESCRIPTION    [Toc]    [Back]

       NOTE:  This function is based on Draft  13  of  the  POSIX
       P1003.6 standard.

       The  acl_get_permset() function sets the permset_p parameter
 to point to  the  permission  set  of  the  designated
       entry. The permset_p parameter is a pointer to the permission
 set value which  is  a  combination  of  ACL_EXECUTE,
       ACL_WRITE, and ACL_READ.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the acl_get_permset() function
       returns a value of 0 (zero).  Otherwise, a value of -1  is
       returned, and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       If  the  following condition occurs, the acl_get_permset()
       function  sets  errno  to  the  corresponding  value:  The
       entry_d parameter does not refer to a valid ACL entry.

SEE ALSO    [Toc]    [Back]

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

       Security



                                               acl_get_permset(3)