kvm/devices/s390_flic.rst

1 .. SPDX-License-Identifier: GPL-2.0
7 FLIC handles floating (non per-cpu) interrupts, i.e. I/O, service and some
8 machine check interruptions. All interrupts are stored in a per-vm list of
14 - add interrupts (KVM_DEV_FLIC_ENQUEUE)
15 - inspect currently pending interrupts (KVM_FLIC_GET_ALL_IRQS)
16 - purge all pending floating interrupts (KVM_DEV_FLIC_CLEAR_IRQS)
17 - purge one pending floating I/O interrupt (KVM_DEV_FLIC_CLEAR_IO_IRQ)
18 - enable/disable for the guest transparent async page faults
19 - register and modify adapter interrupt sources (KVM_DEV_FLIC_ADAPTER_*)
20 - modify AIS (adapter-interruption-suppression) mode state (KVM_DEV_FLIC_AISM)
21 - inject adapter interrupts on a specified adapter (KVM_DEV_FLIC_AIRQ_INJECT)
22 - get/set all AIS mode states (KVM_DEV_FLIC_AISM_ALL)
28     attr->addr contains the pointer to the buffer and attr->attr contains
35     When the buffer is too small it returns -ENOMEM, which is the indication
38     -ENOBUFS is returned when the allocation of a kernelspace buffer has
41     -EFAULT is returned when copying data to userspace failed.
44     attr->addr contains the userspace address of the buffer into which all
46     attr->attr contains the size of the buffer in bytes.
55     attr->addr (address) and attr->attr (length).
58     Enables async page faults for the guest. So in case of a major page fault
85    - KVM_S390_ADAPTER_SUPPRESSIBLE: adapter is subject to AIS
86      (adapter-interrupt-suppression) facility. This flag only has an effect if
111       This is now a no-op. The mapping is purely done by the irq route.
113       This is now a no-op. The mapping is purely done by the irq route.
116     modify the adapter-interruption-suppression mode for a given isc if the
125     adapter-interruption-suppression mode. The following modes are
128     - KVM_S390_AIS_MODE_ALL: ALL-Interruptions Mode, i.e. airq injection
130     - KVM_S390_AIS_MODE_SINGLE: SINGLE-Interruption Mode, i.e. airq
132       will be suppressed until the mode is set again to ALL-Interruptions
133       or SINGLE-Interruption mode.
136     Inject adapter interrupts on a specified adapter.
137     attr->attr contains the unique id for the adapter, which allows for
138     adapter-specific checks and actions.
140     an isc according to the adapter-interruption-suppression mode on condition
144     Gets or sets the adapter-interruption-suppression mode for all ISCs. Takes
148 	       __u8 simm; /* Single-Interruption-Mode mask */
149 	       __u8 nimm; /* No-Interruption-Mode mask *
152     simm contains Single-Interruption-Mode mask for all ISCs, nimm contains
153     No-Interruption-Mode mask for all ISCs. Each bit in simm and nimm corresponds