mprotect.2: Improve the description of prot

The new wording for standard flags is losely based on the POSIX
description.

Make it clearer that PROT_MAX() is a local extension.

Reviewed by:	alc, mckusick, imp, kib, markj
Sponsored by:	DARPA
Differential Revision:	https://reviews.freebsd.org/D31777
This commit is contained in:
Brooks Davis 2021-09-07 17:28:50 +01:00
parent ecfbb2e302
commit 85bea309f9

View File

@ -28,7 +28,7 @@
.\" @(#)mprotect.2 8.1 (Berkeley) 6/9/93
.\" $FreeBSD$
.\"
.Dd September 3, 2021
.Dd September 7, 2021
.Dt MPROTECT 2
.Os
.Sh NAME
@ -47,12 +47,16 @@ system call
changes the specified pages to have protection
.Fa prot .
.Pp
Currently these protection bits are known,
which can be combined, OR'd together:
The
.Fa prot
argument shall be
.Dv PROT_NONE
(no permissions at all)
or the bitwise
.Em or
of one or more of the following values:
.Pp
.Bl -tag -width ".Dv PROT_WRITE" -compact
.It Dv PROT_NONE
No permissions at all.
.It Dv PROT_READ
The pages can be read.
.It Dv PROT_WRITE
@ -61,13 +65,16 @@ The pages can be written.
The pages can be executed.
.El
.Pp
In addition to these protection flags,
In addition to these standard protection flags,
the
.Fx
implementation of
.Fn mprotect
provides the ability to set the maximum protection of a region
(which prevents
.Nm
from upgrading the permissions).
This is accomplished by
from adding to the permissions later).
This is accomplished by bitwise
.Em or Ns 'ing
one or more
.Dv PROT_