ACL_TRIVIAL(3SEC) File Access Control Library Functions ACL_TRIVIAL(3SEC)


NAME


acl_trivial - determine whether a file has a trivial ACL

SYNOPSIS


cc [ flag... ] file... -lsec [ library... ]
#include <sys/acl.h>

int acl_trivial(char *path);


DESCRIPTION


The acl_trivial() function is used to determine whether a file has a
trivial ACL. Whether an ACL is trivial depends on the type of the ACL. A
POSIX draft ACL is trivial if it does not have more than MIN_ACL_ENTRIES
entries. An NFSv4/ZFS-style ACL is trivial if it does not have entries
other than owner@, group@, and everyone@, does not have inheritance flags
set, and is ordered in a manner that meets POSIX access control
requirements.

RETURN VALUES


Upon successful completion, acl_trivial() returns 0 if the file's ACL is
trivial and 1 if the file's ACL is not trivial. If it could not be
determined whether a file's ACL is trivial, -1 is returned and errno is
set to indicate the error.

ERRORS


The acl_trivial() function will fail if:

EACCES
A file's ACL could not be read.


ENOENT
A component of path does not name an existing file or path is
an empty string.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


acl(5), attributes(5)


November 24, 2014 ACL_TRIVIAL(3SEC)