include/linux/msi.h

1 /* SPDX-License-Identifier: GPL-2.0 */
33  * platform_msi_desc - Platform device specific msi descriptor data
43  * fsl_mc_msi_desc - FSL-MC device specific msi descriptor data
51  * ti_sci_inta_msi_desc - TISCI based INTA specific msi descriptor data
59  * struct msi_desc - Descriptor structure for MSI based interrupts
71  * @masked:	[PCI MSI/X] Mask bits
72  * @is_msix:	[PCI MSI/X] True if MSI-X
73  * @multiple:	[PCI MSI/X] log2 num of messages allocated
74  * @multi_cap:	[PCI MSI/X] log2 num of messages supported
75  * @maskbit:	[PCI MSI/X] Mask-Pending bit supported?
76  * @is_64:	[PCI MSI/X] Address size: 0=32bit 1=64bit
77  * @entry_nr:	[PCI MSI/X] Entry which is described by this descriptor
78  * @default_irq:[PCI MSI/X] The default pre-assigned non-MSI irq
79  * @mask_pos:	[PCI MSI]   Mask register position
80  * @mask_base:	[PCI MSI-X] Mask register base address
82  * @fsl_mc:	[fsl-mc]    FSL MC device specific msi descriptor data
101 		/* PCI MSI/X specific data */
121 		 * Non PCI variants add their data structure here. New
123 		 * proper name spaces for this. The PCI part is
134 #define msi_desc_to_dev(desc)		((desc)->dev)
135 #define dev_to_msi_list(dev)		(&(dev)->msi_list)
146 	return desc->iommu_cookie;  in msi_desc_get_iommu_cookie()
152 	desc->iommu_cookie = iommu_cookie;  in msi_desc_set_iommu_cookie()
167 #define first_pci_msi_entry(pdev)	first_msi_entry(&(pdev)->dev)
169 	for_each_msi_entry((desc), &(pdev)->dev)
214 	return -ENODEV;  in arch_setup_msi_irqs()
225  * for fully irq domain based setups. Courtesy to XEN/X86.
256  * struct msi_domain_ops - MSI interrupt domain callbacks
258  * @msi_init:		Domain specific init function for MSI interrupts
259  * @msi_free:		Domain specific function to free a MSI interrupts
260  * @msi_check:		Callback for verification of the domain/info/dev data
261  * @msi_prepare:	Prepare the allocation of the interrupts in the domain
296 	int		(*msi_init)(struct irq_domain *domain,
300 	void		(*msi_free)(struct irq_domain *domain,
303 	int		(*msi_check)(struct irq_domain *domain,
306 	int		(*msi_prepare)(struct irq_domain *domain,
312 	int		(*handle_error)(struct irq_domain *domain,
314 	int		(*domain_alloc_irqs)(struct irq_domain *domain,
316 	void		(*domain_free_irqs)(struct irq_domain *domain,
321  * struct msi_domain_info - MSI interrupt domain data
329  * @data:		Optional: domain specific data
345 	 * Init non implemented ops callbacks with default MSI domain
354 	/* Support multiple PCI MSI interrupts */
356 	/* Support PCI MSIX interrupts */
358 	/* Needs early activate, required for PCI */
365 	/* Is level-triggered capable, using two messages */
375 int __msi_domain_alloc_irqs(struct irq_domain *domain, struct device *dev,
377 int msi_domain_alloc_irqs(struct irq_domain *domain, struct device *dev,
379 void __msi_domain_free_irqs(struct irq_domain *domain, struct device *dev);
380 void msi_domain_free_irqs(struct irq_domain *domain, struct device *dev);
381 struct msi_domain_info *msi_get_domain_info(struct irq_domain *domain);
390 /* When an MSI domain is used as an intermediate domain */
391 int msi_domain_prepare_irqs(struct irq_domain *domain, struct device *dev,
393 int msi_domain_populate_irqs(struct irq_domain *domain, struct device *dev,
408 int platform_msi_domain_alloc(struct irq_domain *domain, unsigned int virq,
410 void platform_msi_domain_free(struct irq_domain *domain, unsigned int virq,
412 void *platform_msi_get_host_data(struct irq_domain *domain);
420 int pci_msi_domain_check_cap(struct irq_domain *domain,
422 u32 pci_msi_domain_get_msi_rid(struct irq_domain *domain, struct pci_dev *pdev);