xref: /freebsd/lib/libc/posix1e/acl_free.3 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1a889d1fbSRobert Watson.\"-
2e4c3e988SRobert Watson.\" Copyright (c) 2000, 2002 Robert N. M. Watson
3a889d1fbSRobert Watson.\" All rights reserved.
4a889d1fbSRobert Watson.\"
5e4c3e988SRobert Watson.\" This software was developed by Robert Watson for the TrustedBSD Project.
6e4c3e988SRobert Watson.\"
7a889d1fbSRobert Watson.\" Redistribution and use in source and binary forms, with or without
8a889d1fbSRobert Watson.\" modification, are permitted provided that the following conditions
9a889d1fbSRobert Watson.\" are met:
10a889d1fbSRobert Watson.\" 1. Redistributions of source code must retain the above copyright
11a889d1fbSRobert Watson.\"    notice, this list of conditions and the following disclaimer.
12a889d1fbSRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright
13a889d1fbSRobert Watson.\"    notice, this list of conditions and the following disclaimer in the
14a889d1fbSRobert Watson.\"    documentation and/or other materials provided with the distribution.
15a889d1fbSRobert Watson.\"
16a889d1fbSRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17a889d1fbSRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18a889d1fbSRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19a889d1fbSRobert Watson.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20a889d1fbSRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21a889d1fbSRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22a889d1fbSRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23a889d1fbSRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24a889d1fbSRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25a889d1fbSRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26a889d1fbSRobert Watson.\" SUCH DAMAGE.
27a889d1fbSRobert Watson.\"
28a889d1fbSRobert Watson.Dd January 28, 2000
29a889d1fbSRobert Watson.Dt ACL_FREE 3
30a307d598SRuslan Ermilov.Os
31a889d1fbSRobert Watson.Sh NAME
32a889d1fbSRobert Watson.Nm acl_free
33f75b050cSAlexey Zelkin.Nd free ACL working state
34f75b050cSAlexey Zelkin.Sh LIBRARY
3531acc836SRuslan Ermilov.Lb libc
36a889d1fbSRobert Watson.Sh SYNOPSIS
3732eef9aeSRuslan Ermilov.In sys/types.h
3832eef9aeSRuslan Ermilov.In sys/acl.h
39a889d1fbSRobert Watson.Ft int
40a889d1fbSRobert Watson.Fn acl_free "void *obj_p"
41a889d1fbSRobert Watson.Sh DESCRIPTION
42a889d1fbSRobert WatsonThe
43a889d1fbSRobert Watson.Fn acl_free
44a889d1fbSRobert Watsoncall allows the freeing of ACL working space, such as is allocated by
45a889d1fbSRobert Watson.Xr acl_dup 3 ,
46a889d1fbSRobert Watsonor
47a889d1fbSRobert Watson.Xr acl_from_text 3 .
48a889d1fbSRobert Watson.Sh IMPLEMENTATION NOTES
49b5c508fbSRuslan Ermilov.Fx Ns 's
50b5c508fbSRuslan Ermilovsupport for POSIX.1e interfaces and features is still under
51a889d1fbSRobert Watsondevelopment at this time.
52a889d1fbSRobert Watson.Sh RETURN VALUES
53b1250632SYaroslav Tykhiy.Rv -std acl_free
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
741a0a9345SRuslan ErmilovPOSIX.1e is described in IEEE POSIX.1e draft 17.
751a0a9345SRuslan ErmilovDiscussion
76a889d1fbSRobert Watsonof the draft continues on the cross-platform POSIX.1e implementation
771a0a9345SRuslan Ermilovmailing list.
781a0a9345SRuslan ErmilovTo join this list, see the
79c32381adSMike Pritchard.Fx
80c32381adSMike PritchardPOSIX.1e implementation
81a889d1fbSRobert Watsonpage for more information.
82a889d1fbSRobert Watson.Sh HISTORY
83c32381adSMike PritchardPOSIX.1e support was introduced in
84c32381adSMike Pritchard.Fx 4.0 ,
85c32381adSMike Pritchardand development continues.
86a889d1fbSRobert Watson.Sh AUTHORS
87c32381adSMike Pritchard.An Robert N M Watson
88