xref: /freebsd/lib/libc/posix1e/acl_delete_entry.3 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.\"
26ca48e73aSEdward Tomasz Napierala.Dd June 25, 2009
2714721edaSChris D. Faulhaber.Dt ACL_DELETE_ENTRY 3
2814721edaSChris D. Faulhaber.Os
2914721edaSChris D. Faulhaber.Sh NAME
30aa015c8eSEdward Tomasz Napierala.Nm acl_delete_entry ,
31a3fb6da9SGlen Barber.Nm acl_delete_entry_np
32bc057d3dSRuslan Ermilov.Nd delete an ACL entry from an ACL
3314721edaSChris D. Faulhaber.Sh LIBRARY
3431acc836SRuslan Ermilov.Lb libc
3514721edaSChris D. Faulhaber.Sh SYNOPSIS
3632eef9aeSRuslan Ermilov.In sys/types.h
3732eef9aeSRuslan Ermilov.In sys/acl.h
3814721edaSChris D. Faulhaber.Ft int
3914721edaSChris D. Faulhaber.Fn acl_delete_entry "acl_t acl" "acl_entry_t entry_d"
40aa015c8eSEdward Tomasz Napierala.Ft int
41aa015c8eSEdward Tomasz Napierala.Fn acl_delete_entry_np "acl_t acl" "int index"
4214721edaSChris D. Faulhaber.Sh DESCRIPTION
431fae73b1SRuslan ErmilovThe
4414721edaSChris D. Faulhaber.Fn acl_delete_entry
451fae73b1SRuslan Ermilovfunction
4614721edaSChris D. Faulhaberis a POSIX.1e call that removes the ACL entry
47bc057d3dSRuslan Ermilov.Fa entry_d
4814721edaSChris D. Faulhaberfrom ACL
49bc057d3dSRuslan Ermilov.Fa acl .
50aa015c8eSEdward Tomasz NapieralaThe
51aa015c8eSEdward Tomasz Napierala.Fn acl_delete_entry_np
52aa015c8eSEdward Tomasz Napieralafunction is a non-portable version that removes the ACL entry
53aa015c8eSEdward Tomasz Napieralaat position
54aa015c8eSEdward Tomasz Napierala.Fa index
55aa015c8eSEdward Tomasz Napieralafrom ACL
56aa015c8eSEdward Tomasz Napierala.Fa acl .
57aa015c8eSEdward Tomasz NapieralaPositions are numbered starting from zero, i.e. calling
58aa015c8eSEdward Tomasz Napierala.Fn acl_delete_entry_np
59aa015c8eSEdward Tomasz Napieralawith
60aa015c8eSEdward Tomasz Napierala.Fa index
61aa015c8eSEdward Tomasz Napieralaargument equal to zero will remove the first ACL entry.
6214721edaSChris D. Faulhaber.Sh RETURN VALUES
63bc057d3dSRuslan Ermilov.Rv -std acl_delete_entry
6414721edaSChris D. Faulhaber.Sh ERRORS
65bc057d3dSRuslan ErmilovThe
6614721edaSChris D. Faulhaber.Fn acl_delete_entry
67bc057d3dSRuslan Ermilovfunction fails if:
6814721edaSChris D. Faulhaber.Bl -tag -width Er
6914721edaSChris D. Faulhaber.It Bq Er EINVAL
7014721edaSChris D. FaulhaberArgument
71bc057d3dSRuslan Ermilov.Fa acl
721a0a9345SRuslan Ermilovdoes not point to a valid ACL.
731a0a9345SRuslan ErmilovArgument
74bc057d3dSRuslan Ermilov.Fa entry_d
7514721edaSChris D. Faulhaberis not a valid descriptor for an ACL entry in
76bc057d3dSRuslan Ermilov.Fa acl .
77aa015c8eSEdward Tomasz NapieralaArgument
78aa015c8eSEdward Tomasz Napierala.Fa index
79aa015c8eSEdward Tomasz Napieralais out of bounds.
8014721edaSChris D. Faulhaber.El
8114721edaSChris D. Faulhaber.Sh SEE ALSO
8214721edaSChris D. Faulhaber.Xr acl 3 ,
8314721edaSChris D. Faulhaber.Xr acl_copy_entry 3 ,
8414721edaSChris D. Faulhaber.Xr acl_get_entry 3 ,
8514721edaSChris D. Faulhaber.Xr posix1e 3
8614721edaSChris D. Faulhaber.Sh STANDARDS
8714721edaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17.
8814721edaSChris D. Faulhaber.Sh HISTORY
8914721edaSChris D. FaulhaberPOSIX.1e support was introduced in
9014721edaSChris D. Faulhaber.Fx 4.0 .
9114721edaSChris D. FaulhaberThe
9214721edaSChris D. Faulhaber.Fn acl_delete_entry
9314721edaSChris D. Faulhaberfunction was added in
9414721edaSChris D. Faulhaber.Fx 5.0 .
9514721edaSChris D. Faulhaber.Sh AUTHORS
9614721edaSChris D. FaulhaberThe
9714721edaSChris D. Faulhaber.Fn acl_delete_entry
9814721edaSChris D. Faulhaberfunction was written by
99*8fbf3d50SBaptiste Daroussin.An Chris D. Faulhaber Aq Mt jedgar@fxp.org .
100