linux-api.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [patch] mremap.2: Add description of old_size == 0 functionality
@ 2017-09-15 21:37 Mike Kravetz
  2017-09-15 21:53 ` Mike Kravetz
       [not found] ` <20170915213745.6821-1-mike.kravetz-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
  0 siblings, 2 replies; 19+ messages in thread
From: Mike Kravetz @ 2017-09-15 21:37 UTC (permalink / raw)
  To: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w
  Cc: linux-man-u79uwXL29TY76Z2rM5mHXA,
	linux-kernel-u79uwXL29TY76Z2rM5mHXA,
	linux-api-u79uwXL29TY76Z2rM5mHXA, Michal Hocko, Andrea Arcangeli,
	Kirill A . Shutemov, Vlastimil Babka, Anshuman Khandual,
	Mike Kravetz

Since at least the 2.6 time frame, mremap would create a new mapping
of the same pages if 'old_size == 0'.  It would also leave the original
mapping.  This was used to create a 'duplicate mapping'.

Document the behavior and return codes.  But, also mention that the
functionality is deprecated and discourage its use.

A recent change was made to mremap so that an attempt to create a
duplicate a private mapping will fail.

commit dba58d3b8c5045ad89c1c95d33d01451e3964db7
Author: Mike Kravetz <mike.kravetz-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
Date:   Wed Sep 6 16:20:55 2017 -0700

    mm/mremap: fail map duplication attempts for private mappings

This return code is also documented here.

Signed-off-by: Mike Kravetz <mike.kravetz-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
---
 man2/mremap.2 | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/man2/mremap.2 b/man2/mremap.2
index 98643c640..98df7d5fa 100644
--- a/man2/mremap.2
+++ b/man2/mremap.2
@@ -58,6 +58,21 @@ may be provided; see the description of
 .B MREMAP_FIXED
 below.
 .PP
+If the value of \fIold_size\fP is zero, and \fIold_address\fP refers to
+a private anonymous mapping, then
+.BR mremap ()
+will create a new mapping of the same pages. \fInew_size\fP
+will be the size of the new mapping and the location of the new mapping
+may be specified with \fInew_address\fP, see the description of
+.B MREMAP_FIXED
+below.  If a new mapping is requested via this method, then the
+.B MREMAP_MAYMOVE
+flag must also be specified.  This functionality is deprecated, and no
+new code should be written to use this feature.  A better method of
+obtaining multiple mappings of the same private anonymous memory is via the
+.BR memfd_create()
+system call.
+.PP
 In Linux the memory is divided into pages.
 A user process has (one or)
 several linear virtual memory segments.
@@ -174,7 +189,12 @@ and
 or
 .B MREMAP_FIXED
 was specified without also specifying
-.BR MREMAP_MAYMOVE .
+.BR MREMAP_MAYMOVE ;
+or \fIold_size\fP was zero and \fIold_address\fP does not refer to a
+private anonymous mapping;
+or \fIold_size\fP was zero and the
+.BR MREMAP_MAYMOVE
+flag was not specified.
 .TP
 .B ENOMEM
 The memory area cannot be expanded at the current virtual address, and the
@@ -210,6 +230,7 @@ if the area cannot be populated.
 .BR brk (2),
 .BR getpagesize (2),
 .BR getrlimit (2),
+.BR memfd_create(2),
 .BR mlock (2),
 .BR mmap (2),
 .BR sbrk (2),
-- 
2.13.5

^ permalink raw reply related	[flat|nested] 19+ messages in thread

end of thread, other threads:[~2017-09-25 19:26 UTC | newest]

Thread overview: 19+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-09-15 21:37 [patch] mremap.2: Add description of old_size == 0 functionality Mike Kravetz
2017-09-15 21:53 ` Mike Kravetz
     [not found]   ` <a6e59a7f-fd15-9e49-356e-ed439f17e9df-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
2017-09-18 13:45     ` Florian Weimer
2017-09-18 17:11       ` Mike Kravetz
     [not found]         ` <ee87215d-9704-7269-4ec1-226f2e32a751-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
2017-09-19 12:11           ` Florian Weimer
2017-09-19 21:42             ` [patch v2] " Mike Kravetz
     [not found]               ` <20170919214224.19561-1-mike.kravetz-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
2017-09-20  7:25                 ` Michael Kerrisk (man-pages)
     [not found]                   ` <6fafdae8-4fea-c967-f5cd-d22c205608fa-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2017-09-25 12:36                     ` Michal Hocko
2017-09-25 12:40                       ` Michael Kerrisk (man-pages)
2017-09-25 16:33                   ` Mike Kravetz
     [not found]                     ` <83b023da-e9f5-2957-981e-5b0e71e9bf1b-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
2017-09-25 19:26                       ` Michael Kerrisk (man-pages)
     [not found]             ` <a5d279cb-a015-f74c-2e40-a231aa7f7a8c-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
2017-09-25 12:35               ` [patch] " Michal Hocko
2017-09-25 12:40                 ` Florian Weimer
2017-09-25 12:52                   ` Michal Hocko
2017-09-25 13:16                     ` Florian Weimer
     [not found]                       ` <765cd0cb-aa35-187c-456d-05d8752caa04-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
2017-09-25 14:52                         ` Michal Hocko
2017-09-25 14:54                           ` Florian Weimer
     [not found] ` <20170915213745.6821-1-mike.kravetz-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>
2017-09-18  1:52   ` Jann Horn
2017-09-18 17:19     ` Mike Kravetz

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).