github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-06-20 12:42:54 +00:00
Code Issues Projects Releases Wiki Activity

Doc: Final edits to the HV Hypercall doc.

Browse Source 
Signed-off-by: Deb Taylor <deb.taylor@intel.com>
This commit is contained in:
Deb Taylor 2019-11-08 17:28:46 -05:00 committed by deb-intel
parent a1dca993e8
commit dec914f588
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/developer-guides/hld/hv-hypercall.rst
View File

@ -3,35 +3,35 @@
Hypercall / VHM upcall Hypercall / VHM upcall
###################### ######################
Hypercall/upcall used to request services between Guest VM and hypervisor, The hypercall/upcall is used to request services between the Guest VM and the hypervisor.
hypercall is from Guest VM to hypervisor, upcall is from hypervisor to Guest VM. The hypercall is from the Guest VM to hypervisor, and the upcall is from the hypervisor to the Guest VM.
Hypervisor currently supports hypercall APIs for VM management, I/O request The hypervisor currently supports hypercall APIs for VM management, I/O request
distribution,interrupt injection, PCI assignment, guest memory mapping, distribution, interrupt injection, PCI assignment, guest memory mapping,
power management and secure world switch. power management, and secure world switch.
There are some restrictions for hypercall and upcall: There are some restrictions for hypercall and upcall:
#. Only ring0 hypercalls from the guest VM are handled by the hypervisor, #. Only ring 0 hypercalls from the guest VM are handled by the hypervisor;
otherwise hypervisor will inject GP to Guest VM. otherwise, the hypervisor will inject GP to the Guest VM.
#. All the hypercalls (except secure world hypercalls) must be called from SOS VM, #. All the hypercalls (except secure world hypercalls) must be called from the Service VM;
otherwise hypervisor will inject UD to Guest VM. otherwise, the hypervisor will inject UD to the Guest VM.
see :ref:`secure-hypervisor-interface` for a detailed description. see :ref:`secure-hypervisor-interface` for a detailed description.
#. Hypervisor needs to protect the critical resources such as global VM and VCPU structures #. The hypervisor needs to protect the critical resources such as global VM and VCPU structures
for VM and VCPU management hypercalls. for VM and VCPU management hypercalls.
#. Upcall is only used for SOS VM. #. Upcall is only used for the Service VM.
HV and Service OS (SOS) both use the same vector(0xF3) reserved as x86 platform HV and Service VM both use the same vector (0xF3) reserved as x86 platform
IPI vector for HV notification to SOS. This upcall is necessary whenever IPI vector for HV notification to the Service VM. This upcall is necessary whenever
there is device emulation requirement to SOS. The upcall vector(0xF3) is there is device emulation requirement to the Service VM. The upcall vector (0xF3) is
injected to SOS vCPU0.SOS will register the irq handler for vector(0xF3) and notify the I/O emulation injected to Service VM vCPU0. The Service VM will register the irq handler for vector (0xF3) and notify the I/O emulation
module in SOS once the irq is triggered. module in the Service VM once the irq is triggered.
The detailed upcall process see :ref:`ipi-management` View the detailed upcall process at :ref:`ipi-management`
Hypercall APIs reference: Hypercall APIs reference:
************************* *************************
:ref:`hypercall_apis` for SOS :ref:`hypercall_apis` for the Service VM
:ref:`trusty-hypercalls` for Trusty :ref:`trusty-hypercalls` for Trusty