|
|
Subscribe / Log in / New account

man/man2/mremap.2: describe multiple mapping move, shrink

From:  Lorenzo Stoakes <lorenzo.stoakes-AT-oracle.com>
To:  Alejandro Colomar <alx-AT-kernel.org>
Subject:  [PATCH v4 0/2] man/man2/mremap.2: describe multiple mapping move, shrink
Date:  Tue, 05 Aug 2025 18:31:54 +0100
Message-ID:  <cover.1754414738.git.lorenzo.stoakes@oracle.com>
Cc:  linux-man-AT-vger.kernel.org, Andrew Morton <akpm-AT-linux-foundation.org>, Peter Xu <peterx-AT-redhat.com>, Alexander Viro <viro-AT-zeniv.linux.org.uk>, Christian Brauner <brauner-AT-kernel.org>, Jan Kara <jack-AT-suse.cz>, "Liam R . Howlett" <Liam.Howlett-AT-oracle.com>, Vlastimil Babka <vbabka-AT-suse.cz>, Jann Horn <jannh-AT-google.com>, Pedro Falcato <pfalcato-AT-suse.de>, Rik van Riel <riel-AT-surriel.com>, linux-mm-AT-kvack.org, linux-kernel-AT-vger.kernel.org, linux-api-AT-vger.kernel.org
Archive-link:  Article

We have added new functionality to mremap() in Linux 6.17, permitting the
move of multiple VMAs when performing a move alone (that is - providing
MREMAP_MAYMOVE | MREMAP_FIXED flags and specifying old_size == new_size).

We document this new feature.

Additionally, we document previously undocumented behaviour around
shrinking of input VMA ranges which permits the input range to span
multiple VMAs.

v4:
* Update description of newly discovered mremap() behaviour to highlight the
  fact that, if in-place, [old_address, old_address + new_length) may span
  multiple VMAs also.
* Fix up commit message for 2/2 to correct typo on specified range.
* Added code sample to 1/2 as per Alejandro.

v3:
* Use more precise language around mremap() move description as per Jann.
* Fix some typos in commit messages.
https://lore.kernel.org/all/cover.1753795807.git.lorenzo....

v2:
* Split out the two man page changes as requested by Alejandro.
https://lore.kernel.org/all/cover.1753711160.git.lorenzo....

v1:
https://lore.kernel.org/all/20250723174634.75054-1-lorenz...

Lorenzo Stoakes (2):
  man/man2/mremap.2: describe multiple mapping move
  man/man2/mremap.2: describe previously undocumented shrink behaviour

 man/man2/mremap.2 | 111 +++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 100 insertions(+), 11 deletions(-)

--
2.50.1



Copyright © 2025, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds