acl_from_mode_np3
Create an acl from status information
Usage
#include <sys/types.h>
#include <sys/acl.h>
acl_t
acl_from_mode_np(const mode_t mode);
Library
Standard C Library (libc, -lc)
Overview
The acl_from_mode_np() function is a non-portable call that converts the permissions set referred to by mode into the corresponding minimal ACL structure, appropriate for applying to files or manipulating.
This function causes memory to be allocated. The caller should free any free-able memory, when the new ACL is no longer required, by calling acl_free(3) with the (void *)acl_t as an argument.
Return values
Upon successful completion, the function returns a pointer to the internal representation of the ACL in working storage. Otherwise, a value of (acl_t)NULL is returned, and errno is set to indicate the error.
Errors
If any of the following conditions occur, the acl_from_mode_np() function returns a value of (acl_t)NULL and set errno to the corresponding value:
- [ENOMEM]
-
The ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints.
Releases
Unchanged in 9 releases since FreeBSD 14.0-RELEASE.