mirror of
https://github.com/torvalds/linux.git
synced 2024-11-22 04:02:20 +00:00
ee86588960
It is enough to use a file name to cross-reference another rst document. Jon says: The right things will happen in the HTML output, readers of the plain-text will know immediately where to go, and we don't have to add the label clutter. Drop reference markup and unnecessary labels and use plain file names. Signed-off-by: Mike Rapoport (IBM) <rppt@kernel.org> Link: https://lore.kernel.org/r/20230201094156.991542-3-rppt@kernel.org Signed-off-by: Jonathan Corbet <corbet@lwn.net>
32 lines
1.6 KiB
ReStructuredText
32 lines
1.6 KiB
ReStructuredText
==============================
|
|
remap_file_pages() system call
|
|
==============================
|
|
|
|
The remap_file_pages() system call is used to create a nonlinear mapping,
|
|
that is, a mapping in which the pages of the file are mapped into a
|
|
nonsequential order in memory. The advantage of using remap_file_pages()
|
|
over using repeated calls to mmap(2) is that the former approach does not
|
|
require the kernel to create additional VMA (Virtual Memory Area) data
|
|
structures.
|
|
|
|
Supporting of nonlinear mapping requires significant amount of non-trivial
|
|
code in kernel virtual memory subsystem including hot paths. Also to get
|
|
nonlinear mapping work kernel need a way to distinguish normal page table
|
|
entries from entries with file offset (pte_file). Kernel reserves flag in
|
|
PTE for this purpose. PTE flags are scarce resource especially on some CPU
|
|
architectures. It would be nice to free up the flag for other usage.
|
|
|
|
Fortunately, there are not many users of remap_file_pages() in the wild.
|
|
It's only known that one enterprise RDBMS implementation uses the syscall
|
|
on 32-bit systems to map files bigger than can linearly fit into 32-bit
|
|
virtual address space. This use-case is not critical anymore since 64-bit
|
|
systems are widely available.
|
|
|
|
The syscall is deprecated and replaced it with an emulation now. The
|
|
emulation creates new VMAs instead of nonlinear mappings. It's going to
|
|
work slower for rare users of remap_file_pages() but ABI is preserved.
|
|
|
|
One side effect of emulation (apart from performance) is that user can hit
|
|
vm.max_map_count limit more easily due to additional VMAs. See comment for
|
|
DEFAULT_MAX_MAP_COUNT for more details on the limit.
|