ACL\_COPY\_INT(3) Library Functions Manual ACL\_COPY\_INT(3) # [NAME](#NAME) `acl_copy_int` — copy an ACL from external to internal representation # [LIBRARY](#LIBRARY) Linux Access Control Lists library (libacl, -lacl). # [SYNOPSIS](#SYNOPSIS) `#include ` `#include ` `acl_t` `acl_copy_int`(`const void *buf_p`); # [DESCRIPTION](#DESCRIPTION) The [`acl_copy_int`](#acl_copy_int)() function copies an exportable, contiguous, persistent form of an ACL, pointed to by `buf_p`, to the internal representation. This function may cause memory to be allocated. The caller should free any releasable memory, when the new ACL is no longer required, by calling [acl\_free(3)](/man/os/acl/acl_free.3) with the `(void*)acl_t` returned by [`acl_copy_int`](#acl_copy_int~2)() as an argument. # [RETURN VALUE](#RETURN_VALUE) Upon success, the `acl_copy_int`() function returns a pointer that references the ACL in working storage. On error, a value of `(acl_t)NULL` is returned, and `errno` is set appropriately. # [ERRORS](#ERRORS) If any of the following conditions occur, the `acl_copy_int`() function returns a value of `(acl_t)NULL` and sets `errno` to the corresponding value: \[[`EINVAL`](#EINVAL)] The buffer pointed to by the argument `buf_p` does not contain a valid external form ACL. \[[`ENOMEM`](#ENOMEM)] The ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints. # [STANDARDS](#STANDARDS) IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned) # [SEE ALSO](#SEE_ALSO) [acl\_copy\_ext(3)](/man/os/acl/acl_copy_ext.3), [acl\_get\_entry(3)](/man/os/acl/acl_get_entry.3), [acl\_free(3)](/man/os/acl/acl_free.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_copy_int(3) from acl 2.4.0-r5 (Chainguard OS) Source: https://git.savannah.nongnu.org/git/acl.git