[PATCH v4 13/13] Documentation: KVM: arm64: Describe the ITS hardening
From: Fuad Tabba
Date: Wed Nov 18 2026 - 10:22:01 EST
Describe in pkvm.rst why the hypervisor emulates the host's ITS, and how
protected mode differs from non-protected mode as a result.
Signed-off-by: Fuad Tabba <fuad.tabba@xxxxxxxxx>
---
Documentation/virt/kvm/arm/pkvm.rst | 34 +++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
diff --git a/Documentation/virt/kvm/arm/pkvm.rst b/Documentation/virt/kvm/arm/pkvm.rst
index b75bb8ad6f26d..c1b1b8089ff72 100644
--- a/Documentation/virt/kvm/arm/pkvm.rst
+++ b/Documentation/virt/kvm/arm/pkvm.rst
@@ -89,6 +89,40 @@ DMA isolation using an IOMMU
Status: **Unimplemented.**
+GICv3 ITS hardening
+-------------------
+
+Status: Host accesses to the ITS control registers are trapped and
+emulated by the hypervisor. The LPI configuration and pending tables
+remain under host control.
+
+The ITS reads and writes memory at addresses programmed by the host, so
+the hypervisor emulates the ITS control registers and command queue to
+ensure that the host cannot point the ITS command queue or tables at
+hypervisor or pVM memory. The hypervisor owns the command queue and
+the ITS tables for as long as the ITS can access them, and it owns each
+device's interrupt translation table from the device's first mapping
+onwards.
+
+This gives rise to some user-visible differences when compared to
+non-protected mode:
+
+* Protected mode requires the hypervisor to take control of every ITS
+ that the host uses. KVM does not initialise with more than 8 ITSes, and
+ if the takeover fails the host is not deprivileged and
+ ``KVM_CREATE_VM`` returns ``-ENODEV``.
+* An ITS command or register access that the hypervisor rejects is
+ delivered to the host as a data abort.
+* The number of device IDs used through each ITS since boot is limited
+ by the hypervisor, and MSI allocation fails with ``-ENOMEM`` beyond
+ that limit.
+* Interrupt translation tables are page-aligned and are not freed when
+ a device is removed, so each device ID used since boot holds at least
+ one page.
+* GICv4 is disabled. Direct injection of LPIs is not available to
+ non-protected guests, and restoring a guest migrated from a host with
+ ``GICD_TYPER2.nASSGIcap`` set fails with ``-EINVAL``.
+
Proxying of Trustzone services
------------------------------
--
2.47.3