acl_get_file(3)acl_get_file(3)NAMEacl_get_file - Given the pathname to a file or directory, retrieve the
designated ACL
SYNOPSIS
#include <sys/acl.h>
acl_t acl_get_file(
char *path_p,
acl_type_t type_d );
LIBRARY
Security Library (libpacl.a)
PARAMETERS
Designates the pathname to retrieve the ACL from. Designates the type
of ACL to retrieve: ACL_TYPE_ACCESS, ACL_TYPE_DEFAULT, or
ACL_TYPE_DEFAULT_DIR.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan‐
dard.
The acl_get_file() function retrieves the designated ACL via a path‐
name. The type of ACL being retrieved is designated in acl_type_t.
Working system storage is allocated as needed.
RETURN VALUES
Upon successful completion, the acl_get_file() function returns a
pointer to the working storage internal representation copy of the ACL.
If the specified ACL type is ACL_TYPE_DEFAULT or ACL_TYPE_DEFAULT_DIR
and the specified ACL doesn't exist for the given file descriptor a
value of NULL is returned. If the specified ACL type is
ACL_TYPE_ACCESS and the given file descriptor doesn't have an access
ACL a pointer to the working storage internal representation copy of
the permission bits in ACL format is returned. Otherwise, a value of
NULL is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occur, the acl_get_file() function
sets errno to the corresponding value:
The required access to the file or directory was denied. The type_d
argument is not a recognized ACL type. The path name is longer than
allowed. The object does not exist. There is not enough memory avail‐
able to the process to allocate the working storage. The type_d argu‐
ment indicates a default ACL, and path_p does not point to a directory.
SEE ALSOacl_set_file(3), acl_get_entry(3), acl_get_file(3), acl_set_fd(3)
Security
acl_get_file(3)