git: 85bea309f935 - main - mprotect.2: Improve the description of prot

[Brooks Davis]

The branch main has been updated by brooks:

URL: https://cgit.FreeBSD.org/src/commit/?id=85bea309f935111cb362035795a59c263536b065

commit 85bea309f935111cb362035795a59c263536b065
Author:     Brooks Davis <brooks at FreeBSD.org>
AuthorDate: 2021-09-07 16:28:50 +0000
Commit:     Brooks Davis <brooks at FreeBSD.org>
CommitDate: 2021-09-07 16:28:50 +0000

    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
---
 lib/libc/sys/mprotect.2 | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2
index 5c024dd24d56..c2c7701d624e 100644
--- a/lib/libc/sys/mprotect.2
+++ b/lib/libc/sys/mprotect.2
@@ -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_