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 10, 2001 294bf60dfaSChris D. Faulhaber.Dt ACL_GET_PERMSET 3 304bf60dfaSChris D. Faulhaber.Os 314bf60dfaSChris D. Faulhaber.Sh NAME 324bf60dfaSChris D. Faulhaber.Nm acl_get_permset 334bf60dfaSChris D. Faulhaber.Nd Retrieve permset from an 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_get_permset "acl_entry_t entry_d" "acl_permset_t *permset_p" 414bf60dfaSChris D. Faulhaber.Sh DESCRIPTION 424bf60dfaSChris D. Faulhaber.Fn acl_get_permset 434bf60dfaSChris D. Faulhaberis a POSIX.1e call that returns via 444bf60dfaSChris D. Faulhaber.Ar permset_p 454bf60dfaSChris D. Faulhabera descriptor to the permission set in the ACL entry 464bf60dfaSChris D. Faulhaber.Ar entry_d . 474bf60dfaSChris D. FaulhaberSubsequent operations using the returned permission set operate 484bf60dfaSChris D. Faulhaberon the permission set within the ACL entry. 494bf60dfaSChris D. Faulhaber.Ar perm . 504bf60dfaSChris D. Faulhaber.Sh RETURN VALUES 514bf60dfaSChris D. FaulhaberUpon successful completion, the function will return a value of 524bf60dfaSChris D. Faulhaber.Va 0 . 534bf60dfaSChris D. FaulhaberOtherwise, a value of 544bf60dfaSChris D. Faulhaber.Va -1 554bf60dfaSChris D. Faulhaberwill be returned, and 564bf60dfaSChris D. Faulhaber.Va errno 574bf60dfaSChris D. Faulhaberwill be set to indicate the error. 584bf60dfaSChris D. Faulhaber.Sh ERRORS 594bf60dfaSChris D. FaulhaberIf the following condition occurs, the 604bf60dfaSChris D. Faulhaber.Fn acl_get_permset 614bf60dfaSChris D. Faulhaberfunction will return a value of 624bf60dfaSChris D. Faulhaber.Va -1 634bf60dfaSChris D. Faulhaberand set 644bf60dfaSChris D. Faulhaber.Va errno 654bf60dfaSChris D. Faulhaberto the corresponding value: 664bf60dfaSChris D. Faulhaber.Bl -tag -width Er 674bf60dfaSChris D. Faulhaber.It Bq Er EINVAL 684bf60dfaSChris D. FaulhaberArgument 694bf60dfaSChris D. Faulhaber.Ar entry_d 704bf60dfaSChris D. Faulhaberis not a valid descriptor for an ACL entry. 714bf60dfaSChris D. Faulhaber.El 724bf60dfaSChris D. Faulhaber.Sh SEE ALSO 734bf60dfaSChris D. Faulhaber.Xr acl 3 , 744bf60dfaSChris D. Faulhaber.Xr acl_add_perm 3 , 754bf60dfaSChris D. Faulhaber.Xr acl_clear_perms 3 , 764bf60dfaSChris D. Faulhaber.Xr acl_delete_perm 3 , 774bf60dfaSChris D. Faulhaber.Xr acl_set_permset 3 , 784bf60dfaSChris D. Faulhaber.Xr posix1e 3 794bf60dfaSChris D. Faulhaber.Sh STANDARDS 804bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17. 814bf60dfaSChris D. Faulhaber.Sh HISTORY 824bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in 834bf60dfaSChris D. Faulhaber.Fx 4.0 . 844bf60dfaSChris D. FaulhaberThe 854bf60dfaSChris D. Faulhaber.Fn acl_get_permset 864bf60dfaSChris D. Faulhaberfunction was added in 874bf60dfaSChris D. Faulhaber.Fx 5.0 . 884bf60dfaSChris D. Faulhaber.Sh AUTHORS 894bf60dfaSChris D. FaulhaberThe 904bf60dfaSChris D. Faulhaber.Fn acl_get_permset 914bf60dfaSChris D. Faulhaberfunction was written by 924bf60dfaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org . 93