Get the ACL for a given path
#include <sys/acl.h> acl_t acl_get_file( const char *path_p, acl_type_t type );
- The path that you want to get the ACL for.
- The type of ACL; this must currently be ACL_TYPE_ACCESS.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The acl_get_file() function gets the ACL associated with the given file or directory, copies it into working storage, and returns a pointer to that storage. When you're finished with the ACL, you should call acl_free() to release it.
A pointer to the ACL in working storage, or NULL if an error occurred (errno is set).
- Search permission was denied for a component of the path prefix, or the object exists and the process doesn't have the appropriate access rights.
- The type argument isn't ACL_TYPE_ACCESS.
- The length of the path_p argument exceeds PATH_MAX.
- The named object doesn't exist, or path_p is an empty string.
- There wasn't enough memory available to create the ACL in working storage.
- A component of the path prefix isn't a directory.
This function is based on the withdrawn POSIX draft P1003.1e.