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