Click this button to go to the index for this section.

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
  acl_d	    Specifies the working storage internal representation ACL
	    descriptor.

DESCRIPTION
  NOTE:	 This function is based on Draft 13 of the POSIX P1003.6 standard.
  The function may change as the P1003.6 standard is finalized.

  The acl_first_entry() function rewinds the internal descriptor specified by
  the acl_d  parameter such that a subsequent call to the acl_get_entry()
  function, will access 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:

  [EINVAL]	 The acl_d parameter does not refer to a valid ACL entry.

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

  Security