NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       acl_t acl_get_fd(
               int fd,
               acl_type_t type_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

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

       Security



                                                    acl_get_fd(3)