14  * Interrupt controller "domain" data structure. This could be defined as a
15  * irq domain controller. That is, it handles the mapping between hardware
16  * and virtual interrupt numbers for a given interrupt domain. The domain
18  * (though a domain can cover more than one PIC if they have a flat number
19  * model). It's the domain callbacks that are responsible for setting the
23  * identify the domain. In some cases, and in order to preserve source
75  * @match: Match an interrupt controller device node to a domain, returns
135  * @name:	Name of interrupt domain
141  * @mutex:	Domain lock, hierarchical domains use root domain's lock
142  * @root:	Pointer to root domain, or containing structure if non-hierarchical
157  *		purposes related to the irq domain.
159  * @msi_parent_ops: Pointer to MSI parent domain methods for per device domain init
160  * @exit:	Function called when the domain is destroyed
162  * Revmap data, used internally by the irq domain code:
200 /* Irq domain flags */
202 	/* Irq domain is hierarchical */
205 	/* Irq domain name was allocated internally */
208 	/* Irq domain is an IPI domain with virq per cpu */
211 	/* Irq domain is an IPI domain with single virq */
214 	/* Irq domain implements MSIs */
218 	 * Irq domain implements isolated MSI, see msi_device_has_isolated_msi()
222 	/* Irq domain doesn't translate anything */
225 	/* Irq domain is a MSI parent domain */
228 	/* Irq domain is a MSI device domain */
231 	/* Irq domain must destroy generic chips when removed */
287  * struct irq_domain_info - Domain information structure
289  * @domain_flags:	Additional flags to add to the domain flags
296  *			immediately associate the interrupts after domain creation
297  * @bus_token:		Domain bus token
300  * @ops:		Domain operation callbacks
303  *			create generic chips for the domain if not NULL.
304  * @init:		Function called when the domain is created.
305  *			Allow to do some additional domain initialisation.
306  * @exit:		Function called when the domain is destroyed.
323 	 * @parent: Pointer to the parent irq domain used in a hierarchy domain
355 void irq_set_default_domain(struct irq_domain *domain);
373 void irq_domain_update_bus_token(struct irq_domain *domain,
416  * @size: Number of interrupts in the domain.
417  * @ops: map/unmap domain callbacks
457 unsigned int irq_create_direct_mapping(struct irq_domain *domain);
510 void irq_domain_remove(struct irq_domain *domain);
512 int irq_domain_associate(struct irq_domain *domain, unsigned int irq,
514 void irq_domain_associate_many(struct irq_domain *domain,
518 unsigned int irq_create_mapping_affinity(struct irq_domain *domain,
524 static inline unsigned int irq_create_mapping(struct irq_domain *domain,  in irq_create_mapping()  argument
527 	return irq_create_mapping_affinity(domain, hwirq, NULL);  in irq_create_mapping()
530 struct irq_desc *__irq_resolve_mapping(struct irq_domain *domain,
534 static inline struct irq_desc *irq_resolve_mapping(struct irq_domain *domain,  in irq_resolve_mapping()  argument
537 	return __irq_resolve_mapping(domain, hwirq, NULL);  in irq_resolve_mapping()
542  * @domain: domain owning this hardware interrupt
543  * @hwirq: hardware irq number in that domain space
545 static inline unsigned int irq_find_mapping(struct irq_domain *domain,  in irq_find_mapping()  argument
550 	if (__irq_resolve_mapping(domain, hwirq, &irq))  in irq_find_mapping()
556 static inline unsigned int irq_linear_revmap(struct irq_domain *domain,  in irq_linear_revmap()  argument
559 	return irq_find_mapping(domain, hwirq);  in irq_linear_revmap()
586 int irq_reserve_ipi(struct irq_domain *domain, const struct cpumask *dest);
590 struct irq_data *irq_domain_get_irq_data(struct irq_domain *domain,
592 void irq_domain_set_info(struct irq_domain *domain, unsigned int virq,
618 int __irq_domain_alloc_irqs(struct irq_domain *domain, int irq_base,
626 static inline int irq_domain_alloc_irqs(struct irq_domain *domain,  in irq_domain_alloc_irqs()  argument
629 	return __irq_domain_alloc_irqs(domain, -1, nr_irqs, node, arg, false,  in irq_domain_alloc_irqs()
633 int irq_domain_set_hwirq_and_chip(struct irq_domain *domain,
638 void irq_domain_free_irqs_common(struct irq_domain *domain,
641 void irq_domain_free_irqs_top(struct irq_domain *domain,
644 int irq_domain_push_irq(struct irq_domain *domain, int virq, void *arg);
645 int irq_domain_pop_irq(struct irq_domain *domain, int virq);
647 int irq_domain_alloc_irqs_parent(struct irq_domain *domain,
651 void irq_domain_free_irqs_parent(struct irq_domain *domain,
655 int irq_domain_disconnect_hierarchy(struct irq_domain *domain,
658 static inline bool irq_domain_is_hierarchy(struct irq_domain *domain)  in irq_domain_is_hierarchy()  argument
660 	return domain->flags & IRQ_DOMAIN_FLAG_HIERARCHY;  in irq_domain_is_hierarchy()
663 static inline bool irq_domain_is_ipi(struct irq_domain *domain)  in irq_domain_is_ipi()  argument
665 	return domain->flags &  in irq_domain_is_ipi()
669 static inline bool irq_domain_is_ipi_per_cpu(struct irq_domain *domain)  in irq_domain_is_ipi_per_cpu()  argument
671 	return domain->flags & IRQ_DOMAIN_FLAG_IPI_PER_CPU;  in irq_domain_is_ipi_per_cpu()
674 static inline bool irq_domain_is_ipi_single(struct irq_domain *domain)  in irq_domain_is_ipi_single()  argument
676 	return domain->flags & IRQ_DOMAIN_FLAG_IPI_SINGLE;  in irq_domain_is_ipi_single()
679 static inline bool irq_domain_is_msi(struct irq_domain *domain)  in irq_domain_is_msi()  argument
681 	return domain->flags & IRQ_DOMAIN_FLAG_MSI;  in irq_domain_is_msi()
684 static inline bool irq_domain_is_msi_parent(struct irq_domain *domain)  in irq_domain_is_msi_parent()  argument
686 	return domain->flags & IRQ_DOMAIN_FLAG_MSI_PARENT;  in irq_domain_is_msi_parent()
689 static inline bool irq_domain_is_msi_device(struct irq_domain *domain)  in irq_domain_is_msi_device()  argument
691 	return domain->flags & IRQ_DOMAIN_FLAG_MSI_DEVICE;  in irq_domain_is_msi_device()
695 static inline int irq_domain_alloc_irqs(struct irq_domain *domain,  in irq_domain_alloc_irqs()  argument
704 static inline bool irq_domain_is_hierarchy(struct irq_domain *domain)  in irq_domain_is_hierarchy()  argument
709 static inline bool irq_domain_is_ipi(struct irq_domain *domain)  in irq_domain_is_ipi()  argument
714 static inline bool irq_domain_is_ipi_per_cpu(struct irq_domain *domain)  in irq_domain_is_ipi_per_cpu()  argument
719 static inline bool irq_domain_is_ipi_single(struct irq_domain *domain)  in irq_domain_is_ipi_single()  argument
724 static inline bool irq_domain_is_msi(struct irq_domain *domain)  in irq_domain_is_msi()  argument
729 static inline bool irq_domain_is_msi_parent(struct irq_domain *domain)  in irq_domain_is_msi_parent()  argument
734 static inline bool irq_domain_is_msi_device(struct irq_domain *domain)  in irq_domain_is_msi_device()  argument
742 int msi_device_domain_alloc_wired(struct irq_domain *domain, unsigned int hwirq,
744 void msi_device_domain_free_wired(struct irq_domain *domain, unsigned int virq);
746 static inline int msi_device_domain_alloc_wired(struct irq_domain *domain, unsigned int hwirq,  in msi_device_domain_alloc_wired()  argument
752 static inline void msi_device_domain_free_wired(struct irq_domain *domain, unsigned int virq)  in msi_device_domain_free_wired()  argument