1aa015c8eSEdward Tomasz Napierala.\"- 2aa015c8eSEdward Tomasz Napierala.\" Copyright (c) 2008, 2009 Edward Tomasz Napierala 3aa015c8eSEdward Tomasz Napierala.\" 4aa015c8eSEdward Tomasz Napierala.\" This software was developed by Robert Watson for the TrustedBSD Project. 5aa015c8eSEdward Tomasz Napierala.\" 6aa015c8eSEdward Tomasz Napierala.\" Redistribution and use in source and binary forms, with or without 7aa015c8eSEdward Tomasz Napierala.\" modification, are permitted provided that the following conditions 8aa015c8eSEdward Tomasz Napierala.\" are met: 9aa015c8eSEdward Tomasz Napierala.\" 1. Redistributions of source code must retain the above copyright 10aa015c8eSEdward Tomasz Napierala.\" notice, this list of conditions and the following disclaimer. 11aa015c8eSEdward Tomasz Napierala.\" 2. Redistributions in binary form must reproduce the above copyright 12aa015c8eSEdward Tomasz Napierala.\" notice, this list of conditions and the following disclaimer in the 13aa015c8eSEdward Tomasz Napierala.\" documentation and/or other materials provided with the distribution. 14aa015c8eSEdward Tomasz Napierala.\" 15aa015c8eSEdward Tomasz Napierala.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16aa015c8eSEdward Tomasz Napierala.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17aa015c8eSEdward Tomasz Napierala.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18aa015c8eSEdward Tomasz Napierala.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19aa015c8eSEdward Tomasz Napierala.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20aa015c8eSEdward Tomasz Napierala.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21aa015c8eSEdward Tomasz Napierala.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22aa015c8eSEdward Tomasz Napierala.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23aa015c8eSEdward Tomasz Napierala.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24aa015c8eSEdward Tomasz Napierala.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25aa015c8eSEdward Tomasz Napierala.\" SUCH DAMAGE. 26aa015c8eSEdward Tomasz Napierala.\" 27ca48e73aSEdward Tomasz Napierala.Dd June 25, 2009 28aa015c8eSEdward Tomasz Napierala.Dt ACL_STRIP_NP 3 29aa015c8eSEdward Tomasz Napierala.Os 30aa015c8eSEdward Tomasz Napierala.Sh NAME 31aa015c8eSEdward Tomasz Napierala.Nm acl_strip_np 32edfa427cSJoel Dahl.Nd strip extended entries from an ACL 33aa015c8eSEdward Tomasz Napierala.Sh LIBRARY 34aa015c8eSEdward Tomasz Napierala.Lb libc 35aa015c8eSEdward Tomasz Napierala.Sh SYNOPSIS 36aa015c8eSEdward Tomasz Napierala.In sys/types.h 37aa015c8eSEdward Tomasz Napierala.In sys/acl.h 38aa015c8eSEdward Tomasz Napierala.Ft acl_t 39aa015c8eSEdward Tomasz Napierala.Fn acl_strip_np "const acl_t acl" "int recalculate_mask" 40aa015c8eSEdward Tomasz Napierala.Sh DESCRIPTION 41aa015c8eSEdward Tomasz NapieralaThe 42aa015c8eSEdward Tomasz Napierala.Fn acl_strip_np 43aa015c8eSEdward Tomasz Napieralafunction returns a pointer to a trivial ACL computed from the ACL pointed 44aa015c8eSEdward Tomasz Napieralato by the argument 45aa015c8eSEdward Tomasz Napierala.Va acl . 46aa015c8eSEdward Tomasz Napierala.Pp 47aa015c8eSEdward Tomasz NapieralaThis function may cause memory to be allocated. 48aa015c8eSEdward Tomasz NapieralaThe caller should free any 49aa015c8eSEdward Tomasz Napieralareleasable memory, when the new ACL is no longer required, by calling 50aa015c8eSEdward Tomasz Napierala.Xr acl_free 3 51aa015c8eSEdward Tomasz Napieralawith the 52aa015c8eSEdward Tomasz Napierala.Va (void*)acl_t 53aa015c8eSEdward Tomasz Napieralaas an argument. 54aa015c8eSEdward Tomasz Napierala.Pp 55aa015c8eSEdward Tomasz NapieralaAny existing ACL pointers that refer to the ACL referred to by 56aa015c8eSEdward Tomasz Napierala.Va acl 57aa015c8eSEdward Tomasz Napieralashall continue to refer to the ACL. 58aa015c8eSEdward Tomasz Napierala.Sh RETURN VALUES 59aa015c8eSEdward Tomasz NapieralaUpon successful completion, this function shall return a pointer to the 60aa015c8eSEdward Tomasz Napieralanewly allocated ACL. 61aa015c8eSEdward Tomasz NapieralaOtherwise, a value of 62aa015c8eSEdward Tomasz Napierala.Va (acl_t)NULL 63aa015c8eSEdward Tomasz Napieralashall be returned, and 64aa015c8eSEdward Tomasz Napierala.Va errno 65aa015c8eSEdward Tomasz Napieralashall be set to indicate the error. 66aa015c8eSEdward Tomasz Napierala.Sh ERRORS 67aa015c8eSEdward Tomasz NapieralaIf any of the following conditions occur, the 68aa015c8eSEdward Tomasz Napierala.Fn acl_init 69aa015c8eSEdward Tomasz Napieralafunction shall return a value of 70aa015c8eSEdward Tomasz Napierala.Va (acl_t)NULL 71aa015c8eSEdward Tomasz Napieralaand set 72aa015c8eSEdward Tomasz Napierala.Va errno 73aa015c8eSEdward Tomasz Napieralato the corresponding value: 74aa015c8eSEdward Tomasz Napierala.Bl -tag -width Er 75aa015c8eSEdward Tomasz Napierala.It Bq Er EINVAL 76aa015c8eSEdward Tomasz NapieralaArgument 77aa015c8eSEdward Tomasz Napierala.Va acl 78aa015c8eSEdward Tomasz Napieraladoes not point to a valid ACL. 79aa015c8eSEdward Tomasz Napierala.It Bq Er ENOMEM 80aa015c8eSEdward Tomasz NapieralaThe 81aa015c8eSEdward Tomasz Napierala.Va acl_t 82aa015c8eSEdward Tomasz Napieralato be returned requires more memory than is allowed by the hardware or 83aa015c8eSEdward Tomasz Napieralasystem-imposed memory management constraints. 84aa015c8eSEdward Tomasz Napierala.El 85aa015c8eSEdward Tomasz Napierala.Sh SEE ALSO 86aa015c8eSEdward Tomasz Napierala.Xr acl 3 , 87aa015c8eSEdward Tomasz Napierala.Xr acl_is_trivial_np 3 , 88aa015c8eSEdward Tomasz Napierala.Xr posix1e 3 89aa015c8eSEdward Tomasz Napierala.Sh STANDARDS 90aa015c8eSEdward Tomasz NapieralaPOSIX.1e is described in IEEE POSIX.1e draft 17. 91aa015c8eSEdward Tomasz NapieralaDiscussion 92aa015c8eSEdward Tomasz Napieralaof the draft continues on the cross-platform POSIX.1e implementation 93aa015c8eSEdward Tomasz Napieralamailing list. 94aa015c8eSEdward Tomasz NapieralaTo join this list, see the 95aa015c8eSEdward Tomasz Napierala.Fx 96aa015c8eSEdward Tomasz NapieralaPOSIX.1e implementation 97aa015c8eSEdward Tomasz Napieralapage for more information. 98aa015c8eSEdward Tomasz Napierala.Sh HISTORY 99aa015c8eSEdward Tomasz NapieralaPOSIX.1e support was introduced in 100aa015c8eSEdward Tomasz Napierala.Fx 4.0 . 101aa015c8eSEdward Tomasz NapieralaThe 102aa015c8eSEdward Tomasz Napierala.Fn acl_strip_np 103aa015c8eSEdward Tomasz Napieralafunction was added in 104aa015c8eSEdward Tomasz Napierala.Fx 8.0 . 105aa015c8eSEdward Tomasz Napierala.Sh AUTHORS 106*8fbf3d50SBaptiste Daroussin.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org 107