1b2441318SGreg Kroah-Hartman /* SPDX-License-Identifier: GPL-2.0 */ 2e46cdb66SJeremy Fitzhardinge #ifndef _XEN_EVENTS_H 3e46cdb66SJeremy Fitzhardinge #define _XEN_EVENTS_H 4e46cdb66SJeremy Fitzhardinge 5f87e4cacSJeremy Fitzhardinge #include <linux/interrupt.h> 6bce5963bSJuergen Gross #include <linux/irq.h> 74892c9b4SRoger Pau Monne #ifdef CONFIG_PCI_MSI 84892c9b4SRoger Pau Monne #include <linux/msi.h> 94892c9b4SRoger Pau Monne #endif 10f87e4cacSJeremy Fitzhardinge 11f87e4cacSJeremy Fitzhardinge #include <xen/interface/event_channel.h> 12f87e4cacSJeremy Fitzhardinge #include <asm/xen/hypercall.h> 13e849c3e9SIsaku Yamahata #include <asm/xen/events.h> 14e46cdb66SJeremy Fitzhardinge 150dc0064aSDavid Vrabel unsigned xen_evtchn_nr_channels(void); 160dc0064aSDavid Vrabel 170102e4efSYan Yankovskyi int bind_evtchn_to_irq(evtchn_port_t evtchn); 1854c9de89SJuergen Gross int bind_evtchn_to_irq_lateeoi(evtchn_port_t evtchn); 190102e4efSYan Yankovskyi int bind_evtchn_to_irqhandler(evtchn_port_t evtchn, 20f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 21e46cdb66SJeremy Fitzhardinge unsigned long irqflags, const char *devname, 22e46cdb66SJeremy Fitzhardinge void *dev_id); 2354c9de89SJuergen Gross int bind_evtchn_to_irqhandler_lateeoi(evtchn_port_t evtchn, 2454c9de89SJuergen Gross irq_handler_t handler, 2554c9de89SJuergen Gross unsigned long irqflags, const char *devname, 2654c9de89SJuergen Gross void *dev_id); 2777bb3dfdSDavid Vrabel int bind_virq_to_irq(unsigned int virq, unsigned int cpu, bool percpu); 28e46cdb66SJeremy Fitzhardinge int bind_virq_to_irqhandler(unsigned int virq, unsigned int cpu, 29f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 30f87e4cacSJeremy Fitzhardinge unsigned long irqflags, const char *devname, 31f87e4cacSJeremy Fitzhardinge void *dev_id); 32f87e4cacSJeremy Fitzhardinge int bind_ipi_to_irqhandler(enum ipi_vector ipi, 33f87e4cacSJeremy Fitzhardinge unsigned int cpu, 34f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 35f87e4cacSJeremy Fitzhardinge unsigned long irqflags, 36f87e4cacSJeremy Fitzhardinge const char *devname, 37f87e4cacSJeremy Fitzhardinge void *dev_id); 38854072ddSJuergen Gross int bind_interdomain_evtchn_to_irq(unsigned int remote_domain, 390102e4efSYan Yankovskyi evtchn_port_t remote_port); 4054c9de89SJuergen Gross int bind_interdomain_evtchn_to_irq_lateeoi(unsigned int remote_domain, 4154c9de89SJuergen Gross evtchn_port_t remote_port); 422e820f58SIan Campbell int bind_interdomain_evtchn_to_irqhandler(unsigned int remote_domain, 430102e4efSYan Yankovskyi evtchn_port_t remote_port, 442e820f58SIan Campbell irq_handler_t handler, 452e820f58SIan Campbell unsigned long irqflags, 462e820f58SIan Campbell const char *devname, 472e820f58SIan Campbell void *dev_id); 4854c9de89SJuergen Gross int bind_interdomain_evtchn_to_irqhandler_lateeoi(unsigned int remote_domain, 4954c9de89SJuergen Gross evtchn_port_t remote_port, 5054c9de89SJuergen Gross irq_handler_t handler, 5154c9de89SJuergen Gross unsigned long irqflags, 5254c9de89SJuergen Gross const char *devname, 5354c9de89SJuergen Gross void *dev_id); 54e46cdb66SJeremy Fitzhardinge 55e46cdb66SJeremy Fitzhardinge /* 56e46cdb66SJeremy Fitzhardinge * Common unbind function for all event sources. Takes IRQ to unbind from. 57e46cdb66SJeremy Fitzhardinge * Automatically closes the underlying event channel (even for bindings 58e46cdb66SJeremy Fitzhardinge * made with bind_evtchn_to_irqhandler()). 59e46cdb66SJeremy Fitzhardinge */ 60e46cdb66SJeremy Fitzhardinge void unbind_from_irqhandler(unsigned int irq, void *dev_id); 61e46cdb66SJeremy Fitzhardinge 6254c9de89SJuergen Gross /* 6354c9de89SJuergen Gross * Send late EOI for an IRQ bound to an event channel via one of the *_lateeoi 6454c9de89SJuergen Gross * functions above. 6554c9de89SJuergen Gross */ 6654c9de89SJuergen Gross void xen_irq_lateeoi(unsigned int irq, unsigned int eoi_flags); 6754c9de89SJuergen Gross /* Signal an event was spurious, i.e. there was no action resulting from it. */ 6854c9de89SJuergen Gross #define XEN_EOI_FLAG_SPURIOUS 0x00000001 6954c9de89SJuergen Gross 706ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_MAX EVTCHN_FIFO_PRIORITY_MAX 716ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_DEFAULT EVTCHN_FIFO_PRIORITY_DEFAULT 726ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_MIN EVTCHN_FIFO_PRIORITY_MIN 736ccecb0fSDavid Vrabel int xen_set_irq_priority(unsigned irq, unsigned priority); 746ccecb0fSDavid Vrabel 75420eb554SDaniel De Graaf /* 76420eb554SDaniel De Graaf * Allow extra references to event channels exposed to userspace by evtchn 77420eb554SDaniel De Graaf */ 780102e4efSYan Yankovskyi int evtchn_make_refcounted(evtchn_port_t evtchn); 790102e4efSYan Yankovskyi int evtchn_get(evtchn_port_t evtchn); 800102e4efSYan Yankovskyi void evtchn_put(evtchn_port_t evtchn); 81420eb554SDaniel De Graaf 82f87e4cacSJeremy Fitzhardinge void xen_send_IPI_one(unsigned int cpu, enum ipi_vector vector); 830102e4efSYan Yankovskyi void rebind_evtchn_irq(evtchn_port_t evtchn, int irq); 84bce5963bSJuergen Gross int xen_set_affinity_evtchn(struct irq_desc *desc, unsigned int tcpu); 85f87e4cacSJeremy Fitzhardinge 860102e4efSYan Yankovskyi static inline void notify_remote_via_evtchn(evtchn_port_t port) 87e46cdb66SJeremy Fitzhardinge { 88e46cdb66SJeremy Fitzhardinge struct evtchn_send send = { .port = port }; 89e46cdb66SJeremy Fitzhardinge (void)HYPERVISOR_event_channel_op(EVTCHNOP_send, &send); 90e46cdb66SJeremy Fitzhardinge } 91e46cdb66SJeremy Fitzhardinge 9276465b2dSIan Campbell void notify_remote_via_irq(int irq); 930e91398fSJeremy Fitzhardinge 9476465b2dSIan Campbell void xen_irq_resume(void); 950e91398fSJeremy Fitzhardinge 962d9e1e2fSJeremy Fitzhardinge /* Clear an irq's pending state, in preparation for polling on it */ 972d9e1e2fSJeremy Fitzhardinge void xen_clear_irq_pending(int irq); 98168d2f46SJeremy Fitzhardinge void xen_set_irq_pending(int irq); 99168d2f46SJeremy Fitzhardinge bool xen_test_irq_pending(int irq); 1002d9e1e2fSJeremy Fitzhardinge 1012d9e1e2fSJeremy Fitzhardinge /* Poll waiting for an irq to become pending. In the usual case, the 1022d9e1e2fSJeremy Fitzhardinge irq will be disabled so it won't deliver an interrupt. */ 1032d9e1e2fSJeremy Fitzhardinge void xen_poll_irq(int irq); 1042d9e1e2fSJeremy Fitzhardinge 105d9a8814fSKonrad Rzeszutek Wilk /* Poll waiting for an irq to become pending with a timeout. In the usual case, 106d9a8814fSKonrad Rzeszutek Wilk * the irq will be disabled so it won't deliver an interrupt. */ 107d9a8814fSKonrad Rzeszutek Wilk void xen_poll_irq_timeout(int irq, u64 timeout); 108d9a8814fSKonrad Rzeszutek Wilk 109d4c04536SIan Campbell /* Determine the IRQ which is bound to an event channel */ 1100102e4efSYan Yankovskyi unsigned int irq_from_evtchn(evtchn_port_t evtchn); 1119a489f45SDavid Vrabel int irq_from_virq(unsigned int cpu, unsigned int virq); 1120102e4efSYan Yankovskyi evtchn_port_t evtchn_from_irq(unsigned irq); 113d4c04536SIan Campbell 11438e20b07SSheng Yang int xen_set_callback_via(uint64_t via); 11538e20b07SSheng Yang void xen_evtchn_do_upcall(struct pt_regs *regs); 11638e20b07SSheng Yang void xen_hvm_evtchn_do_upcall(void); 11738e20b07SSheng Yang 118f4d0635bSIan Campbell /* Bind a pirq for a physical interrupt to an irq. */ 119f4d0635bSIan Campbell int xen_bind_pirq_gsi_to_irq(unsigned gsi, 120f4d0635bSIan Campbell unsigned pirq, int shareable, char *name); 121f731e3efSQing He 122f731e3efSQing He #ifdef CONFIG_PCI_MSI 123f4d0635bSIan Campbell /* Allocate a pirq for a MSI style physical interrupt. */ 124bf480d95SIan Campbell int xen_allocate_pirq_msi(struct pci_dev *dev, struct msi_desc *msidesc); 125f4d0635bSIan Campbell /* Bind an PSI pirq to an irq. */ 126bf480d95SIan Campbell int xen_bind_pirq_msi_to_irq(struct pci_dev *dev, struct msi_desc *msidesc, 1274892c9b4SRoger Pau Monne int pirq, int nvec, const char *name, domid_t domid); 128f731e3efSQing He #endif 129d46a78b0SJeremy Fitzhardinge 130b5401a96SAlex Nixon /* De-allocates the above mentioned physical interrupt. */ 131b5401a96SAlex Nixon int xen_destroy_irq(int irq); 132b5401a96SAlex Nixon 133af42b8d1SStefano Stabellini /* Return irq from pirq */ 134af42b8d1SStefano Stabellini int xen_irq_from_pirq(unsigned pirq); 135af42b8d1SStefano Stabellini 136e6197accSKonrad Rzeszutek Wilk /* Return the pirq allocated to the irq. */ 137e6197accSKonrad Rzeszutek Wilk int xen_pirq_from_irq(unsigned irq); 138e6197accSKonrad Rzeszutek Wilk 13968c2c39aSStefano Stabellini /* Return the irq allocated to the gsi */ 14068c2c39aSStefano Stabellini int xen_irq_from_gsi(unsigned gsi); 14168c2c39aSStefano Stabellini 142c7c2c3a2SKonrad Rzeszutek Wilk /* Determine whether to ignore this IRQ if it is passed to a guest. */ 143c7c2c3a2SKonrad Rzeszutek Wilk int xen_test_irq_shared(int irq); 144c7c2c3a2SKonrad Rzeszutek Wilk 1450ec53ecfSStefano Stabellini /* initialize Xen IRQ subsystem */ 1460ec53ecfSStefano Stabellini void xen_init_IRQ(void); 147e46cdb66SJeremy Fitzhardinge #endif /* _XEN_EVENTS_H */ 148