Content-type: text/html Man page of acl_get_entry

acl_get_entry

Section: C Library Functions (3)
Index Return to Main Contents
 

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 function may change as the P1003.6 standard is finalized.

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

If any of the following conditions occur, the acl_get_entry() function sets errno to the corresponding value:

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 -1 is returned, and errno is set to indicate the error.  

ERRORS

The acl_d parameter does not refer to a valid ACL entry. 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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:12 GMT, October 02, 2010