[PATCH RFC 06/12] Documentation: KVM: Have actual headings for exceptions
From: Ackerley Tng via B4 Relay
Date: Wed May 27 2026 - 11:36:23 EST
From: Ackerley Tng <ackerleytng@xxxxxxxxxx>
Exceptions documented are described but without headings, making it hard to
identify where each exception description ended.
Use actual headings at a lower level than that of the heading used for
Exception to improve readability.
Signed-off-by: Ackerley Tng <ackerleytng@xxxxxxxxxx>
---
Documentation/virt/kvm/locking.rst | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/Documentation/virt/kvm/locking.rst b/Documentation/virt/kvm/locking.rst
index 5161636cec481..fc4537a7659a9 100644
--- a/Documentation/virt/kvm/locking.rst
+++ b/Documentation/virt/kvm/locking.rst
@@ -65,7 +65,8 @@ The general rule in KVM is that any modification to shadow page tables
(and their entries (SPTEs)) must be protected by ``kvm->mmu_lock``,
with the exceptions described below.
-Fast page fault:
+2.1. Fast page fault
+^^^^^^^^^^^^^^^^^^^^
Fast page fault is the fast path which fixes the guest page fault out of
the mmu-lock on x86. Currently, the page fault can be fast in one of the
@@ -217,7 +218,8 @@ Since the spte is "volatile" if it can be updated out of mmu-lock, we always
atomically update the spte and the race caused by fast page fault can be avoided.
See the comments in spte_needs_atomic_update() and mmu_spte_update().
-Lockless Access Tracking:
+2.2 Lockless Access Tracking
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is used for Intel CPUs that are using EPT but do not support the EPT A/D
bits. In this case, PTEs are tagged as A/D disabled (using ignored bits), and
--
2.54.0.823.g6e5bcc1fc9-goog