acl_get.3 (1fae73b137bfc5a237d7258e3c667ba87a36b7ff) acl_get.3 (6394f703dcdf80f1fd010d508645732880f46d93)
1.\"-
1.\"-
2.\" Copyright (c) 2000 Robert N. M. Watson
2.\" Copyright (c) 2000, 2002 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.\"
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.

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

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.\"
26.\" $FreeBSD$
27.\"
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.

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

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.\"
28.\" $FreeBSD$
29.\"
28.Dd January 28, 2000
30.Dd December 29, 2002
29.Dt ACL_GET 3
30.Os
31.Sh NAME
32.Nm acl_get_fd ,
33.Nm acl_get_fd_np ,
31.Dt ACL_GET 3
32.Os
33.Sh NAME
34.Nm acl_get_fd ,
35.Nm acl_get_fd_np ,
34.Nm acl_get_file
36.Nm acl_get_file ,
37.Nm acl_get_link_np
35.Nd get an ACL for a file
36.Sh LIBRARY
37.Lb libc
38.Sh SYNOPSIS
39.In sys/types.h
40.In sys/acl.h
41.Ft acl_t
38.Nd get an ACL for a file
39.Sh LIBRARY
40.Lb libc
41.Sh SYNOPSIS
42.In sys/types.h
43.In sys/acl.h
44.Ft acl_t
42.Fn acl_get_file "const char *path_p" "acl_type_t type"
43.Ft acl_t
44.Fn acl_get_fd "int fd"
45.Ft acl_t
46.Fn acl_get_fd_np "int fd" "acl_type_t type"
45.Fn acl_get_fd "int fd"
46.Ft acl_t
47.Fn acl_get_fd_np "int fd" "acl_type_t type"
48.Ft acl_t
49.Fn acl_get_file "const char *path_p" "acl_type_t type"
50.Ft acl_t
51.Fn acl_get_link_np "const char *path_p" "acl_type_t type"
47.Sh DESCRIPTION
48The
52.Sh DESCRIPTION
53The
49.Fn acl_get_file ,
50.Fn acl_get_fd ,
54.Fn acl_get_fd ,
51and
55.Fn acl_get_file ,
56.Fn acl_get_link_np ,
52.Fn acl_get_fd_np
53each allow the retrieval of an ACL from a file.
54The
57.Fn acl_get_fd_np
58each allow the retrieval of an ACL from a file.
59The
55.Fn acl_get_file
56function
57is a POSIX.1e call that allows the retrieval of a
58specified type of ACL from a file by name;
59.Fn acl_get_fd
60is a POSIX.1e call that allows the retrieval of an ACL of type
61ACL_TYPE_ACCESS
62from a file descriptor.
63The
64.Fn acl_get_fd_np
65function
66is a non-portable form of
67.Fn acl_get_fd
68that allows the retrieval of any type of ACL from a file descriptor.
60.Fn acl_get_fd
61is a POSIX.1e call that allows the retrieval of an ACL of type
62ACL_TYPE_ACCESS
63from a file descriptor.
64The
65.Fn acl_get_fd_np
66function
67is a non-portable form of
68.Fn acl_get_fd
69that allows the retrieval of any type of ACL from a file descriptor.
70.Fn acl_get_file
71is a POSIX.1e call that allows the retrieval of a
72specified type of ACL from a file by name;
73.Fn acl_get_link_np
74is a non-portable variation on
75.Fn acl_get_file
76which does not follow a symlink if the target of the call is a
77symlink.
69.Pp
78.Pp
70This function may cause memory to be allocated. The caller should free
79These functions may cause memory to be allocated. The caller should free
71any releasable memory, when the new ACL is no longer required, by calling
72.Xr acl_free 3
73with the
74.Va (void *)acl_t
75as an argument.
76.Pp
77The ACL in the working storage is an independent copy of the ACL associated
78with the object referred to by

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

134POSIX.1e implementation
135page for more information.
136.Sh HISTORY
137POSIX.1e support was introduced in
138.Fx 4.0 ,
139and development continues.
140.Sh AUTHORS
141.An Robert N M Watson
80any releasable memory, when the new ACL is no longer required, by calling
81.Xr acl_free 3
82with the
83.Va (void *)acl_t
84as an argument.
85.Pp
86The ACL in the working storage is an independent copy of the ACL associated
87with the object referred to by

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

143POSIX.1e implementation
144page for more information.
145.Sh HISTORY
146POSIX.1e support was introduced in
147.Fx 4.0 ,
148and development continues.
149.Sh AUTHORS
150.An Robert N M Watson
142.Sh BUGS
143These features are not yet fully implemented.