NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

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

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

       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.

SEE ALSO    [Toc]    [Back]

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

       Security



                                               acl_first_entry(3)