mirror/freebsd
1
0
Fork 0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-22 11:17:19 +00:00
Code Issues Releases Activity
e16138fead
freebsd/lib/libc/posix1e/acl_calc_mask.3

97 lines
2.7 KiB
Groff
Raw Normal View History

Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.\"-
.\" Copyright (c) 2001 Chris D. Faulhaber
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR THE VOICES IN HIS HEAD BE
.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
.Dd March 10, 2001
.Dt ACL_CALC_MASK 3
.Os
.Sh NAME
.Nm acl_calc_mask
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
.Nd calculate and set ACL mask permissions
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Sh LIBRARY
Record -lposix1e merge with -lc.
2001-04-05 07:42:56 +00:00
.Lb libc
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Sh SYNOPSIS
.Fd #include <sys/types.h>
.Fd #include <sys/acl.h>
.Ft int
.Fn acl_calc_mask "acl_t *acl_p"
.Sh DESCRIPTION
.Fn acl_calc_mask
is a POSIX.1e call that calculates and set the permissions
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
associated with the
.Dv ACL_MASK
ACL entry of the ACL referred to by
.Fa acl_p .
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Pp
The value of new permissions are the union of the permissions
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
granted by the
.Dv ACL_GROUP , ACL_GROUP_OBJ , ACL_USER
tag types which
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
match processes in the file group class contained in the ACL
referred to by
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
.Fa acl_p .
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Pp
If the ACL referred to by
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
.Fa acl_p
already contains an
.Dv ACL_MASK
entry, its permissions shall be
overwritten; if it does not contain an
.Dv ACL_MASK
entry, one shall
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
be added.
.Sh RETURN VALUES
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
.Rv -std acl_calc_mask
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Sh ERRORS
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
The
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Fn acl_calc_mask
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
function fails if:
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
.Bl -tag -width Er
.It Bq Er EINVAL
Argument
mdoc(7) police: - lowercase Nd argument - mark function arguments with Fa - mark defined values with Dv - simply copying POSIX text for RETURN VALUES and ERRORS sections is not always a good idea. POSIX uses the word "shall" indicating the behavior the correct implementation should follow.
2001-03-19 08:08:22 +00:00
.Fa acl_p
Add the following POSIX 1003.1e functions and man pages: o acl_calc_mask(): calculates the ACL mask entry associated with the given ACL. o acl_delete_entry(): remove a specified ACL entry from the given ACL. Approved by: rwatson
2001-03-19 03:19:51 +00:00
does not point to a pointer to a valid ACL.
.El
.Sh SEE ALSO
.Xr acl 3 ,
.Xr acl_get_entry 3 ,
.Xr acl_valid 3 ,
.Xr posix1e 3
.Sh STANDARDS
POSIX.1e is described in IEEE POSIX.1e draft 17.
.Sh HISTORY
POSIX.1e support was introduced in
.Fx 4.0 .
The
.Fn acl_calc_mask
function was added in
.Fx 5.0 .
.Sh AUTHORS
The
.Fn acl_calc_mask
function was written by
.An Chris D. Faulhaber Aq jedgar@fxp.org .
Reference in New Issue Copy Permalink