acl_copy_ext(3) — Subroutines
NAME
acl_copy_ext − copies the ACL from system managed space to user managed space.
LIBRARY
Security Library (libpacl.a)
SYNOPSIS
#include <sys/acl.h> int acl_copy_ext(
void ∗buf_p,
acl_t acl_d,
ssize_t size);
PARAMETERS
buf_pUser space to copy the data package (contiguous) internal representation of the ACL to.
acl_dSpecifies the working storage internal representation ACL entry in system managed space to copy.
sizeIndicates the size of the buffer pointed to by buf_p.
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_copy_ext() function copies the contents of the ACL in system managed space, pointed to by acl_d, into user space pointed to by buf_p. The ACL copied into user space is contiguous and is not NULL terminated.
RETURN VALUES
Upon successful completion, the acl_copy_entry function returns the size of the ACL copied. Otherwise, a value of -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occur, the acl_copy_ext() function sets errno to the corresponding value:
[EINVAL]The size parameter is zero or negative. The ACL referenced by acl_d contains one or more improperly formed ACL entries, or for some other reason can not be translated into the external format.
[ERANGE]The size parameter is greater then 0 but smaller then the ACL to be copied.
RELATED INFORMATION
Security