xref: /freebsd/lib/libc/posix1e/acl_get_permset.3 (revision 32eef9aeb1f39a1623cea55da147c89abbd5b9a5)
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
338480a1ebSRuslan Ermilov.Nd retrieve permission set from an ACL entry
344bf60dfaSChris D. Faulhaber.Sh LIBRARY
3531acc836SRuslan Ermilov.Lb libc
364bf60dfaSChris D. Faulhaber.Sh SYNOPSIS
3732eef9aeSRuslan Ermilov.In sys/types.h
3832eef9aeSRuslan Ermilov.In 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
448480a1ebSRuslan Ermilov.Fa permset_p
454bf60dfaSChris D. Faulhabera descriptor to the permission set in the ACL entry
468480a1ebSRuslan Ermilov.Fa 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.Sh RETURN VALUES
508480a1ebSRuslan Ermilov.Rv -std acl_get_permset
514bf60dfaSChris D. Faulhaber.Sh ERRORS
528480a1ebSRuslan ErmilovThe
534bf60dfaSChris D. Faulhaber.Fn acl_get_permset
548480a1ebSRuslan Ermilovfunction fails if:
554bf60dfaSChris D. Faulhaber.Bl -tag -width Er
564bf60dfaSChris D. Faulhaber.It Bq Er EINVAL
574bf60dfaSChris D. FaulhaberArgument
588480a1ebSRuslan Ermilov.Fa entry_d
594bf60dfaSChris D. Faulhaberis not a valid descriptor for an ACL entry.
604bf60dfaSChris D. Faulhaber.El
614bf60dfaSChris D. Faulhaber.Sh SEE ALSO
624bf60dfaSChris D. Faulhaber.Xr acl 3 ,
634bf60dfaSChris D. Faulhaber.Xr acl_add_perm 3 ,
644bf60dfaSChris D. Faulhaber.Xr acl_clear_perms 3 ,
654bf60dfaSChris D. Faulhaber.Xr acl_delete_perm 3 ,
664bf60dfaSChris D. Faulhaber.Xr acl_set_permset 3 ,
674bf60dfaSChris D. Faulhaber.Xr posix1e 3
684bf60dfaSChris D. Faulhaber.Sh STANDARDS
694bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17.
704bf60dfaSChris D. Faulhaber.Sh HISTORY
714bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in
724bf60dfaSChris D. Faulhaber.Fx 4.0 .
734bf60dfaSChris D. FaulhaberThe
744bf60dfaSChris D. Faulhaber.Fn acl_get_permset
754bf60dfaSChris D. Faulhaberfunction was added in
764bf60dfaSChris D. Faulhaber.Fx 5.0 .
774bf60dfaSChris D. Faulhaber.Sh AUTHORS
784bf60dfaSChris D. FaulhaberThe
794bf60dfaSChris D. Faulhaber.Fn acl_get_permset
804bf60dfaSChris D. Faulhaberfunction was written by
814bf60dfaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org .
82