acl_get_fd(3)acl_get_fd(3)NAMEacl_get_fd - Retrieves the specified ACL associated with the specified
file or directory
SYNOPSIS
#include <sys/acl.h>
acl_t acl_get_fd(
int fd,
acl_type_t type_d );
LIBRARY
Security Library (libpacl.a)
PARAMETERS
Designates the file descriptor of the file or directory 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_fd() function retrieves the specified ACL for the given
file descriptor. The acl_tag_t field designates if the ACL being
retrieved is an access or default ACL. Working storage is allocated as
needed.
RETURN VALUES
Upon successful completion, the acl_get_fd() 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 work‐
ing 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_fd() function
sets errno to the corresponding value:
The required access to the file or directory was denied. The fd argu‐
ment is not a valid file descriptor. The argument type_d is not a rec‐
ognized ACL type. There is not enough memory available to the process
to allocate the working storage. The type_d argument indicates a
default ACL, and fd does not point to a directory.
SEE ALSOacl_get_file(3), acl_set_file(3), acl_set_fd(3)
Security
acl_get_fd(3)