xref: /freebsd/lib/libc/posix1e/acl_set_qualifier.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 10, 2001
294bf60dfaSChris D. Faulhaber.Dt ACL_SET_QUALIFIER 3
304bf60dfaSChris D. Faulhaber.Os
314bf60dfaSChris D. Faulhaber.Sh NAME
324bf60dfaSChris D. Faulhaber.Nm acl_set_qualifier
338480a1ebSRuslan Ermilov.Nd set ACL tag qualifier
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
408480a1ebSRuslan Ermilov.Fn acl_set_qualifier "acl_entry_t entry_d" "const void *tag_qualifier_p"
414bf60dfaSChris D. Faulhaber.Sh DESCRIPTION
424bf60dfaSChris D. Faulhaber.Fn acl_set_qualifier
434bf60dfaSChris D. Faulhaberis a POSIX.1e call that sets the qualifier of the tag for the ACl entry
448480a1ebSRuslan Ermilov.Fa entry_d
454bf60dfaSChris D. Faulhaberto the value referred to by
468480a1ebSRuslan Ermilov.Fa tag_qualifier_p .
474bf60dfaSChris D. Faulhaber.Sh RETURN VALUES
488480a1ebSRuslan Ermilov.Rv -std acl_set_qualifier
494bf60dfaSChris D. Faulhaber.Sh ERRORS
508480a1ebSRuslan ErmilovThe
514bf60dfaSChris D. Faulhaber.Fn acl_set_qualifier
528480a1ebSRuslan Ermilovfunction fails if:
534bf60dfaSChris D. Faulhaber.Bl -tag -width Er
544bf60dfaSChris D. Faulhaber.It Bq Er EINVAL
554bf60dfaSChris D. FaulhaberArgument
568480a1ebSRuslan Ermilov.Fa entry_d
574bf60dfaSChris D. Faulhaberis not a valid descriptor for an ACL entry.  The tag type of the
584bf60dfaSChris D. FaulhaberACL entry
598480a1ebSRuslan Ermilov.Fa entry_d
608480a1ebSRuslan Ermilovis not
618480a1ebSRuslan Ermilov.Dv ACL_USER
628480a1ebSRuslan Ermilovor
638480a1ebSRuslan Ermilov.Dv ACL_GROUP .
648480a1ebSRuslan ErmilovThe value pointed to by
658480a1ebSRuslan Ermilov.Fa tag_qualifier_p
664bf60dfaSChris D. Faulhaberis not valid.
674bf60dfaSChris D. Faulhaber.It Bq Er ENOMEM
684bf60dfaSChris D. FaulhaberThe value to be returned requires more memory than is allowed
694bf60dfaSChris D. Faulhaberby the hardware or system-imposed memory management constraints.
704bf60dfaSChris D. Faulhaber.El
714bf60dfaSChris D. Faulhaber.Sh SEE ALSO
724bf60dfaSChris D. Faulhaber.Xr acl 3 ,
734bf60dfaSChris D. Faulhaber.Xr acl_get_qualifier 3 ,
744bf60dfaSChris D. Faulhaber.Xr posix1e 3
754bf60dfaSChris D. Faulhaber.Sh STANDARDS
764bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17.
774bf60dfaSChris D. Faulhaber.Sh HISTORY
784bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in
794bf60dfaSChris D. Faulhaber.Fx 4.0 .
804bf60dfaSChris D. FaulhaberThe
814bf60dfaSChris D. Faulhaber.Fn acl_get_qualifier
824bf60dfaSChris D. Faulhaberfunction was added in
834bf60dfaSChris D. Faulhaber.Fx 5.0 .
844bf60dfaSChris D. Faulhaber.Sh AUTHORS
854bf60dfaSChris D. FaulhaberThe
864bf60dfaSChris D. Faulhaber.Fn acl_get_qualifier
874bf60dfaSChris D. Faulhaberfunction was written by
884bf60dfaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org .
89