Index Index for
Section 3
Index Alphabetical
listing for A
Index Bottom of
page		 

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

  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 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

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

  [ENOPOSIT]	 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

Index Index for
Section 3
Index Alphabetical
listing for A
Index Top of
page