NAME

acl_free − Releases an ACL working storage area previously allocated by acl_init()

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

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

PARAMETERS

acl_dSpecifies the working storage internal representation ACL descriptor. 

DESCRIPTION

NOTE:  This function is based on Draft 13 of the POSIX P1003.6 standard. The function may change as the P1003.6 standard is finalized. 

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 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 parameter does not refer to an ACL allocated by the acl_init() function.

RELATED INFORMATION

acl_init(3), acl_create_entry(3), acl_set_qualifier(3)

Security