xref: /freebsd/lib/libc/posix1e/acl_is_trivial_np.3 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1aa015c8eSEdward Tomasz Napierala.\"-
2aa015c8eSEdward Tomasz Napierala.\" Copyright (c) 2008, 2009 Edward Tomasz Napierala
3aa015c8eSEdward Tomasz Napierala.\"
4aa015c8eSEdward Tomasz Napierala.\" This software was developed by Robert Watson for the TrustedBSD Project.
5aa015c8eSEdward Tomasz Napierala.\"
6aa015c8eSEdward Tomasz Napierala.\" Redistribution and use in source and binary forms, with or without
7aa015c8eSEdward Tomasz Napierala.\" modification, are permitted provided that the following conditions
8aa015c8eSEdward Tomasz Napierala.\" are met:
9aa015c8eSEdward Tomasz Napierala.\" 1. Redistributions of source code must retain the above copyright
10aa015c8eSEdward Tomasz Napierala.\"    notice, this list of conditions and the following disclaimer.
11aa015c8eSEdward Tomasz Napierala.\" 2. Redistributions in binary form must reproduce the above copyright
12aa015c8eSEdward Tomasz Napierala.\"    notice, this list of conditions and the following disclaimer in the
13aa015c8eSEdward Tomasz Napierala.\"    documentation and/or other materials provided with the distribution.
14aa015c8eSEdward Tomasz Napierala.\"
15aa015c8eSEdward Tomasz Napierala.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16aa015c8eSEdward Tomasz Napierala.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17aa015c8eSEdward Tomasz Napierala.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18aa015c8eSEdward Tomasz Napierala.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19aa015c8eSEdward Tomasz Napierala.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20aa015c8eSEdward Tomasz Napierala.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21aa015c8eSEdward Tomasz Napierala.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22aa015c8eSEdward Tomasz Napierala.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23aa015c8eSEdward Tomasz Napierala.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24aa015c8eSEdward Tomasz Napierala.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25aa015c8eSEdward Tomasz Napierala.\" SUCH DAMAGE.
26aa015c8eSEdward Tomasz Napierala.\"
27*0e96337bSKyle Evans.Dd June 19, 2023
28*0e96337bSKyle Evans.Dt ACL_IS_TRIVIAL_NP 3
29aa015c8eSEdward Tomasz Napierala.Os
30aa015c8eSEdward Tomasz Napierala.Sh NAME
31aa015c8eSEdward Tomasz Napierala.Nm acl_is_trivial_np
32aa015c8eSEdward Tomasz Napierala.Nd determine whether ACL is trivial
33aa015c8eSEdward Tomasz Napierala.Sh LIBRARY
34aa015c8eSEdward Tomasz Napierala.Lb libc
35aa015c8eSEdward Tomasz Napierala.Sh SYNOPSIS
36aa015c8eSEdward Tomasz Napierala.In sys/types.h
37aa015c8eSEdward Tomasz Napierala.In sys/acl.h
38aa015c8eSEdward Tomasz Napierala.Ft int
39aa015c8eSEdward Tomasz Napierala.Fn acl_is_trivial_np "const acl_t aclp" "int *trivialp"
40aa015c8eSEdward Tomasz Napierala.Sh DESCRIPTION
41aa015c8eSEdward Tomasz NapieralaThe
42*0e96337bSKyle Evans.Fn acl_is_trivial_np
43aa015c8eSEdward Tomasz Napieralafunction determines whether the ACL pointed to by the argument
44aa015c8eSEdward Tomasz Napierala.Va acl
45aa015c8eSEdward Tomasz Napieralais trivial.
46aa015c8eSEdward Tomasz NapieralaUpon successful completion, the location referred to by the argument
47aa015c8eSEdward Tomasz Napierala.Fa trivialp
48aa015c8eSEdward Tomasz Napieralawill be set to 1, if the ACL
49aa015c8eSEdward Tomasz Napierala.Fa aclp
50aa015c8eSEdward Tomasz Napieralapoints to is trivial, or 0 if it's not.
51aa015c8eSEdward Tomasz Napierala.Pp
52a164074fSEitan AdlerACL is trivial if it can be fully expressed as a file mode without losing
53aa015c8eSEdward Tomasz Napieralaany access rules.
54aa015c8eSEdward Tomasz NapieralaFor POSIX.1e ACLs, ACL is trivial if it has the three required entries,
55aa015c8eSEdward Tomasz Napieralaone for owner, one for owning group, and one for other.
56d5767efdSEdward Tomasz NapieralaFor NFSv4 ACLs, ACL is trivial if it is identical to the ACL generated by
57*0e96337bSKyle Evans.Xr acl_strip_np 3 .
58aa015c8eSEdward Tomasz NapieralaFiles that have non-trivial ACL have a plus sign appended after mode bits
59aa015c8eSEdward Tomasz Napieralain "ls -l" output.
60aa015c8eSEdward Tomasz Napierala.Sh RETURN VALUES
61*0e96337bSKyle Evans.Rv -std acl_is_trivial_np
62aa015c8eSEdward Tomasz Napierala.Sh SEE ALSO
63aa015c8eSEdward Tomasz Napierala.Xr acl 3 ,
64*0e96337bSKyle Evans.Xr acl_strip_np 3 ,
65aa015c8eSEdward Tomasz Napierala.Xr posix1e 3
66aa015c8eSEdward Tomasz Napierala.Sh STANDARDS
67aa015c8eSEdward Tomasz NapieralaPOSIX.1e is described in IEEE POSIX.1e draft 17.
68aa015c8eSEdward Tomasz NapieralaDiscussion
69aa015c8eSEdward Tomasz Napieralaof the draft continues on the cross-platform POSIX.1e implementation
70aa015c8eSEdward Tomasz Napieralamailing list.
71aa015c8eSEdward Tomasz NapieralaTo join this list, see the
72aa015c8eSEdward Tomasz Napierala.Fx
73aa015c8eSEdward Tomasz NapieralaPOSIX.1e implementation
74aa015c8eSEdward Tomasz Napieralapage for more information.
75aa015c8eSEdward Tomasz Napierala.Sh HISTORY
76aa015c8eSEdward Tomasz NapieralaPOSIX.1e support was introduced in
77aa015c8eSEdward Tomasz Napierala.Fx 4.0 .
78aa015c8eSEdward Tomasz NapieralaThe
79aa015c8eSEdward Tomasz Napierala.Fn acl_is_trivial_np
80aa015c8eSEdward Tomasz Napieralafunction was added in
81aa015c8eSEdward Tomasz Napierala.Fx 8.0 .
82aa015c8eSEdward Tomasz Napierala.Sh AUTHORS
838fbf3d50SBaptiste Daroussin.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org
84