LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / mprotect.2

diff --git a/original/man2/mprotect.2 b/original/man2/mprotect.2
index 8af7d3e..dbd536d 100644 (file)
--- a/original/man2/mprotect.2
+++ b/original/man2/mprotect.2
@@ -1,7 +1,7 @@
-.\" -*- nroff -*-
 .\" Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
 .\" and Copyright (C) 1995 Michael Shields <shields@tembel.org>.
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,6 +21,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and author of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Modified 1996-10-22 by Eric S. Raymond <esr@thyrsus.com>
 .\" Modified 1997-05-31 by Andries Brouwer <aeb@cwi.nl>
@@ -29,14 +30,20 @@
 .\" 2007-06-02, mtk: Fairly substantial rewrites and additions, and
 .\" a much improved example program.
 .\"
-.TH MPROTECT 2 2008-08-06 "Linux" "Linux Programmer's Manual"
+.\" FIXME The following protection flags need documenting:
+.\"         PROT_SEM
+.\"         PROT_GROWSDOWN
+.\"         PROT_GROWSUP
+.\"         PROT_SAO (PowerPC)
+.\"
+.TH MPROTECT 2 2014-01-05 "Linux" "Linux Programmer's Manual"
 .SH NAME
 mprotect \- set protection on a region of memory
 .SH SYNOPSIS
 .nf
 .B #include <sys/mman.h>
 .sp
-.BI "int mprotect(const void *" addr ", size_t " len ", int " prot );
+.BI "int mprotect(void *" addr ", size_t " len ", int " prot );
 .fi
 .SH DESCRIPTION
 .BR mprotect ()
@@ -67,9 +74,7 @@ The memory can be modified.
 .TP
 .B PROT_EXEC
 The memory can be executed.
-.\" FIXME
-.\" Document PROT_GROWSUP and PROT_GROWSDOWN
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success,
 .BR mprotect ()
 returns zero.
@@ -98,13 +103,13 @@ Internal kernel structures could not be allocated.
 .B ENOMEM
 Addresses in the range
 .RI [ addr ,
-.IR addr + len ]
+.IR addr + len \-1]
 are invalid for the address space of the process,
 or specify one or more pages that are not mapped.
 (Before kernel 2.4.19, the error
 .BR EFAULT
 was incorrectly produced for these cases.)
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 SVr4, POSIX.1-2001.
 .\" SVr4 defines an additional error
 .\" code EAGAIN. The SVr4 error conditions don't map neatly onto Linux's.
@@ -134,7 +139,7 @@ implies
 POSIX.1-2001 says that an implementation may permit access
 other than that specified in
 .IR prot ,
-but at a minimum can only allow write access if
+but at a minimum can allow write access only if
 .B PROT_WRITE
 has been set, and must not allow any access if
 .B PROT_NONE
@@ -170,7 +175,7 @@ Got SIGSEGV at address: 0x804e000
 #define handle_error(msg) \\
     do { perror(msg); exit(EXIT_FAILURE); } while (0)
 
-char *buffer;
+static char *buffer;
 
 static void
 handler(int sig, siginfo_t *si, void *unused)
@@ -207,7 +212,7 @@ main(int argc, char *argv[])
     printf("Start of region:        0x%lx\\n", (long) buffer);
 
     if (mprotect(buffer + pagesize * 2, pagesize,
-                PROT_NONE) == \-1)
+                PROT_READ) == \-1)
         handle_error("mprotect");
 
     for (p = buffer ; ; )
@@ -217,6 +222,15 @@ main(int argc, char *argv[])
     exit(EXIT_SUCCESS);
 }
 .fi
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR mmap (2),
 .BR sysconf (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.