Content-type: text/html Man page of acl_first_entry

acl_first_entry

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

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 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: 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 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:38 GMT, October 02, 2010