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_ADD_PERM 3 304bf60dfaSChris D. Faulhaber.Os 314bf60dfaSChris D. Faulhaber.Sh NAME 324bf60dfaSChris D. Faulhaber.Nm acl_add_perm 338480a1ebSRuslan Ermilov.Nd add permissions to a permission set 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_add_perm "acl_permset_t permset_d" "acl_perm_t perm" 414bf60dfaSChris D. Faulhaber.Sh DESCRIPTION 424bf60dfaSChris D. Faulhaber.Fn acl_add_perm 434bf60dfaSChris D. Faulhaberis a POSIX.1e call that adds the permission contained in 448480a1ebSRuslan Ermilov.Fa perm 454bf60dfaSChris D. Faulhaberto the permission set 468480a1ebSRuslan Ermilov.Fa permset_d . 474bf60dfaSChris D. Faulhaber.Pp 484bf60dfaSChris D. FaulhaberNote: it is not considered an error to attempt to add permissions 494bf60dfaSChris D. Faulhaberthat already exist in the permission set. 504bf60dfaSChris D. Faulhaber.Sh RETURN VALUES 518480a1ebSRuslan Ermilov.Rv -std acl_add_perm 524bf60dfaSChris D. Faulhaber.Sh ERRORS 538480a1ebSRuslan ErmilovThe 544bf60dfaSChris D. Faulhaber.Fn acl_add_perm 558480a1ebSRuslan Ermilovfunction fails if: 564bf60dfaSChris D. Faulhaber.Bl -tag -width Er 574bf60dfaSChris D. Faulhaber.It Bq Er EINVAL 584bf60dfaSChris D. FaulhaberArgument 598480a1ebSRuslan Ermilov.Fa permset_d 604bf60dfaSChris D. Faulhaberis not a valid descriptor for a permission set within an ACL entry. 614bf60dfaSChris D. FaulhaberArgument 628480a1ebSRuslan Ermilov.Fa perm 634bf60dfaSChris D. Faulhaberdoes not contain a valid 648480a1ebSRuslan Ermilov.Vt acl_perm_t 654bf60dfaSChris D. Faulhabervalue. 664bf60dfaSChris D. Faulhaber.El 674bf60dfaSChris D. Faulhaber.Sh SEE ALSO 684bf60dfaSChris D. Faulhaber.Xr acl 3 , 694bf60dfaSChris D. Faulhaber.Xr acl_clear_perms 3 , 704bf60dfaSChris D. Faulhaber.Xr acl_delete_perms 3 , 714bf60dfaSChris D. Faulhaber.Xr acl_get_permset 3 , 724bf60dfaSChris D. Faulhaber.Xr acl_set_permset 3 , 734bf60dfaSChris D. Faulhaber.Xr posix1e 3 744bf60dfaSChris D. Faulhaber.Sh STANDARDS 754bf60dfaSChris D. FaulhaberPOSIX.1e is described in IEEE POSIX.1e draft 17. 764bf60dfaSChris D. Faulhaber.Sh HISTORY 774bf60dfaSChris D. FaulhaberPOSIX.1e support was introduced in 784bf60dfaSChris D. Faulhaber.Fx 4.0 . 794bf60dfaSChris D. FaulhaberThe 804bf60dfaSChris D. Faulhaber.Fn acl_add_perm 814bf60dfaSChris D. Faulhaberfunction was added in 824bf60dfaSChris D. Faulhaber.Fx 5.0 . 834bf60dfaSChris D. Faulhaber.Sh AUTHORS 844bf60dfaSChris D. FaulhaberThe 854bf60dfaSChris D. Faulhaber.Fn acl_add_perm 864bf60dfaSChris D. Faulhaberfunction was written by 874bf60dfaSChris D. Faulhaber.An Chris D. Faulhaber Aq jedgar@fxp.org . 88