xref: /freebsd/lib/libc/posix1e/acl_add_flag_np.3 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1aa015c8eSEdward Tomasz Napierala.\"-
2aa015c8eSEdward Tomasz Napierala.\" Copyright (c) 2008, 2009 Edward Tomasz Napierala
3aa015c8eSEdward Tomasz Napierala.\"
4aa015c8eSEdward Tomasz Napierala.\" Redistribution and use in source and binary forms, with or without
5aa015c8eSEdward Tomasz Napierala.\" modification, are permitted provided that the following conditions
6aa015c8eSEdward Tomasz Napierala.\" are met:
7aa015c8eSEdward Tomasz Napierala.\" 1. Redistributions of source code must retain the above copyright
8aa015c8eSEdward Tomasz Napierala.\"    notice, this list of conditions and the following disclaimer.
9aa015c8eSEdward Tomasz Napierala.\" 2. Redistributions in binary form must reproduce the above copyright
10aa015c8eSEdward Tomasz Napierala.\"    notice, this list of conditions and the following disclaimer in the
11aa015c8eSEdward Tomasz Napierala.\"    documentation and/or other materials provided with the distribution.
12aa015c8eSEdward Tomasz Napierala.\"
13aa015c8eSEdward Tomasz Napierala.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14aa015c8eSEdward Tomasz Napierala.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15aa015c8eSEdward Tomasz Napierala.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16a4481a87SJoel Dahl.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17a4481a87SJoel Dahl.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18a4481a87SJoel Dahl.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19a4481a87SJoel Dahl.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20a4481a87SJoel Dahl.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21a4481a87SJoel Dahl.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22a4481a87SJoel Dahl.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23a4481a87SJoel Dahl.\" SUCH DAMAGE.
24aa015c8eSEdward Tomasz Napierala.\"
25*28ffe927SXin LI.Dd September 4, 2015
26aa015c8eSEdward Tomasz Napierala.Dt ACL_ADD_FLAG_NP 3
27aa015c8eSEdward Tomasz Napierala.Os
28aa015c8eSEdward Tomasz Napierala.Sh NAME
29aa015c8eSEdward Tomasz Napierala.Nm acl_add_flag_np
30aa015c8eSEdward Tomasz Napierala.Nd add flags to a flagset
31aa015c8eSEdward Tomasz Napierala.Sh LIBRARY
32aa015c8eSEdward Tomasz Napierala.Lb libc
33aa015c8eSEdward Tomasz Napierala.Sh SYNOPSIS
34aa015c8eSEdward Tomasz Napierala.In sys/types.h
35aa015c8eSEdward Tomasz Napierala.In sys/acl.h
36aa015c8eSEdward Tomasz Napierala.Ft int
37aa015c8eSEdward Tomasz Napierala.Fn acl_add_flag_np "acl_flagset_t flagset_d" "acl_flag_t flag"
38aa015c8eSEdward Tomasz Napierala.Sh DESCRIPTION
39aa015c8eSEdward Tomasz NapieralaThe
40aa015c8eSEdward Tomasz Napierala.Fn acl_add_flag_np
41aa015c8eSEdward Tomasz Napieralafunction
4202c55812SEdward Tomasz Napieralais a non-portable call that adds the NFSv4 ACL flags contained in
43aa015c8eSEdward Tomasz Napierala.Fa flags
44aa015c8eSEdward Tomasz Napieralato the flagset
45aa015c8eSEdward Tomasz Napierala.Fa flagset_d .
46aa015c8eSEdward Tomasz Napierala.Pp
47aa015c8eSEdward Tomasz NapieralaNote: it is not considered an error to attempt to add flags
48aa015c8eSEdward Tomasz Napieralathat already exist in the flagset.
49aa015c8eSEdward Tomasz Napierala.Pp
50aa015c8eSEdward Tomasz NapieralaValid values are:
51aa015c8eSEdward Tomasz Napierala.Bl -column -offset 3n "ACL_ENTRY_NO_PROPAGATE_INHERIT"
52288eac5aSJoel Dahl.It ACL_ENTRY_FILE_INHERIT Ta "Will be inherited by files."
53288eac5aSJoel Dahl.It ACL_ENTRY_DIRECTORY_INHERIT Ta "Will be inherited by directories."
54288eac5aSJoel Dahl.It ACL_ENTRY_NO_PROPAGATE_INHERIT Ta "Will not propagate."
55288eac5aSJoel Dahl.It ACL_ENTRY_INHERIT_ONLY Ta "Inherit-only."
56*28ffe927SXin LI.It ACL_ENTRY_INHERITED Ta "Inherited from parent"
57aa015c8eSEdward Tomasz Napierala.El
58aa015c8eSEdward Tomasz Napierala.Sh RETURN VALUES
59aa015c8eSEdward Tomasz Napierala.Rv -std acl_add_flag_np
60aa015c8eSEdward Tomasz Napierala.Sh ERRORS
61aa015c8eSEdward Tomasz NapieralaThe
62aa015c8eSEdward Tomasz Napierala.Fn acl_add_flag_np
63aa015c8eSEdward Tomasz Napieralafunction fails if:
64aa015c8eSEdward Tomasz Napierala.Bl -tag -width Er
65aa015c8eSEdward Tomasz Napierala.It Bq Er EINVAL
66aa015c8eSEdward Tomasz NapieralaArgument
67aa015c8eSEdward Tomasz Napierala.Fa flagset_d
68aa015c8eSEdward Tomasz Napieralais not a valid descriptor for a flagset within an ACL entry.
69aa015c8eSEdward Tomasz NapieralaArgument
70aa015c8eSEdward Tomasz Napierala.Fa flag
71aa015c8eSEdward Tomasz Napieraladoes not contain a valid
72aa015c8eSEdward Tomasz Napierala.Vt acl_flag_t
73aa015c8eSEdward Tomasz Napieralavalue.
74aa015c8eSEdward Tomasz Napierala.El
75aa015c8eSEdward Tomasz Napierala.Sh SEE ALSO
76aa015c8eSEdward Tomasz Napierala.Xr acl 3 ,
77aa015c8eSEdward Tomasz Napierala.Xr acl_clear_flags_np 3 ,
78aa015c8eSEdward Tomasz Napierala.Xr acl_delete_flag_np 3 ,
79aa015c8eSEdward Tomasz Napierala.Xr acl_get_flagset_np 3 ,
80aa015c8eSEdward Tomasz Napierala.Xr acl_set_flagset_np 3 ,
81aa015c8eSEdward Tomasz Napierala.Xr posix1e 3
82aa015c8eSEdward Tomasz Napierala.Sh STANDARDS
83aa015c8eSEdward Tomasz NapieralaPOSIX.1e is described in IEEE POSIX.1e draft 17.
84aa015c8eSEdward Tomasz Napierala.Sh HISTORY
85aa015c8eSEdward Tomasz NapieralaPOSIX.1e support was introduced in
86aa015c8eSEdward Tomasz Napierala.Fx 4.0 .
87aa015c8eSEdward Tomasz NapieralaThe
88aa015c8eSEdward Tomasz Napierala.Fn acl_add_flag_np
89aa015c8eSEdward Tomasz Napieralafunction was added in
90aa015c8eSEdward Tomasz Napierala.Fx 8.0 .
91aa015c8eSEdward Tomasz Napierala.Sh AUTHORS
92aa015c8eSEdward Tomasz NapieralaThe
93aa015c8eSEdward Tomasz Napierala.Fn acl_add_flag_np
94aa015c8eSEdward Tomasz Napieralafunction was written by
958fbf3d50SBaptiste Daroussin.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org .
96