xref: /freebsd/lib/libc/posix1e/acl_delete_entry.3 (revision a3fb6da9ba05cbeeab1d5bec46075916256d2fb0)
114721edaSChris D. Faulhaber.\"-
214721edaSChris D. Faulhaber.\" Copyright (c) 2001 Chris D. Faulhaber
314721edaSChris D. Faulhaber.\" All rights reserved.
414721edaSChris D. Faulhaber.\"
514721edaSChris D. Faulhaber.\" Redistribution and use in source and binary forms, with or without
614721edaSChris D. Faulhaber.\" modification, are permitted provided that the following conditions
714721edaSChris D. Faulhaber.\" are met:
814721edaSChris D. Faulhaber.\" 1. Redistributions of source code must retain the above copyright
914721edaSChris D. Faulhaber.\"    notice, this list of conditions and the following disclaimer.
1014721edaSChris D. Faulhaber.\" 2. Redistributions in binary form must reproduce the above copyright
1114721edaSChris D. Faulhaber.\"    notice, this list of conditions and the following disclaimer in the
1214721edaSChris D. Faulhaber.\"    documentation and/or other materials provided with the distribution.
1314721edaSChris D. Faulhaber.\"
1414721edaSChris D. Faulhaber.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1514721edaSChris D. Faulhaber.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1614721edaSChris D. Faulhaber.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1768b23992SWarner Losh.\" ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
1868b23992SWarner Losh.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1968b23992SWarner Losh.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2068b23992SWarner Losh.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2168b23992SWarner Losh.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2268b23992SWarner Losh.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2368b23992SWarner Losh.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2468b23992SWarner Losh.\" SUCH DAMAGE.
2514721edaSChris D. Faulhaber.\"
2614721edaSChris D. Faulhaber.\" $FreeBSD$
2714721edaSChris D. Faulhaber.\"
28ca48e73aSEdward Tomasz Napierala.Dd June 25, 2009
2914721edaSChris D. Faulhaber.Dt ACL_DELETE_ENTRY 3
3014721edaSChris D. Faulhaber.Os
3114721edaSChris D. Faulhaber.Sh NAME
32aa015c8eSEdward Tomasz Napierala.Nm acl_delete_entry ,
33*a3fb6da9SGlen Barber.Nm acl_delete_entry_np
34bc057d3dSRuslan Ermilov.Nd delete an ACL entry from an ACL
3514721edaSChris D. Faulhaber.Sh LIBRARY
3631acc836SRuslan Ermilov.Lb libc
3714721edaSChris D. Faulhaber.Sh SYNOPSIS
3832eef9aeSRuslan Ermilov.In sys/types.h
3932eef9aeSRuslan Ermilov.In sys/acl.h
4014721edaSChris D. Faulhaber.Ft int
4114721edaSChris D. Faulhaber.Fn acl_delete_entry "acl_t acl" "acl_entry_t entry_d"
42aa015c8eSEdward Tomasz Napierala.Ft int
43aa015c8eSEdward Tomasz Napierala.Fn acl_delete_entry_np "acl_t acl" "int index"
4414721edaSChris D. Faulhaber.Sh DESCRIPTION
451fae73b1SRuslan ErmilovThe
4614721edaSChris D. Faulhaber.Fn acl_delete_entry
471fae73b1SRuslan Ermilovfunction
4814721edaSChris D. Faulhaberis a POSIX.1e call that removes the ACL entry
49bc057d3dSRuslan Ermilov.Fa entry_d
5014721edaSChris D. Faulhaberfrom ACL
51bc057d3dSRuslan Ermilov.Fa acl .
52aa015c8eSEdward Tomasz NapieralaThe
53aa015c8eSEdward Tomasz Napierala.Fn acl_delete_entry_np
54aa015c8eSEdward Tomasz Napieralafunction is a non-portable version that removes the ACL entry
55aa015c8eSEdward Tomasz Napieralaat position
56aa015c8eSEdward Tomasz Napierala.Fa index
57aa015c8eSEdward Tomasz Napieralafrom ACL
58aa015c8eSEdward Tomasz Napierala.Fa acl .
59aa015c8eSEdward Tomasz NapieralaPositions are numbered starting from zero, i.e. calling
60aa015c8eSEdward Tomasz Napierala.Fn acl_delete_entry_np
61aa015c8eSEdward Tomasz Napieralawith
62aa015c8eSEdward Tomasz Napierala.Fa index
63aa015c8eSEdward Tomasz Napieralaargument equal to zero will remove the first ACL entry.
6414721edaSChris D. Faulhaber.Sh RETURN VALUES
65bc057d3dSRuslan Ermilov.Rv -std acl_delete_entry
6614721edaSChris D. Faulhaber.Sh ERRORS
67bc057d3dSRuslan ErmilovThe
6814721edaSChris D. Faulhaber.Fn acl_delete_entry
69bc057d3dSRuslan Ermilovfunction fails if:
7014721edaSChris D. Faulhaber.Bl -tag -width Er
7114721edaSChris D. Faulhaber.It Bq Er EINVAL
7214721edaSChris D. FaulhaberArgument
73bc057d3dSRuslan Ermilov.Fa acl
741a0a9345SRuslan Ermilovdoes not point to a valid ACL.
751a0a9345SRuslan ErmilovArgument
76bc057d3dSRuslan Ermilov.Fa entry_d
7714721edaSChris D. Faulhaberis not a valid descriptor for an ACL entry in
78bc057d3dSRuslan Ermilov.Fa acl .
79aa015c8eSEdward Tomasz NapieralaArgument
80aa015c8eSEdward Tomasz Napierala.Fa index
81aa015c8eSEdward Tomasz Napieralais out of bounds.
8214721edaSChris D. Faulhaber.El
8314721edaSChris D. Faulhaber.Sh SEE ALSO
8414721edaSChris D. Faulhaber.Xr acl 3 ,
8514721edaSChris D. Faulhaber.Xr acl_copy_entry 3 ,
8614721edaSChris D. Faulhaber.Xr acl_get_entry 3 ,
8714721edaSChris D. Faulhaber.Xr posix1e 3
8814721edaSChris D. Faulhaber.Sh STANDARDS
8914721edaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17.
9014721edaSChris D. Faulhaber.Sh HISTORY
9114721edaSChris D. FaulhaberPOSIX.1e support was introduced in
9214721edaSChris D. Faulhaber.Fx 4.0 .
9314721edaSChris D. FaulhaberThe
9414721edaSChris D. Faulhaber.Fn acl_delete_entry
9514721edaSChris D. Faulhaberfunction was added in
9614721edaSChris D. Faulhaber.Fx 5.0 .
9714721edaSChris D. Faulhaber.Sh AUTHORS
9814721edaSChris D. FaulhaberThe
9914721edaSChris D. Faulhaber.Fn acl_delete_entry
10014721edaSChris D. Faulhaberfunction was written by
10114721edaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org .
102