acl_trivial(3sec) [opensolaris man page]
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 has greater than MIN_ACL_ENTRIES. An NFSv4/ZFS-style ACL is trivial 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 |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
acl(5), attributes(5) SunOS 5.11 6 Oct 2005 acl_trivial(3SEC)
Check Out this Related Man Page
acl_check(3SEC) File Access Control Library Functions acl_check(3SEC) NAME
acl_check - check the validity of an ACL SYNOPSIS
cc [ flag... ] file... -lsec [ library... ] #include <sys/acl.h> int acl_check(acl_t *aclp, int isdir); DESCRIPTION
The acl_check() function checks the validity of an ACL pointed to by aclp. The isdir argument checks the validity of an ACL that will be applied to a directory. The ACL can be either a POSIX draft ACL as supported by UFS or NFSv4 ACL as supported by ZFS or NFSV4. When the function verifies a POSIX draft ACL, the rules followed are described in aclcheck(3SEC). For NFSv4 ACL, the ACL is verified against the following rules: o The inheritance flags are valid. o The ACL must have at least one ACL entry and no more than {MAX_ACL_ENTRIES}. o The permission field contains only supported permissions. o The entry type is valid. o The flag fields contain only valid flags as supported by NFSv4/ZFS. If any of the above rules are violated, the function fails with errno set to EINVAL. RETURN VALUES
If the ACL is valid, acl_check() returns 0. Otherwise errno is set to EINVAL and the return value is set to one of the following: EACL_INHERIT_ERROR There are invalid inheritance flags specified. EACL_FLAGS_ERROR There are invalid flags specified on the ACL that don't map to supported flags in NFSV4/ZFS ACL model. EACL_ENTRY_ERROR The ACL contains an unknown value in the type field. EACL_MEM_ERROR The system cannot allocate any memory. EACL_INHERIT_NOTDIR Inheritance flags are only allowed for ACLs on directories. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
acl(2), aclcheck(3SEC), aclsort(3SEC), acl(5), attributes(5) SunOS 5.11 22 Apr 2008 acl_check(3SEC)