acl_get_fd - Retrieves the specified ACL associated with
the specified file or directory
acl_type_t type_d );
Security Library (libpacl.a)
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
NOTE: This function is based on Draft 13 of the POSIX
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.
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 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.
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 argument is not a valid file descriptor. The argument
type_d is not a recognized 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.
acl_get_file(3), acl_set_file(3), acl_set_fd(3)
[ Back ]