NAME    [Toc]    [Back]

       acl_get_entry - Returns a descriptor to an ACL entry

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       acl_entry_t acl_get_entry(
               acl_t acl_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Specifies  the working storage internal representation ACL
       descriptor.

DESCRIPTION    [Toc]    [Back]

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

       The acl_get_entry() function returns a pointer to the next
       entry in the specified ACL.

       Following a  call  to  the  acl_get_fd(),  acl_get_file(),
       acl_from_text(),  or acl_first_entry() function, the first
       call to the acl_get_entry()  function  obtains  the  first
       entry  in  the  ACL.  Subsequent  calls  obtain successive
       entries in the ACL, until  the  last  entry  is  obtained.
       After the last entry has been obtained, the value 0 (zero)
       is returned.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the  acl_get_entry()  function
       returns a pointer to the ACL entry descriptor. If the last
       ACL has already been returned by a previous call  to  this
       function,  or  the  ACL  has  no ACL entries, the function
       returns a value of 0 (zero).  Otherwise, a value  of  NULL
       is returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       The  acl_d  parameter does not refer to a valid ACL structure.
  The position of the ACL entry must be  reset  using
       the acl_first_entry() library routine.

SEE ALSO    [Toc]    [Back]

       acl_init(3),    acl_copy_entry(3),    acl_delete_entry(3),
       acl_get_file(3), acl_get_fd(3), acl_first_entry(3)

       Security



                                                 acl_get_entry(3)