Commit 76a10b86 authored by Eric Auger's avatar Eric Auger Committed by Marc Zyngier
Browse files

KVM: api: Pass the devid in the msi routing entry 



On ARM, the MSI msg (address and data) comes along with
out-of-band device ID information. The device ID encodes the
device that writes the MSI msg. Let's convey the device id in
kvm_irq_routing_msi and use KVM_MSI_VALID_DEVID flag value in
kvm_irq_routing_entry to indicate the msi devid is populated.

Signed-off-by: default avatarEric Auger <eric.auger@redhat.com>
Reviewed-by: default avatarAndre Przywara <andre.przywara@arm.com>
Acked-by: default avatarRadim Krčmář <rkrcmar@redhat.com>
Signed-off-by: default avatarMarc Zyngier <marc.zyngier@arm.com>
parent 3a88bded

Documentation/virtual/kvm/api.txt

+17 −2
Original line number Diff line number Diff line
@@ -1468,7 +1468,11 @@ struct kvm_irq_routing_entry { 
#define KVM_IRQ_ROUTING_S390_ADAPTER 3

#define KVM_IRQ_ROUTING_HV_SINT 4



No flags are specified so far, the corresponding field must be set to zero.

flags:

- KVM_MSI_VALID_DEVID: used along with KVM_IRQ_ROUTING_MSI

  routing entry type, specifies that the devid field contains

  a valid value.

- zero otherwise



struct kvm_irq_routing_irqchip {

	__u32 irqchip;
@@ -1479,8 +1483,19 @@ struct kvm_irq_routing_msi { 
	__u32 address_lo;

	__u32 address_hi;

	__u32 data;

	union {

		__u32 pad;

		__u32 devid;

	};

};



devid: If KVM_MSI_VALID_DEVID is set, contains a unique device identifier

       for the device that wrote the MSI message.

       For PCI, this is usually a BFD identifier in the lower 16 bits.



The per-VM KVM_CAP_MSI_DEVID capability advertises the requirement to

provide the device ID. If this capability is not set, userland cannot

rely on the kernel to allow the KVM_MSI_VALID_DEVID flag being set.



struct kvm_irq_routing_s390_adapter {

	__u64 ind_addr;

include/uapi/linux/kvm.h

+4 −1
Original line number Diff line number Diff line
@@ -879,7 +879,10 @@ struct kvm_irq_routing_msi { 
	__u32 address_lo;

	__u32 address_hi;

	__u32 data;

	union {

		__u32 pad;

		__u32 devid;

	};

};



struct kvm_irq_routing_s390_adapter {

CRA Git | Maintained and supported by SUSTech CRA and CCSE