acl_init(3)						     Library Functions Manual						       acl_init(3)

NAME

       acl_init - Allocate and initialize ACL internal working storage

LIBRARY

       Security Library (libpacl.a)

SYNOPSIS

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

PARAMETERS

       Specifies 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: The
       acl_t to be returned requires more memory than allowed by the hardware or system-imposed memory management constraints.	 The  function	is
       not supported by the implementation.

RELATED INFORMATION

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

       Security delim off

																       acl_init(3)