acl_get_entry(3)					     Library Functions Manual						  acl_get_entry(3)

NAME

       acl_get_entry - Returns a descriptor to an ACL entry

LIBRARY

       Security Library (libpacl.a)

SYNOPSIS

       #include <sys/acl.h>
       acl_entry_t acl_get_entry(      acl_t acl_d,

PARAMETERS

       Specifies the working storage internal representation ACL descriptor.

DESCRIPTION

       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

       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

       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.

RELATED INFORMATION

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

       Security delim off

																  acl_get_entry(3)