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
30 #include <asm/msi.h>
56  * msi_msg - Representation of a MSI message
57  * @address_lo:		Low 32 bits of msi message address
59  * @address_hi:		High 32 bits of msi message address
62  * @data:		MSI message data (usually 16 bits)
100  * pci_msi_desc - PCI/MSI specific MSI descriptor data
102  * @msi_mask:	[PCI MSI]   MSI cached mask bits
103  * @msix_ctrl:	[PCI MSI-X] MSI-X cached per vector control bits
104  * @is_msix:	[PCI MSI/X] True if MSI-X
105  * @multiple:	[PCI MSI/X] log2 num of messages allocated
106  * @multi_cap:	[PCI MSI/X] log2 num of messages supported
107  * @can_mask:	[PCI MSI/X] Masking supported?
108  * @is_64:	[PCI MSI/X] Address size: 0=32bit 1=64bit
109  * @default_irq:[PCI MSI/X] The default pre-assigned non-MSI irq
110  * @mask_pos:	[PCI MSI]   Mask register position
111  * @mask_base:	[PCI MSI-X] Mask register base address
134  * union msi_domain_cookie - Opaque MSI domain specific data
139  * The content of this data is implementation defined and used by the MSI
150  * struct msi_desc_data - Generic MSI descriptor data
151  * @dcookie:	Cookie for MSI domain specific data which is required
153  * @icookie:	Cookie for the MSI interrupt instance provided by
157  * implementations define the meaning of the data. The MSI core ignores
168  * struct msi_desc - Descriptor structure for MSI based interrupts
172  * @msg:	The last set MSI message cached for reuse
176  * @write_msi_msg:	Callback that may be called when the MSI message
180  * @msi_index:	Index of the msi descriptor
181  * @pci:	PCI specific msi descriptor data
182  * @data:	Generic MSI descriptor data
209  * Filter values for the MSI descriptor iterators and accessor functions.
222  * struct msi_dev_domain - The internals of MSI domain info per device
223  * @store:		Xarray for storing MSI descriptor pointers
232  * msi_device_data - MSI per device data
233  * @properties:		MSI properties which are interesting to drivers
234  * @platform_data:	Platform-MSI specific data
235  * @mutex:		Mutex protecting the MSI descriptor store
236  * @__domains:		Internal data for per device MSI domains
256  * msi_first_desc - Get the first MSI descriptor of the default irqdomain
260  * Must be called with the MSI descriptor mutex held, i.e. msi_lock_descs()
263  * Return: Pointer to the first MSI descriptor matching the search
276  * msi_domain_for_each_desc - Iterate the MSI descriptors in a specific domain
286  *  - It is safe to remove a retrieved MSI descriptor in the loop.
293  * msi_for_each_desc - Iterate the MSI descriptors in the default irqdomain
302  *  - It is safe to remove a retrieved MSI descriptor in the loop.
335  * msi_insert_msi_desc - Allocate and initialize a MSI descriptor in the
338  * @init_desc:	Pointer to an MSI descriptor to initialize the new descriptor
351  * msi_free_msi_descs_range - Free a range of MSI descriptors of a device
365  * msi_free_msi_descs - Free all MSI descriptors of a device in the default irqdomain
374  * The arch hooks to setup up msi irqs. Default functions are implemented
390  * entries of MSI IRQs.
420  * struct msi_domain_ops - MSI interrupt domain callbacks
422  * @msi_init:		Domain specific init function for MSI interrupts
423  * @msi_free:		Domain specific function to free a MSI interrupts
425  * @prepare_desc:	Optional function to prepare the allocated MSI descriptor
427  * @set_desc:		Set the msi descriptor for an interrupt
443  * is initially for a wrapper around XENs seperate MSI universe which can't
474  * struct msi_domain_info - MSI interrupt domain data
503  * struct msi_domain_template - Template for MSI device domains
506  * @ops:	MSI domain ops
507  * @info:	MSI domain info data
519  * Bit 0-15:	Generic MSI functionality which is not subject to restriction
524  *		a device MSI domain is initialized.
528 	 * Init non implemented ops callbacks with default MSI domain
533 	 * Init non implemented chip callbacks with default MSI chip
546 	/* Allocate simple MSI descriptors */
548 	/* Free MSI descriptors */
557 	/* Support multiple PCI MSI interrupts */
563 	/* MSI-X entries must be contiguous */
565 	/* PCI/MSI-X vectors can be dynamically allocated/freed post MSI-X enable */
572  * struct msi_parent_ops - MSI parent domain callbacks and configuration info
574  * @supported_flags:	Required: The supported MSI flags of the parent domain
576  * @init_dev_msi_info:	Required: Callback for MSI parent domains to setup parent
634 /* When an MSI domain is used as an intermediate domain */
665 	 * Arguably if the platform does not enable MSI support then it has  in msi_device_has_isolated_msi()
666 	 * "isolated MSI", as an interrupt controller that cannot receive MSIs  in msi_device_has_isolated_msi()