NAME

acl_get_fd − Retrieves the specified ACL associated with the specified file or directory

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> acl_t acl_get_fd(
int fd);
acl_type_t type_d);

PARAMETERS

fdDesignates the file descriptor of the file or directory to retrieve the ACL from. 

type_dDesignates 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 standard. 

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 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_fd() function sets errno to the corresponding value:

[EACCES]The required access to the file or directory was denied. 

[EBADF]The fd argument is not a valid file descriptor. 

[EINVAL]The argument type_d is not a recognized ACL type. 

[ENOMEM]There is not enough memory available to the process to allocate the working storage. 

[ENOTDIR]The type_d argument indicates a default ACL, and fd does not point to a directory. 

RELATED INFORMATION

acl_get_file(3), acl_set_file(3), acl_set_fd(3),

Security