include/linux/msi.h

6  * This header file contains MSI data structures and functions which are
9  *	- PCI/MSI core code
10  *	- MSI interrupt domain implementations
12  *	  dealing with low level MSI details.
15  * especially storing MSI descriptor pointers in random code is considered
26 #include <asm/msi.h>
52  * msi_msg - Representation of a MSI message
53  * @address_lo:		Low 32 bits of msi message address
55  * @address_hi:		High 32 bits of msi message address
58  * @data:		MSI message data (usually 16 bits)
95  * pci_msi_desc - PCI/MSI specific MSI descriptor data
97  * @msi_mask:	[PCI MSI]   MSI cached mask bits
98  * @msix_ctrl:	[PCI MSI-X] MSI-X cached per vector control bits
99  * @is_msix:	[PCI MSI/X] True if MSI-X
100  * @multiple:	[PCI MSI/X] log2 num of messages allocated
101  * @multi_cap:	[PCI MSI/X] log2 num of messages supported
102  * @can_mask:	[PCI MSI/X] Masking supported?
103  * @is_64:	[PCI MSI/X] Address size: 0=32bit 1=64bit
104  * @default_irq:[PCI MSI/X] The default pre-assigned non-MSI irq
105  * @mask_pos:	[PCI MSI]   Mask register position
106  * @mask_base:	[PCI MSI-X] Mask register base address
129  * union msi_domain_cookie - Opaque MSI domain specific data
134  * The content of this data is implementation defined and used by the MSI
145  * struct msi_desc_data - Generic MSI descriptor data
146  * @dcookie:	Cookie for MSI domain specific data which is required
148  * @icookie:	Cookie for the MSI interrupt instance provided by
152  * implementations define the meaning of the data. The MSI core ignores
163  * struct msi_desc - Descriptor structure for MSI based interrupts
167  * @msg:	The last set MSI message cached for reuse
171  * @write_msi_msg:	Callback that may be called when the MSI message
175  * @msi_index:	Index of the msi descriptor
176  * @pci:	PCI specific msi descriptor data
177  * @data:	Generic MSI descriptor data
204  * Filter values for the MSI descriptor iterators and accessor functions.
217  * struct msi_dev_domain - The internals of MSI domain info per device
218  * @store:		Xarray for storing MSI descriptor pointers
235  * msi_first_desc - Get the first MSI descriptor of the default irqdomain
239  * Must be called with the MSI descriptor mutex held, i.e. msi_lock_descs()
242  * Return: Pointer to the first MSI descriptor matching the search
255  * msi_domain_for_each_desc - Iterate the MSI descriptors in a specific domain
265  *  - It is safe to remove a retrieved MSI descriptor in the loop.
272  * msi_for_each_desc - Iterate the MSI descriptors in the default irqdomain
281  *  - It is safe to remove a retrieved MSI descriptor in the loop.
314  * msi_insert_msi_desc - Allocate and initialize a MSI descriptor in the
317  * @init_desc:	Pointer to an MSI descriptor to initialize the new descriptor
330  * msi_free_msi_descs_range - Free a range of MSI descriptors of a device
344  * msi_free_msi_descs - Free all MSI descriptors of a device in the default irqdomain
353  * The arch hooks to setup up msi irqs. Default functions are implemented
369  * entries of MSI IRQs.
400  * struct msi_domain_ops - MSI interrupt domain callbacks
402  * @msi_init:		Domain specific init function for MSI interrupts
403  * @msi_free:		Domain specific function to free a MSI interrupts
405  * @prepare_desc:	Optional function to prepare the allocated MSI descriptor
407  * @set_desc:		Set the msi descriptor for an interrupt
415  *			MSI bridges, e.g. MBIGEN
425  * is initially for a wrapper around XENs seperate MSI universe which can't
458  * struct msi_domain_info - MSI interrupt domain data
487  * struct msi_domain_template - Template for MSI device domains
490  * @ops:	MSI domain ops
491  * @info:	MSI domain info data
503  * Bit 0-15:	Generic MSI functionality which is not subject to restriction
508  *		a device MSI domain is initialized.
512 	 * Init non implemented ops callbacks with default MSI domain
517 	 * Init non implemented chip callbacks with default MSI chip
530 	/* Allocate simple MSI descriptors */
532 	/* Free MSI descriptors */
534 	/* Use dev->fwnode for MSI device domain creation */
547 	/* Support multiple PCI MSI interrupts */
553 	/* MSI-X entries must be contiguous */
555 	/* PCI/MSI-X vectors can be dynamically allocated/freed post MSI-X enable */
562  * struct msi_parent_ops - MSI parent domain callbacks and configuration info
564  * @supported_flags:	Required: The supported MSI flags of the parent domain
565  * @required_flags:	Optional: The required MSI flags of the parent MSI domain
571  * @init_dev_msi_info:	Required: Callback for MSI parent domains to setup parent
625 /* Per device platform MSI */
641 	 * Arguably if the platform does not enable MSI support then it has  in msi_device_has_isolated_msi()
642 	 * "isolated MSI", as an interrupt controller that cannot receive MSIs  in msi_device_has_isolated_msi()