acl_get.3 (111278) | acl_get.3 (131504) |
---|---|
1.\"- 2.\" Copyright (c) 2000, 2002 Robert N. M. Watson 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 --- 11 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.\" | 1.\"- 2.\" Copyright (c) 2000, 2002 Robert N. M. Watson 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 --- 11 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.\" |
28.\" $FreeBSD: head/lib/libc/posix1e/acl_get.3 111278 2003-02-23 01:43:45Z ru $ | 28.\" $FreeBSD: head/lib/libc/posix1e/acl_get.3 131504 2004-07-02 23:52:20Z ru $ |
29.\" 30.Dd December 29, 2002 31.Dt ACL_GET 3 32.Os 33.Sh NAME 34.Nm acl_get_fd , 35.Nm acl_get_fd_np , 36.Nm acl_get_file , --- 36 unchanged lines hidden (view full) --- 73function is a POSIX.1e call that allows the retrieval of a 74specified type of ACL from a file by name; 75.Fn acl_get_link_np 76is a non-portable variation on 77.Fn acl_get_file 78which does not follow a symlink if the target of the call is a 79symlink. 80.Pp | 29.\" 30.Dd December 29, 2002 31.Dt ACL_GET 3 32.Os 33.Sh NAME 34.Nm acl_get_fd , 35.Nm acl_get_fd_np , 36.Nm acl_get_file , --- 36 unchanged lines hidden (view full) --- 73function is a POSIX.1e call that allows the retrieval of a 74specified type of ACL from a file by name; 75.Fn acl_get_link_np 76is a non-portable variation on 77.Fn acl_get_file 78which does not follow a symlink if the target of the call is a 79symlink. 80.Pp |
81These functions may cause memory to be allocated. The caller should free | 81These functions may cause memory to be allocated. 82The caller should free |
82any releasable memory, when the new ACL is no longer required, by calling 83.Xr acl_free 3 84with the 85.Va (void *)acl_t 86as an argument. 87.Pp 88The ACL in the working storage is an independent copy of the ACL associated 89with the object referred to by 90.Va fd . 91The ACL in the working storage shall not participate in any access control 92decisions. 93.Sh IMPLEMENTATION NOTES 94.Fx Ns 's 95support for POSIX.1e interfaces and features is still under 96development at this time. 97.Sh RETURN VALUES 98Upon successful completion, the function shall return a pointer to the ACL | 83any releasable memory, when the new ACL is no longer required, by calling 84.Xr acl_free 3 85with the 86.Va (void *)acl_t 87as an argument. 88.Pp 89The ACL in the working storage is an independent copy of the ACL associated 90with the object referred to by 91.Va fd . 92The ACL in the working storage shall not participate in any access control 93decisions. 94.Sh IMPLEMENTATION NOTES 95.Fx Ns 's 96support for POSIX.1e interfaces and features is still under 97development at this time. 98.Sh RETURN VALUES 99Upon successful completion, the function shall return a pointer to the ACL |
99that was retrieved. Otherwise, a value of | 100that was retrieved. 101Otherwise, a value of |
100.Va (acl_t)NULL 101shall be returned, and 102.Va errno 103shall be set to indicate the error. 104.Sh ERRORS 105If any of the following conditions occur, the 106.Fn acl_get_fd 107function shall return a value of --- 25 unchanged lines hidden (view full) --- 133.El 134.Sh SEE ALSO 135.Xr acl 3 , 136.Xr acl_free 3 , 137.Xr acl_get 3 , 138.Xr acl_set 3 , 139.Xr posix1e 3 140.Sh STANDARDS | 102.Va (acl_t)NULL 103shall be returned, and 104.Va errno 105shall be set to indicate the error. 106.Sh ERRORS 107If any of the following conditions occur, the 108.Fn acl_get_fd 109function shall return a value of --- 25 unchanged lines hidden (view full) --- 135.El 136.Sh SEE ALSO 137.Xr acl 3 , 138.Xr acl_free 3 , 139.Xr acl_get 3 , 140.Xr acl_set 3 , 141.Xr posix1e 3 142.Sh STANDARDS |
141POSIX.1e is described in IEEE POSIX.1e draft 17. Discussion | 143POSIX.1e is described in IEEE POSIX.1e draft 17. 144Discussion |
142of the draft continues on the cross-platform POSIX.1e implementation | 145of the draft continues on the cross-platform POSIX.1e implementation |
143mailing list. To join this list, see the | 146mailing list. 147To join this list, see the |
144.Fx 145POSIX.1e implementation 146page for more information. 147.Sh HISTORY 148POSIX.1e support was introduced in 149.Fx 4.0 , 150and development continues. 151.Sh AUTHORS 152.An Robert N M Watson | 148.Fx 149POSIX.1e implementation 150page for more information. 151.Sh HISTORY 152POSIX.1e support was introduced in 153.Fx 4.0 , 154and development continues. 155.Sh AUTHORS 156.An Robert N M Watson |