NAME

acl_init − Allocate and initialize ACL working storage

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> acl_t acl_init(
const size_t size);

PARAMETERS

sizeSpecifies the size of the working storage in bytes. 

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_init() function allocates and initializes working storage for an ACL of at least size bytes. A pointer to the working storage is returned.  When the area is first allocated, it contains a ACL that has no ACL entries. 

RETURN VALUES

Upon successful completion, the acl_init() function returns a pointer to the working storage.  Otherwise, a NULL pointer is returned and errno is set to indicate the error. 

ERRORS

If any of the following conditions occur, the acl_init() function returns a value of NULL and sets errno to the corresponding value:

[ENOMEM]The acl_t to be returned requires more memory than allowed by the hardware or system-imposed memory management constraints. 

[ENOSYS]The function is not supported by the implementation. 

RELATED INFORMATION

acl_add_perm(3), acl_clear_perm(3), acl_free(3)

Security