kvm/devices/xive.rst

1 .. SPDX-License-Identifier: GPL-2.0
8   - KVM_DEV_TYPE_XIVE     POWER9 XIVE Interrupt Controller generation 1
32       - Interrupt Pending Buffer     (IPB)
33       - Current Processor Priority   (CPPR)
34       - Notification Source Register (NSR)
39   third (operating system) and the fourth (user level) are exposed the
49   3. Device pass-through
51   When a device is passed-through into the guest, the source
61   interrupt of the device being passed-through or the initial IPI ESB
66   helpers in KVM-PPC.
81     Sync all the sources and queues and mark the EQ pages dirty. This
94       -EINVAL  Value greater than KVM_MAX_VCPU_IDS.
95       -EFAULT  Invalid user pointer for attr->addr.
96       -EBUSY   A vCPU is already connected to the device.
103     Interrupt source number  (64-bit)
108     values:   |    unused    | level | type
110   - type:  0:MSI 1:LSI
111   - level: assertion level in case of an LSI.
116     -E2BIG   Interrupt source number is out of range
117     -ENOMEM  Could not create a new source block
118     -EFAULT  Invalid user pointer for attr->addr.
119     -ENXIO   Could not allocate underlying HW interrupt
126     Interrupt source number  (64-bit)
133   - priority: 0-7 interrupt priority level
134   - server: CPU number chosen to handle the interrupt
135   - mask: mask flag (unused)
136   - eisn: Effective Interrupt Source Number
141     -ENOENT  Unknown source number
142     -EINVAL  Not initialized source number
143     -EINVAL  Invalid priority
144     -EINVAL  Invalid CPU number.
145     -EFAULT  Invalid user pointer for attr->addr.
146     -ENXIO   CPU event queues not configured or configuration of the
148     -EBUSY   No CPU available to serve interrupt
151 4. KVM_DEV_XIVE_GRP_EQ_CONFIG (read-write)
155     EQ descriptor identifier (64-bit)
157   The EQ descriptor identifier is a tuple (server, priority)::
173   - flags: queue flags
177   - qshift: queue size (power of 2)
178   - qaddr: real address of queue
179   - qtoggle: current queue toggle bit
180   - qindex: current queue index
181   - pad: reserved for future use
186     -ENOENT  Invalid CPU number
187     -EINVAL  Invalid priority
188     -EINVAL  Invalid flags
189     -EINVAL  Invalid queue size
190     -EINVAL  Invalid queue address
191     -EFAULT  Invalid user pointer for attr->addr.
192     -EIO     Configuration of the underlying HW failed
199     Interrupt source number  (64-bit)
204     -ENOENT  Unknown source number
205     -EINVAL  Not initialized source number
234   flush any in-flight event notification and to stabilize the EQs. At
235   this stage, the EQ pages are marked dirty to make sure they are
243   1. Restore the EQ configuration. As targeting depends on it.