1a889d1fbSRobert Watson.\"- 2a889d1fbSRobert Watson.\" Copyright (c) 2000 Robert N. M. Watson 3a889d1fbSRobert Watson.\" All rights reserved. 4a889d1fbSRobert Watson.\" 5a889d1fbSRobert Watson.\" Redistribution and use in source and binary forms, with or without 6a889d1fbSRobert Watson.\" modification, are permitted provided that the following conditions 7a889d1fbSRobert Watson.\" are met: 8a889d1fbSRobert Watson.\" 1. Redistributions of source code must retain the above copyright 9a889d1fbSRobert Watson.\" notice, this list of conditions and the following disclaimer. 10a889d1fbSRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright 11a889d1fbSRobert Watson.\" notice, this list of conditions and the following disclaimer in the 12a889d1fbSRobert Watson.\" documentation and/or other materials provided with the distribution. 13a889d1fbSRobert Watson.\" 14a889d1fbSRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15a889d1fbSRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16a889d1fbSRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17a889d1fbSRobert Watson.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18a889d1fbSRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19a889d1fbSRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20a889d1fbSRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21a889d1fbSRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22a889d1fbSRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23a889d1fbSRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24a889d1fbSRobert Watson.\" SUCH DAMAGE. 25a889d1fbSRobert Watson.\" 26a889d1fbSRobert Watson.\" $FreeBSD$ 27a889d1fbSRobert Watson.\" 28a889d1fbSRobert Watson.Dd January 28, 2000 29a889d1fbSRobert Watson.Dt ACL_FREE 3 30a889d1fbSRobert Watson.Os FreeBSD 4.0 31a889d1fbSRobert Watson.Sh NAME 32a889d1fbSRobert Watson.Nm acl_free 33a889d1fbSRobert Watson.Nd Free ACL working state 34a889d1fbSRobert Watson.Sh SYNOPSIS 35a889d1fbSRobert Watson.Fd #include <sys/types.h> 36a889d1fbSRobert Watson.Fd #include <sys/acl.h> 37a889d1fbSRobert Watson.Ft int 38a889d1fbSRobert Watson.Fn acl_free "void *obj_p" 39a889d1fbSRobert Watson.Sh DESCRIPTION 40a889d1fbSRobert WatsonThe 41a889d1fbSRobert Watson.Fn acl_free 42a889d1fbSRobert Watsoncall allows the freeing of ACL working space, such as is allocated by 43a889d1fbSRobert Watson.Xr acl_dup 3 , 44a889d1fbSRobert Watsonor 45a889d1fbSRobert Watson.Xr acl_from_text 3 . 46a889d1fbSRobert Watson.Sh IMPLEMENTATION NOTES 47a889d1fbSRobert WatsonFreeBSD's support for POSIX.1e interfaces and features is still under 48a889d1fbSRobert Watsondevelopment at this time. 49a889d1fbSRobert Watson.Sh RETURN VALUES 50a889d1fbSRobert WatsonIn the event of success, 0 is returned. In the event of failure, -1 is 51a889d1fbSRobert Watsonreturned, and 52a889d1fbSRobert Watson.Va errno 53a889d1fbSRobert Watsonis set to indicate the error. 54a889d1fbSRobert Watson.Sh ERRORS 55a889d1fbSRobert WatsonIf any of the following conditions occur, the 56a889d1fbSRobert Watson.Fn acl_free 57a889d1fbSRobert Watsonfunction shall return -1 and set 58a889d1fbSRobert Watson.Va errno 59a889d1fbSRobert Watsonto the corresponding value: 60a889d1fbSRobert Watson.Bl -tag -width Er 61a889d1fbSRobert Watson.It Bq Er EINVAL 62a889d1fbSRobert WatsonThe value of the 63a889d1fbSRobert Watson.Va obj_p 64a889d1fbSRobert Watsonargument is invalid. 65a889d1fbSRobert Watson.El 66a889d1fbSRobert Watson.Sh SEE ALSO 67a889d1fbSRobert Watson.Xr acl 3 , 68a889d1fbSRobert Watson.Xr acl_dup 3 , 69a889d1fbSRobert Watson.Xr acl_from_text 3 , 70a889d1fbSRobert Watson.Xr acl_get 3 , 71a889d1fbSRobert Watson.Xr acl_init 3 , 72a889d1fbSRobert Watson.Xr posix1e 3 73a889d1fbSRobert Watson.Sh STANDARDS 74a889d1fbSRobert WatsonPOSIX.1e is described in IEEE POSIX.1e draft 17. Discussion 75a889d1fbSRobert Watsonof the draft continues on the cross-platform POSIX.1e implementation 76a889d1fbSRobert Watsonmailing list. To join this list, see the FreeBSD POSIX.1e implementation 77a889d1fbSRobert Watsonpage for more information. 78a889d1fbSRobert Watson.Sh HISTORY 79a889d1fbSRobert WatsonPOSIX.1e support was introduced in FreeBSD 4.0, and development continues. 80a889d1fbSRobert Watson.Sh AUTHORS 81a889d1fbSRobert WatsonRobert N M Watson 82a889d1fbSRobert Watson.Sh BUGS 83a889d1fbSRobert WatsonThese features are not yet fully implemented. In particular, the shipped 84a889d1fbSRobert Watsonversion of UFS/FFS does not support storage of additional security labels, 85a889d1fbSRobert Watsonand so is unable to (easily) provide support for most of these features. 86