NAME

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

SYNOPSIS

#include <sys/acl.h>
int acl_free(
        acl_t acl_d );

LIBRARY

Security Library (libpacl.a)

PARAMETERS

acl_d
Specifies the working storage internal representation ACL descriptor.

DESCRIPTION

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

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

If the following condition occurs, the acl_free() function sets errno to the corresponding value:

[EINVAL]
The acl_d argument does not point to a valid ACL structure. 

SEE ALSO

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