| Standards / Extensions | C or C++ | Dependencies |
|---|---|---|
z/OS UNIX |
both | z/OS V1R3 |
#define _OPEN_SYS 1
#include <sys/acl.h>
int acl_free (lacl_t acl_d);Use access control lists (ACLs) in conjunction with permission bits to control access to files and directories. Currently, ACLs are supported by the HFS, TFS, and zFS file systems. You must know whether your security product supports ACLs and what rules are used when determining file access. See z/OS UNIX System Services Planning for details.
The acl_free() function frees any releasable memory currently allocated to the ACL data object identified by acl_d. Use of the object reference pointed to by acl_d after the memory has been released is undefined.
Upon successful completion, the function returns a value of zero.
If any of the following conditions occur, the acl_free() function returns -1 and sets errno to the corresponding value: