NAME    [Toc]    [Back]

       acl_get_file  - Given the pathname to a file or directory,
       retrieve the designated ACL

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       acl_t acl_get_file(
               char *path_p,
               acl_type_t type_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Designates the pathname 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_file()  function retrieves the designated ACL
       via a pathname. The type of ACL being retrieved is  designated
  in  acl_type_t. Working system storage is allocated
       as needed.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion,  the  acl_get_file()  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_file()  function  sets  errno to the corresponding
       value:

       The required access to the file or directory  was  denied.
       The  type_d  argument  is  not a recognized ACL type.  The
       path name is longer than allowed.   The  object  does  not
       exist.   There  is not enough memory available to the process
 to allocate the working storage.  The type_d argument
       indicates  a  default  ACL, and path_p does not point to a
       directory.

SEE ALSO    [Toc]    [Back]

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

       Security



                                                  acl_get_file(3)