acl_get_fd(3)						     Library Functions Manual						     acl_get_fd(3)

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

       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 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:

       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.

RELATED INFORMATION

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

       Security delim off

																     acl_get_fd(3)