pci/msi/api.c

3  * PCI MSI/MSI-X — Exported APIs for device drivers
14 #include "msi.h"
17  * pci_enable_msi() - Enable MSI interrupt mode on device
20  * Legacy device driver API to enable MSI interrupts mode on device and
40  * pci_disable_msi() - Disable MSI interrupt mode on device
43  * Legacy device driver API to disable MSI interrupt mode on device,
64  * pci_msix_vec_count() - Get number of MSI-X interrupt vectors on device
67  * Return: number of MSI-X interrupt vectors available on this device
68  * (i.e., the device's MSI-X capability structure "table size"), -EINVAL
69  * if the device is not MSI-X capable, other errnos otherwise.
84  * pci_enable_msix_range() - Enable MSI-X interrupt mode on device
86  * @entries: input/output parameter, array of MSI-X configuration entries
87  * @minvec:  minimum required number of MSI-X vectors
88  * @maxvec:  maximum desired number of MSI-X vectors
90  * Legacy device driver API to enable MSI-X interrupt mode on device and
91  * configure its MSI-X capability structure as appropriate.  The passed
93  * desired (valid) MSI-X vector number, where the range of valid MSI-X
100  * Return: number of MSI-X vectors allocated (which might be smaller
105  * was invalid or a duplicate, or if plain MSI interrupts mode was
117  *			    MSI-X is supported
133  * pci_msix_alloc_irq_at - Allocate an MSI-X interrupt after enabling MSI-X
134  *			   at a given MSI-X vector index or any free vector index
138  *		the next free index in the MSI-X table
170  * Undo an interrupt vector allocation. Does not disable MSI-X.
183  * pci_disable_msix() - Disable MSI-X interrupt mode on device
186  * Legacy device driver API to disable MSI-X interrupt mode on device,
213  *            * %PCI_IRQ_MSIX      Allow trying MSI-X vector allocations
214  *            * %PCI_IRQ_MSI       Allow trying MSI vector allocations
222  * Allocate up to @max_vecs interrupt vectors on device. MSI-X irq
223  * vector allocation has a higher precedence over plain MSI, which has a
307  *         * MSI-X     the index in the MSI-X vector table
308  *         * MSI       the index of the enabled MSI vectors
331  *         * MSI-X     the index in the MSI-X vector table
332  *         * MSI       the index of the enabled MSI vectors
335  * Return: MSI/MSI-X vector affinity, NULL if @nr is out of range or if
336  * the MSI(-X) vector was allocated without explicit affinity
351 	/* Non-MSI does not have the information handy */  in pci_irq_get_affinity()
355 	/* MSI[X] interrupts can be allocated without affinity descriptor */  in pci_irq_get_affinity()
360 	 * MSI has a mask array in the descriptor.  in pci_irq_get_affinity()
361 	 * MSI-X has a single mask.  in pci_irq_get_affinity()
372  * Undo the interrupt vector allocations and possible device MSI/MSI-X
384  * pci_restore_msi_state() - Restore cached MSI(-X) state on device
387  * Write the Linux-cached MSI(-X) state back on device. This is
399  * pci_msi_enabled() - Are MSI(-X) interrupts enabled system-wide?
401  * Return: true if MSI has not been globally disabled through ACPI FADT,