Go to main content

man pages section 3: Extended Library Functions, Volume 4

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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 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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe

See Also

acl(7), attributes(7)