[PATCH 07/12] Documentation: kvm: tdx-tdp-mmu: Use literal code block for EPT violation diagrams

Bagas Sanjaya
2022-07-09T04:21:51Z

EPT violation diagrams aren't inside literal code block, which trigger
"line block ends without a blank line" warning. Since these diagrams
aren't meant line blocks, use literal code block instead.

Fixes: 7af4efe3263854 ("KVM: x86: design documentation on TDX support of x86 KVM TDP MMU")
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
---
Documentation/virt/kvm/tdx-tdp-mmu.rst | 39 +++++++++++++++++---------
1 file changed, 25 insertions(+), 14 deletions(-)

diff --git a/Documentation/virt/kvm/tdx-tdp-mmu.rst b/Documentation/virt/kvm/tdx-tdp-mmu.rst
index c9d5fc43a6ca7a..f43ebb08f5cdad 100644
--- a/Documentation/virt/kvm/tdx-tdp-mmu.rst
+++ b/Documentation/virt/kvm/tdx-tdp-mmu.rst
@@ -169,30 +169,41 @@ hooks to KVM MMU to reuse the existing code.
EPT violation on shared GPA
---------------------------
(1) EPT violation on shared GPA or zapping shared GPA
- walk down shared EPT tree (the existing code)
- |
- |
- V
-shared EPT tree (CPU refers.)
+ ::
+
+ walk down shared EPT tree (the existing code)
+ |
+ |
+ V
+ shared EPT tree (CPU refers.)
+
(2) update the EPT entry. (the existing code)
+
TLB shootdown in the case of zapping.

EPT violation on private GPA
----------------------------
(1) EPT violation on private GPA or zapping private GPA
- walk down the mirror of secure EPT tree (mostly same as the existing code)
- |
- |
- V
-mirror of secure EPT tree (KVM MMU software only. reuse of the existing code)
+ ::
+
+ walk down the mirror of secure EPT tree (mostly same as the existing code)
+ |
+ |
+ V
+ mirror of secure EPT tree (KVM MMU software only. reuse of the existing code)
+
(2) update the (mirrored) EPT entry. (mostly same as the existing code)
+
(3) call the hooks with what EPT entry is changed
- |
+ ::
+
+ |
NEW: hooks in KVM MMU
- |
- V
-secure EPT root(CPU refers)
+ |
+ V
+ secure EPT root(CPU refers)
+
(4) the TDX backend calls necessary TDX SEAMCALLs to update real secure EPT.

The major modification is to add hooks for the TDX backend for additional