*** UNIX MANUAL PAGE BROWSER ***

acl_get_file(3) Library Functions Manual acl_get_file(3) NAME acl_get_file - Given the pathname to an object, retrieve the designated ACL LIBRARY Security Library (libpacl.a) SYNOPSIS #include <sys/acl.h> acl_t "acl_get_file( char *path_p); acl_type_t type_d); PARAMETERS Designates the pathname to retrieve the ACL from. Designates the type of ACL to retrieve: ACL_TYPE_ACCESS, ACL_TYPE_DEFAULT, or ACL_TYPE_DE- FAULT_DIR. DESCRIPTION NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan- dard. The function may change as the P1003.6 standard is finalized. The acl_get_file() function retrieves the designated ACL via a path- name. The type of ACL being retrieved is designated in acl_type_t. Working system storage is allocated as needed. RETURN VALUES Upon successful completion, the acl_get_file() function returns a pointer to the working storage internal representation copy of the ACL. 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_file() function sets errno to the corresponding value: The required access to the file was denied. The type_d argument is not a recognized ACL type. The path name is longer then allowed. The ob- ject does not exist. There is not enough memory available to the process to allocate the working storage. The argument type_d indicates a default ACL, and path_p does not point to a directory object. RELATED INFORMATION acl_set_file(3), acl_get_entry(3), acl_get_file(3), acl_set_fd(3) Security delim off acl_get_file(3)