1acl_trivial(3SEC) File Access Control Library Functions acl_trivial(3SEC)
2
3
4
6 acl_trivial - determine whether a file has a trivial ACL
7
9 cc [ flag... ] file... -lsec [ library... ]
10 #include <sys/acl.h>
11
12 int acl_trivial(char *path);
13
14
16 The acl_trivial() function is used to determine whether a file has a
17 trivial ACL. Whether an ACL is trivial depends on the type of the ACL.
18 A POSIX draft ACL is trivial if it has greater than MIN_ACL_ENTRIES. An
19 NFSv4/ZFS-style ACL is trivial if it either has entries other than
20 owner@, group@, and everyone@, has inheritance flags set, or is not
21 ordered in a manner that meets POSIX access control requirements.
22
24 Upon successful completion, acl_trivial() returns 0 if the file's ACL
25 is trivial and 1 if the file's ACL is not trivial. If it could not be
26 determined whether a file's ACL is trivial, -1 is returned and errno is
27 set to indicate the error.
28
30 The acl_trivial() function will fail if:
31
32 EACCES A file's ACL could not be read.
33
34
35 ENOENT A component of path does not name an existing file or path is
36 an empty string.
37
38
40 See attributes(5) for descriptions of the following attributes:
41
42
43
44
45 ┌─────────────────────────────┬─────────────────────────────┐
46 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
47 ├─────────────────────────────┼─────────────────────────────┤
48 │Interface Stability │Evolving │
49 ├─────────────────────────────┼─────────────────────────────┤
50 │MT-Level │MT-Safe │
51 └─────────────────────────────┴─────────────────────────────┘
52
54 acl(5), attributes(5)
55
56
57
58SunOS 5.11 6 Oct 2005 acl_trivial(3SEC)