acl_trivial(3SEC) File Access Control Library Functions acl_trivial(3SEC)NAMEacl_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 nontrivial if it has greater than MIN_ACL_ENTRIES.
An NFSv4/ZFS-style ACL is nontrivial if it either has entries other
than owner@, group@, and everyone@, has inheritance flags set, or is
not 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 │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOacl(5), attributes(5)SunOS 5.10 16 Jun 2011 acl_trivial(3SEC)