ACL\_FREE(3) Library Functions Manual ACL\_FREE(3)

# [NAME](#NAME)

`acl_free` — release memory allocated to an ACL data object

# [LIBRARY](#LIBRARY)

Linux Access Control Lists library (libacl, -lacl).

# [SYNOPSIS](#SYNOPSIS)

`#include <sys/types.h>`  
`#include <sys/acl.h>`

`int`  
`acl_free`(`void *obj_p`);

# [DESCRIPTION](#DESCRIPTION)

The [`acl_free`](#acl_free)() function frees any releasable memory currently allocated by to the ACL data object identified by `obj_p`. The argument `obj_p` may identify an ACL, an ACL entry qualifier, or a pointer to a string allocated by the [`acl_to_text`](#acl_to_text)() function.

# [RETURN VALUE](#RETURN_VALUE)

The `acl_free`() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable `errno` is set to indicate the error.

# [ERRORS](#ERRORS)

If any of the following conditions occur, the `acl_free`() function returns the value `-1` and and sets `errno` to the corresponding value:

\[[`EINVAL`](#EINVAL)]

The value of the argument `obj_p` is invalid.

# [STANDARDS](#STANDARDS)

IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)

# [SEE ALSO](#SEE_ALSO)

[acl\_copy\_int(3)](/man/os/acl/acl_copy_int.3), [acl\_create\_entry(3)](/man/os/acl/acl_create_entry.3), [acl\_dup(3)](/man/os/acl/acl_dup.3), [acl\_from\_text(3)](/man/os/acl/acl_from_text.3), [acl\_get\_fd](), [acl\_get\_file(3)](/man/os/acl/acl_get_file.3), [acl\_init(3)](/man/os/acl/acl_init.3), [acl(5)](/man/os/acl/acl.5)

# [AUTHOR](#AUTHOR)

Derived from the FreeBSD manual pages written by Robert N M Watson ⟨rwatson@FreeBSD.org⟩, and adapted for Linux by Andreas Gruenbacher ⟨andreas.gruenbacher@gmail.com⟩.

March 23, 2002 Linux ACL

---

Document: acl_free(3) from acl 2.4.0-r5 (Chainguard OS)
Source: https://git.savannah.nongnu.org/git/acl.git