After the cleanups from Baoquan He, make it even more readable:
- Remove the 'bits' area size column: it's pretty pointless and was even
wrong for some of the entries. Given that MB, GB, TB, PT are 10, 20,
30 and 40 bits, a "8 TB" size description makes it obvious that it's
43 bits.
- Introduce an "offset" column:
--------------------------------------------------------------------------------
start addr | offset | end addr | size | VM area
description
-----------------|------------|------------------|---------|--------------------
...
ffff880000000000 | -120 TB | ffffc7ffffffffff | 64 TB | direct mapping
of all physical memory (page_offset_base),
this is what
limits max physical memory supported.
The -120 TB notation makes it obvious where this particular virtual memory
region starts: 120 TB down from the top of the 64-bit virtual memory space.
Especially the layout of the kernel mappings is a *lot* more obvious when
written this way, plus it's much easier to compare it with the size column
and understand/check/validate and modify the kernel's layout in the future.
- Mark the part from where the 47-bit and 56-bit kernel layouts are 100%
identical,
this starts at the -512 GB offset and the EFI region.
- Re-shuffle the size desciptions to be continous blocks of sizes, instead of
the
often mixed size. I.e. write "0.5 TB" instead of "512 GB" if we are still in
the TB-granular region of the map.
- Make the 47-bit and 56-bit descriptions use the *exact* same layout and
wording,
and only differ where there's a material difference. This makes it easy to
compare
the two tables side by side by switching between two terminal tabs.
- Plus enhance a lot of other stylistic/typographical details: make the tables
explicitly tabular, add headers, enhance certain entries, etc. etc.
Note that there are some apparent errors in the tables as well, but I'll fix
them in a separate patch to make it easier to review/validate.
Cc: Andy Lutomirski <l...@kernel.org>
Cc: Baoquan He <b...@redhat.com>
Cc: Borislav Petkov <b...@alien8.de>
Cc: Brian Gerst <brge...@gmail.com>
Cc: Dave Hansen <dave.han...@linux.intel.com>
Cc: Denys Vlasenko <dvlas...@redhat.com>
Cc: H. Peter Anvin <h...@zytor.com>
Cc: Linus Torvalds <torva...@linux-foundation.org>
Cc: Peter Zijlstra <pet...@infradead.org>
Cc: Rik van Riel <r...@surriel.com>
Cc: Thomas Gleixner <t...@linutronix.de>
Cc: cor...@lwn.net
Cc: linux-doc@vger.kernel.org
Cc: linux-ker...@vger.kernel.org
Cc: thgar...@google.com
Signed-off-by: Ingo Molnar <mi...@kernel.org>
---
Documentation/x86/x86_64/mm.txt | 172 ++++++++++++++++++++++++++++------------
kernel/sched/core.c | 6 +
2 files changed, 128 insertions(+), 50 deletions(-)
Index: tip/Documentation/x86/x86_64/mm.txt
===================================================================
--- tip.orig/Documentation/x86/x86_64/mm.txt
+++ tip/Documentation/x86/x86_64/mm.txt
@@ -1,55 +1,127 @@
-Virtual memory map with 4 level page tables:
+========================================================
+| Complete virtual memory map with 4-level page tables |
+========================================================
-0000000000000000 - 00007fffffffffff (=47 bits, 128 TB) user space, different
per mm
- hole caused by [47:63] sign extension
-ffff800000000000 - ffff87ffffffffff (=43 bits, 8 TB) guard hole, reserved
for hypervisor
-ffff880000000000 - ffffc7ffffffffff (=46 bits, 64 TB) direct mapping of all
phys. memory (page_offset_base)
-ffffc80000000000 - ffffc8ffffffffff (=40 bits, 1 TB) unused hole
-ffffc90000000000 - ffffe8ffffffffff (=45 bits, 32 TB) vmalloc/ioremap space
(vmalloc_base)
-ffffe90000000000 - ffffe9ffffffffff (=40 bits, 1 TB) unused hole
-ffffea0000000000 - ffffeaffffffffff (=40 bits, 1 TB) virtual memory map
(vmemmap_base)
-ffffeb0000000000 - ffffebffffffffff (=40 bits, 1 TB) unused hole
-ffffec0000000000 - fffffbffffffffff (=44 bits, 16 TB) kasan shadow memory
-fffffc0000000000 - fffffdffffffffff (=41 bits, 2 TB) unused hole
- vaddr_end for KASLR
-fffffe0000000000 - fffffe7fffffffff (=39 bits, 512 GB) cpu_entry_area mapping
-fffffe8000000000 - fffffeffffffffff (=39 bits, 512 GB) LDT remap for PTI
-ffffff0000000000 - ffffff7fffffffff (=39 bits, 512 GB) %esp fixup stacks
-ffffff8000000000 - fffffffeefffffff (~39 bits, ~507 GB) unused hole
-ffffffef00000000 - fffffffeffffffff (=36 bits, 64 GB) EFI region mapping
space
-ffffffff00000000 - ffffffff7fffffff (=31 bits, 2 GB) unused hole
-ffffffff80000000 - ffffffff9fffffff (=29 bits, 512 MB) kernel text mapping,
from phys 0
-ffffffffa0000000 - fffffffffeffffff (~31 bits, 1520 MB) module mapping space
-[fixmap start] - ffffffffff5fffff kernel-internal fixmap range
-ffffffffff600000 - ffffffffff600fff ( =4 kB) legacy vsyscall ABI
-ffffffffffe00000 - ffffffffffffffff ( =2 MB) unused hole
-
-Virtual memory map with 5 level page tables:
-
-0000000000000000 - 00ffffffffffffff (=56 bits, 64 PB) user space, different
per mm
- hole caused by [56:63] sign extension
-ff00000000000000 - ff0fffffffffffff (=52 bits, 4 PB) guard hole, reserved
for hypervisor
-ff10000000000000 - ff8fffffffffffff (=55 bits, 32 PB) direct mapping of all
phys. memory (page_offset_base)
-ff90000000000000 - ff9fffffffffffff (=52 bits, 4 PB) LDT remap for PTI
-ffa0000000000000 - ffd1ffffffffffff (=53 bits, 12800 TB) vmalloc/ioremap space
(vmalloc_base)
-ffd2000000000000 - ffd3ffffffffffff (=49 bits, 512 TB) unused hole
-ffd4000000000000 - ffd5ffffffffffff (=49 bits, 512 TB) virtual memory map
(vmemmap_base)
-ffd6000000000000 - ffdeffffffffffff (~51 bits, 2304 TB) unused hole
-ffdf000000000000 - fffffdffffffffff (~53 bits, ~8 PB) kasan shadow memory
-fffffc0000000000 - fffffdffffffffff (=41 bits, 2 TB) unused hole
- vaddr_end for KASLR
-fffffe0000000000 - fffffe7fffffffff (=39 bits, 512 GB) cpu_entry_area mapping
-fffffe8000000000 - fffffeffffffffff (=39 bits, 512 GB) unused hole
-ffffff0000000000 - ffffff7fffffffff (=39 bits, 512 GB) %esp fixup stacks
-ffffff8000000000 - ffffffeeffffffff (~39 bits, 444 GB) unused hole
-ffffffef00000000 - fffffffeffffffff (=36 bits, 64 GB) EFI region mapping
space
-ffffffff00000000 - ffffffff7fffffff (31 bits, 2 GB) unused hole
-ffffffff80000000 - ffffffff9fffffff (=29 bits, 512 MB) kernel text mapping,
from phys 0
-ffffffffa0000000 - fffffffffeffffff (~31 bits, 1520 MB) module mapping space
-[fixmap start] - ffffffffff5fffff kernel-internal fixmap range
-ffffffffff600000 - ffffffffff600fff ( =4 kB) legacy vsyscall ABI
-ffffffffffe00000 - ffffffffffffffff ( =2 MB) unused hole
+Notes:
+
+ - Negative addresses such as "-23 TB" are absolute addresses in bytes,
counted down
+ from the top of the 64-bit address space. It's easier to understand the
layout
+ when seen both in absolute addresses and in distance-from-top notation.
+
+ For example 0xffffe90000000000 == -23 TB, it's 23 TB lower than the top of
the
+ 64-bit address space (ffffffffffffffff).
+
+ Note that as we get closer to the top of the address space, the notation
changes
+ from TB to GB and then MB/KB.
+
+ - "16M TB" might look weird at first sight, but it's an easier to visualize
size
+ notation than "16 EB", which few will recognize at first sight as 16
exabytes.
+ It also shows it nicely how incredibly large 64-bit address space is.
+
+--------------------------------------------------------------------------------
+start addr | offset | end addr | size | VM area
description
+-----------------|------------|------------------|---------|--------------------
+0000000000000000 | 0 | 00007fffffffffff | 128 TB | user-space
virtual memory, different per mm
+ |
+0000800000000000 | +128 TB | ffff7fffffffffff | ~16M TB | ... huge, almost
64 bits wide hole of non-canonical
+ virtual
memory addresses up to the -128 TB
+ starting
offset of kernel mappings.
+ |
+
|----------------------------------------------------
+ | kernel-space
virtual memory, shared between all processes:
+ |
+ffff800000000000 | -128 TB | ffff87ffffffffff | 8 TB | ... guard hole,
also reserved for hypervisor
+ffff880000000000 | -120 TB | ffffc7ffffffffff | 64 TB | direct mapping of
all physical memory (page_offset_base),
+ this is what
limits max physical memory supported.
+ffffc80000000000 | -56 TB | ffffc8ffffffffff | 1 TB | ... unused hole
+ffffc90000000000 | -55 TB | ffffe8ffffffffff | 32 TB | vmalloc/ioremap
space (vmalloc_base)
+ffffe90000000000 | -23 TB | ffffe9ffffffffff | 1 TB | ... unused hole
+ffffea0000000000 | -22 TB | ffffeaffffffffff | 1 TB | virtual memory
map (vmemmap_base)
+ffffeb0000000000 | -21 TB | ffffebffffffffff | 1 TB | ... unused hole
+ffffec0000000000 | -20 TB | fffffbffffffffff | 16 TB | KASAN shadow
memory
+fffffc0000000000 | -4 TB | fffffdffffffffff | 2 TB | ... unused hole
+ vaddr_end for
KASLR
+
+fffffe0000000000 | -2 TB | fffffe7fffffffff | 512 GB | cpu_entry_area
mapping
+fffffe8000000000 | -1.5 TB | fffffeffffffffff | 512 GB | LDT remap for PTI
+ffffff0000000000 | -1 TB | ffffff7fffffffff | 512 GB | %esp fixup stacks
+
+# Identical layout to the 56-bit one from here on:
+
+ffffff8000000000 | -512 GB | fffffffeefffffff | ~507 GB | ... unused hole
+ffffffef00000000 | -68 GB | fffffffeffffffff | 64 GB | EFI region
mapping space
+ffffffff00000000 | -4 GB | ffffffff7fffffff | 2 GB | ... unused hole
+ffffffff80000000 | -2 GB | ffffffff9fffffff | 512 MB | kernel text
mapping, mapped to physical address 0
+ffffffff80000000 |-2048 MB
+
+ffffffffa0000000 |-1536 MB | fffffffffeffffff | 1520 MB | module mapping
space
+ffffffffff000000 | -16 MB
+
+ FIXADDR_START | ~-11 MB | ffffffffff5fffff | | kernel-internal
fixmap range with variable size,
+ typical size is
around ~0.5 MB
+
+ffffffffff600000 | -10 MB | ffffffffff600fff | 4 kB | legacy vsyscall
ABI
+ffffffffffe00000 | -2 MB | ffffffffffffffff | 2 MB | ... unused hole
+----------------------------------------------------------------------------
+
+
+========================================================
+| Complete virtual memory map with 5-level page tables |
+========================================================
+
+Notes:
+
+ - With 56-bit addresses, user-space memory gets expanded by a factor of 512x,
+ from 0.125 PB to 64 PB. All kernel mappings shift down to the -64 PT
starting
+ offset and many of the regions expand to support the much larger physical
+ memory supported.
+
+--------------------------------------------------------------------------------
+start addr | offset | end addr | size | VM area
description
+-----------------|------------|------------------|---------|--------------------
+0000000000000000 | 0 | 00ffffffffffffff | 64 PB | user-space
virtual memory, different per mm
+ |
+0000800000000000 | +64 PB | ffff7fffffffffff | ~16K PB | ... huge, still
almost 64 bits wide hole of non-canonical
+ virtual
memory addresses up to the -128 TB
+ starting
offset of kernel mappings.
+ |
+
|----------------------------------------------------
+ | kernel-space
virtual memory, shared between all processes:
+ |
+ff00000000000000 | -64 PB | ff0fffffffffffff | 4 PB | ... guard hole,
also reserved for hypervisor
+ff10000000000000 | -60 PB | ff8fffffffffffff | 32 PB | direct mapping of
all physical memory (page_offset_base),
+ this is what
limits max physical memory supported.
+ff90000000000000 | -28 PB | ff9fffffffffffff | 4 PB | LDT remap for PTI
+ffa0000000000000 | -24 PB | ffd1ffffffffffff | 12.5 PB | vmalloc/ioremap
space (vmalloc_base)
+ffd2000000000000 | -11.5 PB | ffd3ffffffffffff | 0.5 PB | ... unused hole
+ffd4000000000000 | -11 PB | ffd5ffffffffffff | 0.5 PB | virtual memory
map (vmemmap_base)
+ffd6000000000000 | -10.5 PB | ffdeffffffffffff | 2.25 PB | ... unused hole
+ffdf000000000000 | -8.25 PB | fffffdffffffffff | ~8 PB | KASAN shadow
memory
+fffffc0000000000 | -4 TB | fffffdffffffffff | 2 TB | ... unused hole
+ vaddr_end for
KASLR
+
+fffffe0000000000 | -2 TB | fffffe7fffffffff | 0.5 TB | cpu_entry_area
mapping
+fffffe8000000000 | -1.5 TB | fffffeffffffffff | 0.5 TB | ... unused hole
+ffffff0000000000 | -1 TB | ffffff7fffffffff | 0.5 TB | %esp fixup stacks
+ffffff8000000000 | -0.5 TB | ffffffeeffffffff | 444 GB | ... unused hole
+
+# Identical layout to the 47-bit one from here on:
+
+ffffffef00000000 | -68 GB | fffffffeffffffff | 64 GB | EFI region
mapping space
+ffffffff00000000 | -4 GB | ffffffff7fffffff | 2 GB | ... unused hole
+ffffffff80000000 | -2 GB | ffffffff9fffffff | 512 MB | kernel text
mapping, mapped to physical address 0
+ffffffff80000000 |-2048 MB
+
+ffffffffa0000000 |-1536 MB | fffffffffeffffff | 1520 MB | module mapping
space
+ffffffffff000000 | -16 MB
+
+ FIXADDR_START | ~-11 MB | ffffffffff5fffff | | kernel-internal
fixmap range with variable size,
+ typical size is
around ~0.5 MB
+
+ffffffffff600000 | -10 MB | ffffffffff600fff | 4 kB | legacy vsyscall
ABI
+ffffffffffe00000 | -2 MB | ffffffffffffffff | 2 MB | ... unused hole
+----------------------------------------------------------------------------
Architecture defines a 64-bit virtual address. Implementations can support
less. Currently supported are 48- and 57-bit virtual addresses. Bits 63
