acl_dup.3 (1a0a934547909744a6a2fa4cfd5b795ec6394f05) acl_dup.3 (a889d1fb766450bff9b27c3bccfe18fc39cd753d)
1.\"-
1.\"-
2.\" Copyright (c) 2000, 2002 Robert N. M. Watson
2.\" Copyright (c) 2000 Robert N. M. Watson
3.\" All rights reserved.
4.\"
3.\" All rights reserved.
4.\"
5.\" This software was developed by Robert Watson for the TrustedBSD Project.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\" notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\" notice, this list of conditions and the following disclaimer in the
14.\" documentation and/or other materials provided with the distribution.

--- 5 unchanged lines hidden (view full) ---

20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
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.

--- 5 unchanged lines hidden (view full) ---

18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
28.\" $FreeBSD$
26.\" $FreeBSD$
29.\"
30.Dd January 28, 2000
31.Dt ACL_DUP 3
27.\"
28.Dd January 28, 2000
29.Dt ACL_DUP 3
32.Os
30.Os FreeBSD 4.0
33.Sh NAME
34.Nm acl_dup
31.Sh NAME
32.Nm acl_dup
35.Nd duplicate an ACL
36.Sh LIBRARY
37.Lb libc
33.Nd Duplicate an ACL
38.Sh SYNOPSIS
34.Sh SYNOPSIS
39.In sys/types.h
40.In sys/acl.h
35.Fd #include <sys/types.h>
36.Fd #include <sys/acl.h>
41.Ft acl_t
42.Fn acl_dup "acl_t acl"
43.Sh DESCRIPTION
44The
45.Fn acl_dup
46function returns a pointer to a copy of the ACL pointed to by the argument
47.Va acl .
37.Ft acl_t
38.Fn acl_dup "acl_t acl"
39.Sh DESCRIPTION
40The
41.Fn acl_dup
42function returns a pointer to a copy of the ACL pointed to by the argument
43.Va acl .
48.Pp
49This function may cause memory to be allocated.
50The caller should free any
51releasable memory, when the new ACL is no longer required, by calling
44
45This function may cause memory to be allocated. Teh caller should free any
46releaseable memory, when the new ACL is no longer required, by calling
52.Xr acl_free 3
53with the
54.Va (void*)acl_t
55as an argument.
47.Xr acl_free 3
48with the
49.Va (void*)acl_t
50as an argument.
56.Pp
51
57Any existing ACL pointers that refer to the ACL referred to by
58.Va acl
59shall continue to refer to the ACL.
60.Sh IMPLEMENTATION NOTES
52Any existing ACL pointers that refer to the ACL referred to by
53.Va acl
54shall continue to refer to the ACL.
55.Sh IMPLEMENTATION NOTES
61.Fx Ns 's
62support for POSIX.1e interfaces and features is still under
56FreeBSD's support for POSIX.1e interfaces and features is still under
63development at this time.
64.Sh RETURN VALUES
65Upon successful completion, this function shall return a pointer to the
57development at this time.
58.Sh RETURN VALUES
59Upon successful completion, this function shall return a pointer to the
66duplicate ACL.
67Otherwise, a value of
60duplicate ACL. Otherwise, a value of
68.Va (acl_t)NULL
69shall be returned, and
70.Va errno
71shall be set to indicate the error.
72.Sh ERRORS
73If any of the following conditions occur, the
74.Fn acl_init
75function shall return a value of

--- 13 unchanged lines hidden (view full) ---

89system-imposed memory management constraints.
90.El
91.Sh SEE ALSO
92.Xr acl 3 ,
93.Xr acl_free 3 ,
94.Xr acl_get 3 ,
95.Xr posix1e 3
96.Sh STANDARDS
61.Va (acl_t)NULL
62shall be returned, and
63.Va errno
64shall be set to indicate the error.
65.Sh ERRORS
66If any of the following conditions occur, the
67.Fn acl_init
68function shall return a value of

--- 13 unchanged lines hidden (view full) ---

82system-imposed memory management constraints.
83.El
84.Sh SEE ALSO
85.Xr acl 3 ,
86.Xr acl_free 3 ,
87.Xr acl_get 3 ,
88.Xr posix1e 3
89.Sh STANDARDS
97POSIX.1e is described in IEEE POSIX.1e draft 17.
98Discussion
90POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion
99of the draft continues on the cross-platform POSIX.1e implementation
91of the draft continues on the cross-platform POSIX.1e implementation
100mailing list.
101To join this list, see the
102.Fx
103POSIX.1e implementation
92mailing list. To join this list, see the FreeBSD POSIX.1e implementation
104page for more information.
105.Sh HISTORY
93page for more information.
94.Sh HISTORY
106POSIX.1e support was introduced in
107.Fx 4.0 ,
108and development continues.
95POSIX.1e support was introduced in FreeBSD 4.0, and development continues.
109.Sh AUTHORS
96.Sh AUTHORS
110.An Robert N M Watson
97Robert N M Watson
98.Sh BUGS
99These features are not yet fully implemented. In particular, the shipped
100version of UFS/FFS does not support storage of additional security labels,
101and so is unable to (easily) provide support for most of these features.