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.\" 264bf60dfaSChris D. Faulhaber.\" $FreeBSD$ 274bf60dfaSChris D. Faulhaber.\" 28ca48e73aSEdward Tomasz Napierala.Dd June 25, 2009 294bf60dfaSChris D. Faulhaber.Dt ACL_CREATE_ENTRY 3 304bf60dfaSChris D. Faulhaber.Os 314bf60dfaSChris D. Faulhaber.Sh NAME 324bf60dfaSChris D. Faulhaber.Nm acl_create_entry 33aa015c8eSEdward Tomasz Napierala.Nm acl_create_entry_np 348480a1ebSRuslan Ermilov.Nd create a new ACL entry 354bf60dfaSChris D. Faulhaber.Sh LIBRARY 3631acc836SRuslan Ermilov.Lb libc 374bf60dfaSChris D. Faulhaber.Sh SYNOPSIS 3832eef9aeSRuslan Ermilov.In sys/types.h 3932eef9aeSRuslan Ermilov.In sys/acl.h 404bf60dfaSChris D. Faulhaber.Ft int 414bf60dfaSChris D. Faulhaber.Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p" 42aa015c8eSEdward Tomasz Napierala.Ft int 43aa015c8eSEdward Tomasz Napierala.Fn acl_create_entry_np "acl_t *acl_p" "acl_entry_t *entry_p" "int index" 444bf60dfaSChris D. Faulhaber.Sh DESCRIPTION 451fae73b1SRuslan ErmilovThe 464bf60dfaSChris D. Faulhaber.Fn acl_create_entry 471fae73b1SRuslan Ermilovfunction 484bf60dfaSChris D. Faulhaberis a POSIX.1e call that creates a new ACL entry in the ACL 494bf60dfaSChris D. Faulhaberpointed to by 508480a1ebSRuslan Ermilov.Fa acl_p . 51aa015c8eSEdward Tomasz NapieralaThe 52aa015c8eSEdward Tomasz Napierala.Fn acl_create_entry_np 53aa015c8eSEdward Tomasz Napieralafunction is a non-portable version that creates the ACL entry 54aa015c8eSEdward Tomasz Napieralaat position 55aa015c8eSEdward Tomasz Napierala.Fa index . 56aa015c8eSEdward Tomasz NapieralaPositions are numbered starting from zero, i.e. calling 57aa015c8eSEdward Tomasz Napierala.Fn acl_create_entry_np 58aa015c8eSEdward Tomasz Napieralawith 59aa015c8eSEdward Tomasz Napierala.Fa index 60aa015c8eSEdward Tomasz Napieralaargument equal to zero will prepend the entry to the ACL. 614bf60dfaSChris D. Faulhaber.Sh RETURN VALUES 628480a1ebSRuslan Ermilov.Rv -std acl_create_entry 634bf60dfaSChris D. Faulhaber.Sh ERRORS 648480a1ebSRuslan ErmilovThe 654bf60dfaSChris D. Faulhaber.Fn acl_create_entry 668480a1ebSRuslan Ermilovfunction fails if: 674bf60dfaSChris D. Faulhaber.Bl -tag -width Er 684bf60dfaSChris D. Faulhaber.It Bq Er EINVAL 694bf60dfaSChris D. FaulhaberArgument 708480a1ebSRuslan Ermilov.Fa acl_p 714bf60dfaSChris D. Faulhaberdoes not point to a pointer to a valid ACL. 72aa015c8eSEdward Tomasz NapieralaArgument 73aa015c8eSEdward Tomasz Napierala.Fa index 74aa015c8eSEdward Tomasz Napieralais out of bounds. 754bf60dfaSChris D. Faulhaber.It Bq Er ENOMEM 764bf60dfaSChris D. FaulhaberThe ACL working storage requires more memory than is 774bf60dfaSChris D. Faulhaberallowed by the hardware or system-imposed memory 784bf60dfaSChris D. Faulhabermanagement constraints. 794bf60dfaSChris D. Faulhaber.El 804bf60dfaSChris D. Faulhaber.Sh SEE ALSO 814bf60dfaSChris D. Faulhaber.Xr acl 3 , 824bf60dfaSChris D. Faulhaber.Xr acl_delete_entry 3 , 834bf60dfaSChris D. Faulhaber.Xr acl_get_entry 3 , 844bf60dfaSChris D. Faulhaber.Xr posix1e 3 854bf60dfaSChris D. Faulhaber.Sh STANDARDS 864bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17. 874bf60dfaSChris D. Faulhaber.Sh HISTORY 884bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in 894bf60dfaSChris D. Faulhaber.Fx 4.0 . 904bf60dfaSChris D. FaulhaberThe 914bf60dfaSChris D. Faulhaber.Fn acl_create_entry 924bf60dfaSChris D. Faulhaberfunction was added in 934bf60dfaSChris D. Faulhaber.Fx 5.0 . 944bf60dfaSChris D. Faulhaber.Sh AUTHORS 954bf60dfaSChris D. FaulhaberThe 964bf60dfaSChris D. Faulhaber.Fn acl_create_entry 974bf60dfaSChris D. Faulhaberfunction was written by 984bf60dfaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org . 99