NAME    [Toc]    [Back]

       acl_free  -  Releases an ACL internal working storage area
       for an ACL

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       int acl_free(
               acl_t acl_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Specifies the working storage internal representation  ACL
       descriptor.

DESCRIPTION    [Toc]    [Back]

       NOTE:   This  function  is  based on Draft 13 of the POSIX
       P1003.6 standard.

       The acl_free() function releases the system working  storage
  area  associated  with the ACL indicated by the acl_d
       descriptor.   This  space  is  allocated  by   acl_init(),
       acl_create_entry(),       acl_dup(),      acl_from_text(),
       acl_copy_int(),    acl_get_fd(),    acl_get_file(),    and
       acl_set_qualifier().

RETURN VALUES    [Toc]    [Back]

       Upon   successful   completion,  the  acl_free()  function
       returns a value of 0 (zero).  Otherwise, a value of -1  is
       returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       If the following condition occurs, the acl_free() function
       sets errno to the corresponding value: The acl_d  argument
       does not point to a valid ACL structure.

SEE ALSO    [Toc]    [Back]

       acl_init(3),        acl_create_entry(3),       acl_dup(3),
       acl_from_text(3),     acl_copy_int(3),      acl_get_fd(3),
       acl_get_file(3), and acl_set_qualifier(3)

       Security



                                                      acl_free(3)