14bf60dfaSChris D. Faulhaber.\"- 24bf60dfaSChris D. Faulhaber.\" Copyright (c) 2001 Chris D. Faulhaber 34bf60dfaSChris D. Faulhaber.\" All rights reserved. 44bf60dfaSChris D. Faulhaber.\" 54bf60dfaSChris D. Faulhaber.\" Redistribution and use in source and binary forms, with or without 64bf60dfaSChris D. Faulhaber.\" modification, are permitted provided that the following conditions 74bf60dfaSChris D. Faulhaber.\" are met: 84bf60dfaSChris D. Faulhaber.\" 1. Redistributions of source code must retain the above copyright 94bf60dfaSChris D. Faulhaber.\" notice, this list of conditions and the following disclaimer. 104bf60dfaSChris D. Faulhaber.\" 2. Redistributions in binary form must reproduce the above copyright 114bf60dfaSChris D. Faulhaber.\" notice, this list of conditions and the following disclaimer in the 124bf60dfaSChris D. Faulhaber.\" documentation and/or other materials provided with the distribution. 134bf60dfaSChris D. Faulhaber.\" 144bf60dfaSChris D. Faulhaber.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 154bf60dfaSChris D. Faulhaber.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 164bf60dfaSChris 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. 254bf60dfaSChris D. Faulhaber.\" 26ca48e73aSEdward Tomasz Napierala.Dd June 25, 2009 274bf60dfaSChris D. Faulhaber.Dt ACL_CREATE_ENTRY 3 284bf60dfaSChris D. Faulhaber.Os 294bf60dfaSChris D. Faulhaber.Sh NAME 30*5f19e26bSEnji Cooper.Nm acl_create_entry , 31aa015c8eSEdward Tomasz Napierala.Nm acl_create_entry_np 328480a1ebSRuslan Ermilov.Nd create a new ACL entry 334bf60dfaSChris D. Faulhaber.Sh LIBRARY 3431acc836SRuslan Ermilov.Lb libc 354bf60dfaSChris D. Faulhaber.Sh SYNOPSIS 3632eef9aeSRuslan Ermilov.In sys/types.h 3732eef9aeSRuslan Ermilov.In sys/acl.h 384bf60dfaSChris D. Faulhaber.Ft int 394bf60dfaSChris D. Faulhaber.Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p" 40aa015c8eSEdward Tomasz Napierala.Ft int 41aa015c8eSEdward Tomasz Napierala.Fn acl_create_entry_np "acl_t *acl_p" "acl_entry_t *entry_p" "int index" 424bf60dfaSChris D. Faulhaber.Sh DESCRIPTION 431fae73b1SRuslan ErmilovThe 444bf60dfaSChris D. Faulhaber.Fn acl_create_entry 451fae73b1SRuslan Ermilovfunction 464bf60dfaSChris D. Faulhaberis a POSIX.1e call that creates a new ACL entry in the ACL 474bf60dfaSChris D. Faulhaberpointed to by 488480a1ebSRuslan Ermilov.Fa acl_p . 49aa015c8eSEdward Tomasz NapieralaThe 50aa015c8eSEdward Tomasz Napierala.Fn acl_create_entry_np 51aa015c8eSEdward Tomasz Napieralafunction is a non-portable version that creates the ACL entry 52aa015c8eSEdward Tomasz Napieralaat position 53aa015c8eSEdward Tomasz Napierala.Fa index . 54aa015c8eSEdward Tomasz NapieralaPositions are numbered starting from zero, i.e. calling 55aa015c8eSEdward Tomasz Napierala.Fn acl_create_entry_np 56aa015c8eSEdward Tomasz Napieralawith 57aa015c8eSEdward Tomasz Napierala.Fa index 58aa015c8eSEdward Tomasz Napieralaargument equal to zero will prepend the entry to the ACL. 594bf60dfaSChris D. Faulhaber.Sh RETURN VALUES 608480a1ebSRuslan Ermilov.Rv -std acl_create_entry 614bf60dfaSChris D. Faulhaber.Sh ERRORS 628480a1ebSRuslan ErmilovThe 634bf60dfaSChris D. Faulhaber.Fn acl_create_entry 648480a1ebSRuslan Ermilovfunction fails if: 654bf60dfaSChris D. Faulhaber.Bl -tag -width Er 664bf60dfaSChris D. Faulhaber.It Bq Er EINVAL 674bf60dfaSChris D. FaulhaberArgument 688480a1ebSRuslan Ermilov.Fa acl_p 694bf60dfaSChris D. Faulhaberdoes not point to a pointer to a valid ACL. 70aa015c8eSEdward Tomasz NapieralaArgument 71aa015c8eSEdward Tomasz Napierala.Fa index 72aa015c8eSEdward Tomasz Napieralais out of bounds. 734bf60dfaSChris D. Faulhaber.It Bq Er ENOMEM 744bf60dfaSChris D. FaulhaberThe ACL working storage requires more memory than is 754bf60dfaSChris D. Faulhaberallowed by the hardware or system-imposed memory 764bf60dfaSChris D. Faulhabermanagement constraints. 774bf60dfaSChris D. Faulhaber.El 784bf60dfaSChris D. Faulhaber.Sh SEE ALSO 794bf60dfaSChris D. Faulhaber.Xr acl 3 , 804bf60dfaSChris D. Faulhaber.Xr acl_delete_entry 3 , 814bf60dfaSChris D. Faulhaber.Xr acl_get_entry 3 , 824bf60dfaSChris D. Faulhaber.Xr posix1e 3 834bf60dfaSChris D. Faulhaber.Sh STANDARDS 844bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17. 854bf60dfaSChris D. Faulhaber.Sh HISTORY 864bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in 874bf60dfaSChris D. Faulhaber.Fx 4.0 . 884bf60dfaSChris D. FaulhaberThe 894bf60dfaSChris D. Faulhaber.Fn acl_create_entry 904bf60dfaSChris D. Faulhaberfunction was added in 914bf60dfaSChris D. Faulhaber.Fx 5.0 . 924bf60dfaSChris D. Faulhaber.Sh AUTHORS 934bf60dfaSChris D. FaulhaberThe 944bf60dfaSChris D. Faulhaber.Fn acl_create_entry 954bf60dfaSChris D. Faulhaberfunction was written by 968fbf3d50SBaptiste Daroussin.An Chris D. Faulhaber Aq Mt jedgar@fxp.org . 97