acl_get.3 (108037) | acl_get.3 (108410) |
---|---|
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. --- 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.\" | 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.\" |
26.\" $FreeBSD: head/lib/libc/posix1e/acl_get.3 108037 2002-12-18 12:45:11Z ru $ | 28.\" $FreeBSD: head/lib/libc/posix1e/acl_get.3 108410 2002-12-29 20:47:05Z rwatson $ |
27.\" | 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. | |