NAME    [Toc]    [Back]

       acl_init  -  Allocate  and initialize ACL internal working
       storage

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       acl_t acl_init(
               const size_t size );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Specifies the size of the working storage in bytes.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

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

       Security



                                                      acl_init(3)