1aa015c8eSEdward Tomasz Napierala.\"- 2aa015c8eSEdward Tomasz Napierala.\" Copyright (c) 2008, 2009 Edward Tomasz Napierala 3aa015c8eSEdward Tomasz Napierala.\" 4aa015c8eSEdward Tomasz Napierala.\" Redistribution and use in source and binary forms, with or without 5aa015c8eSEdward Tomasz Napierala.\" modification, are permitted provided that the following conditions 6aa015c8eSEdward Tomasz Napierala.\" are met: 7aa015c8eSEdward Tomasz Napierala.\" 1. Redistributions of source code must retain the above copyright 8aa015c8eSEdward Tomasz Napierala.\" notice, this list of conditions and the following disclaimer. 9aa015c8eSEdward Tomasz Napierala.\" 2. Redistributions in binary form must reproduce the above copyright 10aa015c8eSEdward Tomasz Napierala.\" notice, this list of conditions and the following disclaimer in the 11aa015c8eSEdward Tomasz Napierala.\" documentation and/or other materials provided with the distribution. 12aa015c8eSEdward Tomasz Napierala.\" 13aa015c8eSEdward Tomasz Napierala.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14aa015c8eSEdward Tomasz Napierala.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15aa015c8eSEdward Tomasz Napierala.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16a4481a87SJoel Dahl.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17a4481a87SJoel Dahl.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18a4481a87SJoel Dahl.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19a4481a87SJoel Dahl.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20a4481a87SJoel Dahl.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21a4481a87SJoel Dahl.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22a4481a87SJoel Dahl.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23a4481a87SJoel Dahl.\" SUCH DAMAGE. 24aa015c8eSEdward Tomasz Napierala.\" 25ca48e73aSEdward Tomasz Napierala.Dd June 25, 2009 26aa015c8eSEdward Tomasz Napierala.Dt ACL_GET_BRAND_NP 3 27aa015c8eSEdward Tomasz Napierala.Os 28aa015c8eSEdward Tomasz Napierala.Sh NAME 29aa015c8eSEdward Tomasz Napierala.Nm acl_get_brand_np 30aa015c8eSEdward Tomasz Napierala.Nd retrieve the ACL brand from an ACL entry 31aa015c8eSEdward Tomasz Napierala.Sh LIBRARY 32aa015c8eSEdward Tomasz Napierala.Lb libc 33aa015c8eSEdward Tomasz Napierala.Sh SYNOPSIS 34aa015c8eSEdward Tomasz Napierala.In sys/types.h 35aa015c8eSEdward Tomasz Napierala.In sys/acl.h 36aa015c8eSEdward Tomasz Napierala.Ft int 37aa015c8eSEdward Tomasz Napierala.Fn acl_get_brand_np "acl_t acl" "int *brand_p" 38aa015c8eSEdward Tomasz Napierala.Sh DESCRIPTION 39aa015c8eSEdward Tomasz NapieralaThe 40aa015c8eSEdward Tomasz Napierala.Fn acl_get_brand_np 41aa015c8eSEdward Tomasz Napieralafunction 42aa015c8eSEdward Tomasz Napieralais a non-portable call that returns the ACL brand for the ACL 43aa015c8eSEdward Tomasz Napierala.Fa acl . 44aa015c8eSEdward Tomasz NapieralaUpon successful completion, the location referred to by the argument 45aa015c8eSEdward Tomasz Napierala.Fa brand_p 46aa015c8eSEdward Tomasz Napieralawill be set to the ACL brand of the ACL 47aa015c8eSEdward Tomasz Napierala.Fa acl . 48aa015c8eSEdward Tomasz Napierala.Pp 49aa015c8eSEdward Tomasz NapieralaBranding is an internal mechanism intended to prevent mixing POSIX.1e 50aa015c8eSEdward Tomasz Napieralaand NFSv4 entries by mistake. 51aa015c8eSEdward Tomasz NapieralaIt's also used by the libc to determine how to print out the ACL. 52aa015c8eSEdward Tomasz NapieralaThe first call to function that is specific for one particular brand - POSIX.1e 53aa015c8eSEdward Tomasz Napieralaor NFSv4 - "brands" the ACL. 54aa015c8eSEdward Tomasz NapieralaAfter that, calling function specific to another brand will result in error. 55aa015c8eSEdward Tomasz Napierala.Sh RETURN VALUES 56aa015c8eSEdward Tomasz Napierala.Rv -std acl_get_brand_np 57aa015c8eSEdward Tomasz Napierala.Sh ERRORS 58aa015c8eSEdward Tomasz NapieralaThe 59aa015c8eSEdward Tomasz Napierala.Fn acl_get_brand_np 60aa015c8eSEdward Tomasz Napieralafunction fails if: 61aa015c8eSEdward Tomasz Napierala.Bl -tag -width Er 62aa015c8eSEdward Tomasz Napierala.It Bq Er EINVAL 63aa015c8eSEdward Tomasz NapieralaArgument 64aa015c8eSEdward Tomasz Napierala.Fa acl 65aa015c8eSEdward Tomasz Napieraladoes not point to a valid ACL. 66aa015c8eSEdward Tomasz Napierala.El 67aa015c8eSEdward Tomasz Napierala.Sh SEE ALSO 68aa015c8eSEdward Tomasz Napierala.Xr acl 3 , 69aa015c8eSEdward Tomasz Napierala.Xr posix1e 3 70aa015c8eSEdward Tomasz Napierala.Sh STANDARDS 71aa015c8eSEdward Tomasz NapieralaPOSIX.1e is described in IEEE POSIX.1e draft 17. 72aa015c8eSEdward Tomasz Napierala.Sh HISTORY 73aa015c8eSEdward Tomasz NapieralaPOSIX.1e support was introduced in 74aa015c8eSEdward Tomasz Napierala.Fx 4.0 . 75aa015c8eSEdward Tomasz NapieralaThe 76aa015c8eSEdward Tomasz Napierala.Fn acl_get_brand_np 77aa015c8eSEdward Tomasz Napieralafunction was added in 78aa015c8eSEdward Tomasz Napierala.Fx 8.0 . 79aa015c8eSEdward Tomasz Napierala.Sh AUTHORS 80aa015c8eSEdward Tomasz NapieralaThe 81aa015c8eSEdward Tomasz Napierala.Fn acl_get_brand_np 82aa015c8eSEdward Tomasz Napieralafunction was written by 83*8fbf3d50SBaptiste Daroussin.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org . 84