1.\" $NetBSD: acl_free.3,v 1.2 2020/06/18 19:46:34 wiz Exp $ 2.\"- 3.\" Copyright (c) 2000, 2002 Robert N. M. Watson 4.\" All rights reserved. 5.\" 6.\" This software was developed by Robert Watson for the TrustedBSD Project. 7.\" 8.\" Redistribution and use in source and binary forms, with or without 9.\" modification, are permitted provided that the following conditions 10.\" are met: 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" notice, this list of conditions and the following disclaimer in the 15.\" documentation and/or other materials provided with the distribution. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" 29.\" $FreeBSD: head/lib/libc/posix1e/acl_free.3 131504 2004-07-02 23:52:20Z ru $ 30.\" 31.Dd January 28, 2000 32.Dt ACL_FREE 3 33.Os 34.Sh NAME 35.Nm acl_free 36.Nd free ACL working state 37.Sh LIBRARY 38.Lb libc 39.Sh SYNOPSIS 40.In sys/types.h 41.In sys/acl.h 42.Ft int 43.Fn acl_free "void *obj_p" 44.Sh DESCRIPTION 45The 46.Fn acl_free 47call allows the freeing of ACL working space, such as is allocated by 48.Xr acl_dup 3 , 49or 50.Xr acl_from_text 3 . 51.Sh IMPLEMENTATION NOTES 52.Fx Ns 's 53support for POSIX.1e interfaces and features is still under 54development at this time. 55.Sh RETURN VALUES 56.Rv -std acl_free 57.Sh ERRORS 58If any of the following conditions occur, the 59.Fn acl_free 60function shall return -1 and set 61.Va errno 62to the corresponding value: 63.Bl -tag -width Er 64.It Bq Er EINVAL 65The value of the 66.Va obj_p 67argument is invalid. 68.El 69.Sh SEE ALSO 70.Xr acl 3 , 71.Xr acl_dup 3 , 72.Xr acl_from_text 3 , 73.Xr acl_get 3 , 74.Xr acl_init 3 , 75.Xr posix1e 3 76.Sh STANDARDS 77POSIX.1e is described in IEEE POSIX.1e draft 17. 78Discussion 79of the draft continues on the cross-platform POSIX.1e implementation 80mailing list. 81To join this list, see the 82.Fx 83POSIX.1e implementation 84page for more information. 85.Sh HISTORY 86POSIX.1e support was introduced in 87.Fx 4.0 , 88and development continues. 89.Sh AUTHORS 90.An Robert N M Watson 91