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