NAME

acl_init − Allocate and initialize ACL internal working storage

SYNOPSIS

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

LIBRARY

Security Library (libpacl.a)

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

SEE ALSO

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

Security