linux/Documentation/virt/kvm/devices
Sascha Bischoff d51c978b7d KVM: arm64: gic-v5: Communicate userspace-driveable PPIs via a UAPI
GICv5 systems will likely not support the full set of PPIs. The
presence of any virtual PPI is tied to the presence of the physical
PPI. Therefore, the available PPIs will be limited by the physical
host. Userspace cannot drive any PPIs that are not implemented.

Moreover, it is not desirable to expose all PPIs to the guest in the
first place, even if they are supported in hardware. Some devices,
such as the arch timer, are implemented in KVM, and hence those PPIs
shouldn't be driven by userspace, either.

Provided a new UAPI:
  KVM_DEV_ARM_VGIC_GRP_CTRL => KVM_DEV_ARM_VGIC_USERPSPACE_PPIs

This allows userspace to query which PPIs it is able to drive via
KVM_IRQ_LINE.

Additionally, introduce a check in kvm_vm_ioctl_irq_line() to reject
any PPIs not in the userspace mask.

Signed-off-by: Sascha Bischoff <sascha.bischoff@arm.com>
Reviewed-by: Jonathan Cameron <jonathan.cameron@huawei.com>
Link: https://patch.msgid.link/20260319154937.3619520-40-sascha.bischoff@arm.com
Signed-off-by: Marc Zyngier <maz@kernel.org>
2026-03-19 18:21:29 +00:00
..
arm-vgic-its.rst KVM: arm64: Document ordering requirements for irqbypass 2025-02-26 13:22:49 -08:00
arm-vgic-v3.rst Documentation: KVM: Update GICv3 docs for GICv5 hosts 2025-10-13 14:40:58 +01:00
arm-vgic-v5.rst KVM: arm64: gic-v5: Communicate userspace-driveable PPIs via a UAPI 2026-03-19 18:21:29 +00:00
arm-vgic.rst KVM: Documentation: Correct the VGIC V2 CPU interface addr space size 2024-06-28 22:00:24 +00:00
index.rst Documentation: KVM: Introduce documentation for VGICv5 2026-03-19 18:21:29 +00:00
mpic.rst docs: kvm: convert devices/mpic.txt to ReST 2020-02-12 20:09:54 +01:00
README
s390_flic.rst KVM: s390: Reject setting flic pfault attributes on ucontrol VMs 2025-01-07 16:36:10 +01:00
vcpu.rst KVM: arm64: gic-v5: Mandate architected PPI for PMU emulation on GICv5 2026-03-19 18:21:29 +00:00
vfio.rst kvm/vfio: Accept vfio device file from userspace 2023-07-25 10:18:42 -06:00
vm.rst Documentation: Fix typos 2023-08-18 11:29:03 -06:00
xics.rst kvm: rename KVM_MAX_VCPU_ID to KVM_MAX_VCPU_IDS 2021-09-30 04:27:05 -04:00
xive.rst Documentation: Fix typos 2023-08-18 11:29:03 -06:00

This directory contains specific device bindings for KVM_CAP_DEVICE_CTRL.