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

path_pDesignates the pathname 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 function may change as the P1003.6 standard is finalized. 

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

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:

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

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

[ENAMETOOLONG]The path name is longer then allowed. 

[ENOENT]The object does not exist. 

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

[ENOTDIR]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