Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: kvm: convert arm/hyp-abi.txt to ReST

- Add proper markups for titles;
- Adjust whitespaces and blank lines to match ReST
needs;
- Mark literal blocks as such.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

authored by

Mauro Carvalho Chehab and committed by
Paolo Bonzini
69bf758b 106ee47d

+20 -9
+19 -9
Documentation/virt/kvm/arm/hyp-abi.txt Documentation/virt/kvm/arm/hyp-abi.rst
··· 1 - * Internal ABI between the kernel and HYP 1 + .. SPDX-License-Identifier: GPL-2.0 2 + 3 + ======================================= 4 + Internal ABI between the kernel and HYP 5 + ======================================= 2 6 3 7 This file documents the interaction between the Linux kernel and the 4 8 hypervisor layer when running Linux as a hypervisor (for example ··· 23 19 Unless specified otherwise, any built-in hypervisor must implement 24 20 these functions (see arch/arm{,64}/include/asm/virt.h): 25 21 26 - * r0/x0 = HVC_SET_VECTORS 27 - r1/x1 = vectors 22 + * :: 23 + 24 + r0/x0 = HVC_SET_VECTORS 25 + r1/x1 = vectors 28 26 29 27 Set HVBAR/VBAR_EL2 to 'vectors' to enable a hypervisor. 'vectors' 30 28 must be a physical address, and respect the alignment requirements 31 29 of the architecture. Only implemented by the initial stubs, not by 32 30 Linux hypervisors. 33 31 34 - * r0/x0 = HVC_RESET_VECTORS 32 + * :: 33 + 34 + r0/x0 = HVC_RESET_VECTORS 35 35 36 36 Turn HYP/EL2 MMU off, and reset HVBAR/VBAR_EL2 to the initials 37 37 stubs' exception vector value. This effectively disables an existing 38 38 hypervisor. 39 39 40 - * r0/x0 = HVC_SOFT_RESTART 41 - r1/x1 = restart address 42 - x2 = x0's value when entering the next payload (arm64) 43 - x3 = x1's value when entering the next payload (arm64) 44 - x4 = x2's value when entering the next payload (arm64) 40 + * :: 41 + 42 + r0/x0 = HVC_SOFT_RESTART 43 + r1/x1 = restart address 44 + x2 = x0's value when entering the next payload (arm64) 45 + x3 = x1's value when entering the next payload (arm64) 46 + x4 = x2's value when entering the next payload (arm64) 45 47 46 48 Mask all exceptions, disable the MMU, move the arguments into place 47 49 (arm64 only), and jump to the restart address while at HYP/EL2. This
+1
Documentation/virt/kvm/arm/index.rst
··· 7 7 .. toctree:: 8 8 :maxdepth: 2 9 9 10 + hyp-abi 10 11 pvtime