NAME
C SYNOPSIS
#include <sys/acl.h>
int acl_get (const char *path, int fd, struct acl *acl,
DESCRIPTION
CAVEAT
DIAGNOSTICS
EINVAL
SEE ALSO

NAME

acl_get - get an XFS access or default ACL

C SYNOPSIS

#include <sys/acl.h>

int acl_get (const char path, int fd, struct acl acl,

struct acl *dacl);

DESCRIPTION

The acl_get system call allows a user to retrieve an access or default ACL for a file/directory given either a file descriptor or path name. The path argument and fd argument provide alternate ways to specify the same file. The acl argument refers to the access ACL and should be preallocated. The dacl argument refers to the default ACL and should be preallocated.

This system call is called from the POSIX ACL functions of
acl_get_fd (3) and
acl_get_file (3). Therefore, direct calling of this system call is not necessary or suggested.

CAVEAT

This ACL system call can be considered a temporary prototype solution and may be altered for a more generic ACL solution in the future.

DIAGNOSTICS

acl_get will return 0 on success, and a negated error code on any failure.

EINVAL

Invalid arguments such as acl and dacl both being NULL, or fd and path either both NULL or both not NULL.