xref: /freebsd/lib/libc/posix1e/acl_create_entry.3 (revision 8480a1eb149d512c35d0b6d0d0ae7be2f826c3c5)
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
174bf60dfaSChris D. Faulhaber.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR THE VOICES IN HIS HEAD BE
184bf60dfaSChris D. Faulhaber.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
194bf60dfaSChris D. Faulhaber.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
204bf60dfaSChris D. Faulhaber.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
214bf60dfaSChris D. Faulhaber.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
224bf60dfaSChris D. Faulhaber.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
234bf60dfaSChris D. Faulhaber.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
244bf60dfaSChris D. Faulhaber.\" POSSIBILITY OF SUCH DAMAGE.
254bf60dfaSChris D. Faulhaber.\"
264bf60dfaSChris D. Faulhaber.\" $FreeBSD$
274bf60dfaSChris D. Faulhaber.\"
284bf60dfaSChris D. Faulhaber.Dd March 16, 2001
294bf60dfaSChris D. Faulhaber.Dt ACL_CREATE_ENTRY 3
304bf60dfaSChris D. Faulhaber.Os
314bf60dfaSChris D. Faulhaber.Sh NAME
324bf60dfaSChris D. Faulhaber.Nm acl_create_entry
338480a1ebSRuslan Ermilov.Nd create a new ACL entry
344bf60dfaSChris D. Faulhaber.Sh LIBRARY
354bf60dfaSChris D. Faulhaber.Lb libposix1e
364bf60dfaSChris D. Faulhaber.Sh SYNOPSIS
374bf60dfaSChris D. Faulhaber.Fd #include <sys/types.h>
384bf60dfaSChris D. Faulhaber.Fd #include <sys/acl.h>
394bf60dfaSChris D. Faulhaber.Ft int
404bf60dfaSChris D. Faulhaber.Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p"
414bf60dfaSChris D. Faulhaber.Sh DESCRIPTION
424bf60dfaSChris D. Faulhaber.Fn acl_create_entry
434bf60dfaSChris D. Faulhaberis a POSIX.1e call that creates a new ACL entry in the ACL
444bf60dfaSChris D. Faulhaberpointed to by
458480a1ebSRuslan Ermilov.Fa acl_p .
464bf60dfaSChris D. Faulhaber.Sh RETURN VALUES
478480a1ebSRuslan Ermilov.Rv -std acl_create_entry
484bf60dfaSChris D. Faulhaber.Sh ERRORS
498480a1ebSRuslan ErmilovThe
504bf60dfaSChris D. Faulhaber.Fn acl_create_entry
518480a1ebSRuslan Ermilovfunction fails if:
524bf60dfaSChris D. Faulhaber.Bl -tag -width Er
534bf60dfaSChris D. Faulhaber.It Bq Er EINVAL
544bf60dfaSChris D. FaulhaberArgument
558480a1ebSRuslan Ermilov.Fa acl_p
564bf60dfaSChris D. Faulhaberdoes not point to a pointer to a valid ACL.
574bf60dfaSChris D. Faulhaber.It Bq Er ENOMEM
584bf60dfaSChris D. FaulhaberThe ACL working storage requires more memory than is
594bf60dfaSChris D. Faulhaberallowed by the hardware or system-imposed memory
604bf60dfaSChris D. Faulhabermanagement constraints.
614bf60dfaSChris D. Faulhaber.El
624bf60dfaSChris D. Faulhaber.Sh SEE ALSO
634bf60dfaSChris D. Faulhaber.Xr acl 3 ,
644bf60dfaSChris D. Faulhaber.Xr acl_delete_entry 3 ,
654bf60dfaSChris D. Faulhaber.Xr acl_get_entry 3 ,
664bf60dfaSChris D. Faulhaber.Xr posix1e 3
674bf60dfaSChris D. Faulhaber.Sh STANDARDS
684bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17.
694bf60dfaSChris D. Faulhaber.Sh HISTORY
704bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in
714bf60dfaSChris D. Faulhaber.Fx 4.0 .
724bf60dfaSChris D. FaulhaberThe
734bf60dfaSChris D. Faulhaber.Fn acl_create_entry
744bf60dfaSChris D. Faulhaberfunction was added in
754bf60dfaSChris D. Faulhaber.Fx 5.0 .
764bf60dfaSChris D. Faulhaber.Sh AUTHORS
774bf60dfaSChris D. FaulhaberThe
784bf60dfaSChris D. Faulhaber.Fn acl_create_entry
794bf60dfaSChris D. Faulhaberfunction was written by
804bf60dfaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org .
81