osf1 man page for acl_first_entry

acl_first_entry(3)					     Library Functions Manual						acl_first_entry(3)

NAME
       acl_first_entry - Resets the current ACL entry to be the first ACL entry

LIBRARY
       Security Library (libpacl.a)

SYNOPSIS
       #include <sys/acl.h>
       int acl_first_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_first_entry()  function  sets  the  internal  ACL  entry  offset  pointer  of  the  specified  ACL  such that a subsequent call to
       acl_get_entry() for that ACL, returns the first entry in the ACL.

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

ERRORS
       If  any	of  the following conditions occur, the acl_first_entry() function sets errno to the corresponding value: The acl_d parameter does
       not refer to a valid ACL structure.

RELATED INFORMATION
       acl_get_entry(3), acl_copy_entry(3), acl_create_entry(3), acl_delete_entry(3), acl(4)

       Security delim off

																acl_first_entry(3)