From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> To: Linux Media Mailing List <linux-media@vger.kernel.org> Cc: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>, Mauro Carvalho Chehab <mchehab@infradead.org>, Paolo Bonzini <pbonzini@redhat.com>, Jonathan Corbet <corbet@lwn.net>, kvm@vger.kernel.org, linux-doc@vger.kernel.org Subject: [PATCH 18/27] docs: kvm: convert arm/hyp-abi.txt to ReST Date: Tue, 28 Jan 2020 15:00:19 +0100 [thread overview] Message-ID: <707c15ba05c14b49801e29840154ee1aed5cd910.1580219586.git.mchehab+huawei@kernel.org> (raw) In-Reply-To: <cover.1580219586.git.mchehab+huawei@kernel.org> - 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> --- .../virt/kvm/arm/{hyp-abi.txt => hyp-abi.rst} | 26 ++++++++++++------- Documentation/virt/kvm/arm/index.rst | 1 + 2 files changed, 18 insertions(+), 9 deletions(-) rename Documentation/virt/kvm/arm/{hyp-abi.txt => hyp-abi.rst} (80%) diff --git a/Documentation/virt/kvm/arm/hyp-abi.txt b/Documentation/virt/kvm/arm/hyp-abi.rst similarity index 80% rename from Documentation/virt/kvm/arm/hyp-abi.txt rename to Documentation/virt/kvm/arm/hyp-abi.rst index a20a0bee268d..cf74b5b87df6 100644 --- a/Documentation/virt/kvm/arm/hyp-abi.txt +++ b/Documentation/virt/kvm/arm/hyp-abi.rst @@ -1,4 +1,6 @@ -* Internal ABI between the kernel and HYP +======================================= +Internal ABI between the kernel and HYP +======================================= This file documents the interaction between the Linux kernel and the hypervisor layer when running Linux as a hypervisor (for example @@ -19,25 +21,31 @@ and only act on individual CPUs. Unless specified otherwise, any built-in hypervisor must implement these functions (see arch/arm{,64}/include/asm/virt.h): -* r0/x0 = HVC_SET_VECTORS - r1/x1 = vectors +* :: + + r0/x0 = HVC_SET_VECTORS + r1/x1 = vectors Set HVBAR/VBAR_EL2 to 'vectors' to enable a hypervisor. 'vectors' must be a physical address, and respect the alignment requirements of the architecture. Only implemented by the initial stubs, not by Linux hypervisors. -* r0/x0 = HVC_RESET_VECTORS +* :: + + r0/x0 = HVC_RESET_VECTORS Turn HYP/EL2 MMU off, and reset HVBAR/VBAR_EL2 to the initials stubs' exception vector value. This effectively disables an existing hypervisor. -* r0/x0 = HVC_SOFT_RESTART - r1/x1 = restart address - x2 = x0's value when entering the next payload (arm64) - x3 = x1's value when entering the next payload (arm64) - x4 = x2's value when entering the next payload (arm64) +* :: + + r0/x0 = HVC_SOFT_RESTART + r1/x1 = restart address + x2 = x0's value when entering the next payload (arm64) + x3 = x1's value when entering the next payload (arm64) + x4 = x2's value when entering the next payload (arm64) Mask all exceptions, disable the MMU, move the arguments into place (arm64 only), and jump to the restart address while at HYP/EL2. This diff --git a/Documentation/virt/kvm/arm/index.rst b/Documentation/virt/kvm/arm/index.rst index e039d9b1e076..134fa5fa77e5 100644 --- a/Documentation/virt/kvm/arm/index.rst +++ b/Documentation/virt/kvm/arm/index.rst @@ -7,4 +7,5 @@ ARM .. toctree:: :maxdepth: 2 + hyp-abi pvtime -- 2.24.1
WARNING: multiple messages have this Message-ID (diff)
From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> To: Linux Media Mailing List <linux-media@vger.kernel.org> Cc: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>, Mauro Carvalho Chehab <mchehab@infradead.org>, Paolo Bonzini <pbonzini@redhat.com>, Jonathan Corbet <corbet@lwn.net>, kvm@vger.kernel.org, linux-doc@vger.kernel.org Subject: [PATCH 18/27] docs: kvm: convert arm/hyp-abi.txt to ReST Date: Tue, 28 Jan 2020 14:58:14 +0100 [thread overview] Message-ID: <707c15ba05c14b49801e29840154ee1aed5cd910.1580219586.git.mchehab+huawei@kernel.org> (raw) Message-ID: <20200128135814.LKEmh-6rf9i6L0ZTWeJjPzD5ysO4-A_ZvcKWIO8qjps@z> (raw) In-Reply-To: <cover.1580219586.git.mchehab+huawei@kernel.org> - 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> --- .../virt/kvm/arm/{hyp-abi.txt => hyp-abi.rst} | 26 ++++++++++++------- Documentation/virt/kvm/arm/index.rst | 1 + 2 files changed, 18 insertions(+), 9 deletions(-) rename Documentation/virt/kvm/arm/{hyp-abi.txt => hyp-abi.rst} (80%) diff --git a/Documentation/virt/kvm/arm/hyp-abi.txt b/Documentation/virt/kvm/arm/hyp-abi.rst similarity index 80% rename from Documentation/virt/kvm/arm/hyp-abi.txt rename to Documentation/virt/kvm/arm/hyp-abi.rst index a20a0bee268d..cf74b5b87df6 100644 --- a/Documentation/virt/kvm/arm/hyp-abi.txt +++ b/Documentation/virt/kvm/arm/hyp-abi.rst @@ -1,4 +1,6 @@ -* Internal ABI between the kernel and HYP +======================================= +Internal ABI between the kernel and HYP +======================================= This file documents the interaction between the Linux kernel and the hypervisor layer when running Linux as a hypervisor (for example @@ -19,25 +21,31 @@ and only act on individual CPUs. Unless specified otherwise, any built-in hypervisor must implement these functions (see arch/arm{,64}/include/asm/virt.h): -* r0/x0 = HVC_SET_VECTORS - r1/x1 = vectors +* :: + + r0/x0 = HVC_SET_VECTORS + r1/x1 = vectors Set HVBAR/VBAR_EL2 to 'vectors' to enable a hypervisor. 'vectors' must be a physical address, and respect the alignment requirements of the architecture. Only implemented by the initial stubs, not by Linux hypervisors. -* r0/x0 = HVC_RESET_VECTORS +* :: + + r0/x0 = HVC_RESET_VECTORS Turn HYP/EL2 MMU off, and reset HVBAR/VBAR_EL2 to the initials stubs' exception vector value. This effectively disables an existing hypervisor. -* r0/x0 = HVC_SOFT_RESTART - r1/x1 = restart address - x2 = x0's value when entering the next payload (arm64) - x3 = x1's value when entering the next payload (arm64) - x4 = x2's value when entering the next payload (arm64) +* :: + + r0/x0 = HVC_SOFT_RESTART + r1/x1 = restart address + x2 = x0's value when entering the next payload (arm64) + x3 = x1's value when entering the next payload (arm64) + x4 = x2's value when entering the next payload (arm64) Mask all exceptions, disable the MMU, move the arguments into place (arm64 only), and jump to the restart address while at HYP/EL2. This diff --git a/Documentation/virt/kvm/arm/index.rst b/Documentation/virt/kvm/arm/index.rst index e039d9b1e076..134fa5fa77e5 100644 --- a/Documentation/virt/kvm/arm/index.rst +++ b/Documentation/virt/kvm/arm/index.rst @@ -7,4 +7,5 @@ ARM .. toctree:: :maxdepth: 2 + hyp-abi pvtime -- 2.24.1
next prev parent reply other threads:[~2020-01-28 14:49 UTC|newest] Thread overview: 64+ messages / expand[flat|nested] mbox.gz Atom feed top 2020-01-28 13:57 [PATCH 00/27] docs: virt: convert text documents to ReST format Mauro Carvalho Chehab 2020-01-28 13:57 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:57 ` [PATCH 01/27] docs: kvm: add arm/pvtime.rst to index.rst Mauro Carvalho Chehab 2020-01-28 13:57 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:57 ` [PATCH 02/27] docs: virt: convert UML documentation to ReST Mauro Carvalho Chehab 2020-01-28 13:57 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:57 ` [PATCH 03/27] docs: virt: user_mode_linux.rst: update compiling instructions Mauro Carvalho Chehab 2020-01-28 13:57 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 04/27] docs: virt: user_mode_linux.rst: fix URL references Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 05/27] docs: virt: convert halt-polling.txt to ReST format Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 06/27] docs: virt: Convert msr.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 07/27] docs: kvm: devices/arm-vgic-its.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 08/27] docs: kvm: devices/arm-vgit-v3.txt to ReST Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 09/27] docs: kvm: convert devices/arm-vgit.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 10/27] docs: kvm: convert devices/mpic.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 11/27] docs: kvm: convert devices/s390_flic.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 18:11 ` Cornelia Huck 2020-01-28 18:13 ` Cornelia Huck 2020-01-28 20:38 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 12/27] docs: kvm: convert devices/vcpu.txt " Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 13/27] " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 14/27] docs: kvm: convert devices/vm.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 15/27] docs: kvm: convert devices/xics.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 16/27] docs: kvm: convert devices/xive.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 17/27] docs: kvm: Convert api.txt to ReST format Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab [this message] 2020-01-28 13:58 ` [PATCH 18/27] docs: kvm: convert arm/hyp-abi.txt to ReST Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 19/27] docs: kvm: arm/psci.txt: convert " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 20/27] docs: kvm: Convert hypercalls.txt to ReST format Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 21/27] docs: kvm: Convert locking.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 22/27] docs: kvm: Convert mmu.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 23/27] docs: kvm: Convert nested-vmx.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 24/27] docs: kvm: Convert ppc-pv.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 25/27] docs: kvm: Convert s390-diag.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 18:15 ` Cornelia Huck 2020-01-28 13:58 ` [PATCH 26/27] docs: kvm: Convert timekeeping.txt " Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab 2020-01-28 13:58 ` [PATCH 27/27] docs: kvm: review-checklist.txt: rename to ReST Mauro Carvalho Chehab 2020-01-28 13:58 ` Mauro Carvalho Chehab 2020-01-28 14:00 ` Mauro Carvalho Chehab
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=707c15ba05c14b49801e29840154ee1aed5cd910.1580219586.git.mchehab+huawei@kernel.org \ --to=mchehab+huawei@kernel.org \ --cc=corbet@lwn.net \ --cc=kvm@vger.kernel.org \ --cc=linux-doc@vger.kernel.org \ --cc=linux-media@vger.kernel.org \ --cc=mchehab@infradead.org \ --cc=pbonzini@redhat.com \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.