summaryrefslogtreecommitdiffstats
path: root/man2/remap_file_pages.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/remap_file_pages.2')
-rw-r--r--man2/remap_file_pages.218
1 files changed, 9 insertions, 9 deletions
diff --git a/man2/remap_file_pages.2 b/man2/remap_file_pages.2
index ab4ee51..f662c46 100644
--- a/man2/remap_file_pages.2
+++ b/man2/remap_file_pages.2
@@ -5,7 +5,7 @@
.\" 2003-12-10 Initial creation, Michael Kerrisk <mtk.manpages@gmail.com>
.\" 2004-10-28 aeb, corrected prototype, prot must be 0
.\"
-.TH remap_file_pages 2 2023-03-30 "Linux man-pages 6.05.01"
+.TH remap_file_pages 2 2023-10-31 "Linux man-pages 6.7"
.SH NAME
remap_file_pages \- create a nonlinear file mapping
.SH LIBRARY
@@ -15,7 +15,7 @@ Standard C library
.nf
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <sys/mman.h>
-.PP
+.P
.BI "[[deprecated]] int remap_file_pages(void " addr [. size "], size_t " size ,
.BI " int " prot ", size_t " pgoff ", \
int " flags );
@@ -34,7 +34,7 @@ This change was made because the kernel code for this system call was complex,
and it is believed to be little used or perhaps even completely unused.
While it had some use cases in database applications on 32-bit systems,
those use cases don't exist on 64-bit systems.
-.PP
+.P
The
.BR remap_file_pages ()
system call is used to create a nonlinear mapping, that is, a mapping
@@ -46,7 +46,7 @@ over using repeated calls to
.BR mmap (2)
is that the former approach does not require the kernel to create
additional VMA (Virtual Memory Area) data structures.
-.PP
+.P
To create a nonlinear mapping we perform the following steps:
.TP 3
1.
@@ -64,7 +64,7 @@ to rearrange the correspondence between the pages of the mapping
and the pages of the file.
It is possible to map the same page of a file
into multiple locations within the mapped region.
-.PP
+.P
The
.I pgoff
and
@@ -75,7 +75,7 @@ within the mapping:
is a file offset in units of the system page size;
.I size
is the length of the region in bytes.
-.PP
+.P
The
.I addr
argument serves two purposes.
@@ -93,7 +93,7 @@ identified by
and
.I size
will be placed.
-.PP
+.P
The values specified in
.I addr
and
@@ -107,11 +107,11 @@ to the nearest multiple of the page size.
.\" This rounding is weird, and not consistent with the treatment of
.\" the analogous arguments for munmap()/mprotect() and for mlock().
.\" MTK, 14 Sep 2005
-.PP
+.P
The
.I prot
argument must be specified as 0.
-.PP
+.P
The
.I flags
argument has the same meaning as for