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 15f2fa0e5eSJuergen Gross struct xenbus_device; 16f2fa0e5eSJuergen Gross 170dc0064aSDavid Vrabel unsigned xen_evtchn_nr_channels(void); 180dc0064aSDavid Vrabel 190102e4efSYan Yankovskyi int bind_evtchn_to_irq(evtchn_port_t evtchn); 20fe415186SJuergen Gross int bind_evtchn_to_irq_lateeoi(evtchn_port_t evtchn); 210102e4efSYan Yankovskyi int bind_evtchn_to_irqhandler(evtchn_port_t evtchn, 22f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 23e46cdb66SJeremy Fitzhardinge unsigned long irqflags, const char *devname, 24e46cdb66SJeremy Fitzhardinge void *dev_id); 2554c9de89SJuergen Gross int bind_evtchn_to_irqhandler_lateeoi(evtchn_port_t evtchn, 2654c9de89SJuergen Gross irq_handler_t handler, 2754c9de89SJuergen Gross unsigned long irqflags, const char *devname, 2854c9de89SJuergen Gross void *dev_id); 2977bb3dfdSDavid Vrabel int bind_virq_to_irq(unsigned int virq, unsigned int cpu, bool percpu); 30e46cdb66SJeremy Fitzhardinge int bind_virq_to_irqhandler(unsigned int virq, unsigned int cpu, 31f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 32f87e4cacSJeremy Fitzhardinge unsigned long irqflags, const char *devname, 33f87e4cacSJeremy Fitzhardinge void *dev_id); 34f87e4cacSJeremy Fitzhardinge int bind_ipi_to_irqhandler(enum ipi_vector ipi, 35f87e4cacSJeremy Fitzhardinge unsigned int cpu, 36f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 37f87e4cacSJeremy Fitzhardinge unsigned long irqflags, 38f87e4cacSJeremy Fitzhardinge const char *devname, 39f87e4cacSJeremy Fitzhardinge void *dev_id); 40f2fa0e5eSJuergen Gross int bind_interdomain_evtchn_to_irq_lateeoi(struct xenbus_device *dev, 4154c9de89SJuergen Gross evtchn_port_t remote_port); 42f2fa0e5eSJuergen Gross int bind_interdomain_evtchn_to_irqhandler_lateeoi(struct xenbus_device *dev, 4354c9de89SJuergen Gross evtchn_port_t remote_port, 4454c9de89SJuergen Gross irq_handler_t handler, 4554c9de89SJuergen Gross unsigned long irqflags, 4654c9de89SJuergen Gross const char *devname, 4754c9de89SJuergen Gross void *dev_id); 48e46cdb66SJeremy Fitzhardinge 49e46cdb66SJeremy Fitzhardinge /* 50e46cdb66SJeremy Fitzhardinge * Common unbind function for all event sources. Takes IRQ to unbind from. 51e46cdb66SJeremy Fitzhardinge * Automatically closes the underlying event channel (even for bindings 52e46cdb66SJeremy Fitzhardinge * made with bind_evtchn_to_irqhandler()). 53e46cdb66SJeremy Fitzhardinge */ 54e46cdb66SJeremy Fitzhardinge void unbind_from_irqhandler(unsigned int irq, void *dev_id); 55e46cdb66SJeremy Fitzhardinge 5654c9de89SJuergen Gross /* 5754c9de89SJuergen Gross * Send late EOI for an IRQ bound to an event channel via one of the *_lateeoi 5854c9de89SJuergen Gross * functions above. 5954c9de89SJuergen Gross */ 6054c9de89SJuergen Gross void xen_irq_lateeoi(unsigned int irq, unsigned int eoi_flags); 6154c9de89SJuergen Gross /* Signal an event was spurious, i.e. there was no action resulting from it. */ 6254c9de89SJuergen Gross #define XEN_EOI_FLAG_SPURIOUS 0x00000001 6354c9de89SJuergen Gross 646ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_MAX EVTCHN_FIFO_PRIORITY_MAX 656ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_DEFAULT EVTCHN_FIFO_PRIORITY_DEFAULT 666ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_MIN EVTCHN_FIFO_PRIORITY_MIN 676ccecb0fSDavid Vrabel int xen_set_irq_priority(unsigned irq, unsigned priority); 686ccecb0fSDavid Vrabel 69420eb554SDaniel De Graaf /* 70420eb554SDaniel De Graaf * Allow extra references to event channels exposed to userspace by evtchn 71420eb554SDaniel De Graaf */ 7258f6259bSRahul Singh int evtchn_make_refcounted(evtchn_port_t evtchn, bool is_static); 730102e4efSYan Yankovskyi int evtchn_get(evtchn_port_t evtchn); 740102e4efSYan Yankovskyi void evtchn_put(evtchn_port_t evtchn); 75420eb554SDaniel De Graaf 76f87e4cacSJeremy Fitzhardinge void xen_send_IPI_one(unsigned int cpu, enum ipi_vector vector); 770102e4efSYan Yankovskyi void rebind_evtchn_irq(evtchn_port_t evtchn, int irq); 78f87e4cacSJeremy Fitzhardinge 790102e4efSYan Yankovskyi static inline void notify_remote_via_evtchn(evtchn_port_t port) 80e46cdb66SJeremy Fitzhardinge { 81e46cdb66SJeremy Fitzhardinge struct evtchn_send send = { .port = port }; 82e46cdb66SJeremy Fitzhardinge (void)HYPERVISOR_event_channel_op(EVTCHNOP_send, &send); 83e46cdb66SJeremy Fitzhardinge } 84e46cdb66SJeremy Fitzhardinge 8576465b2dSIan Campbell void notify_remote_via_irq(int irq); 860e91398fSJeremy Fitzhardinge 8776465b2dSIan Campbell void xen_irq_resume(void); 880e91398fSJeremy Fitzhardinge 892d9e1e2fSJeremy Fitzhardinge /* Clear an irq's pending state, in preparation for polling on it */ 902d9e1e2fSJeremy Fitzhardinge void xen_clear_irq_pending(int irq); 91168d2f46SJeremy Fitzhardinge void xen_set_irq_pending(int irq); 92168d2f46SJeremy Fitzhardinge bool xen_test_irq_pending(int irq); 932d9e1e2fSJeremy Fitzhardinge 942d9e1e2fSJeremy Fitzhardinge /* Poll waiting for an irq to become pending. In the usual case, the 952d9e1e2fSJeremy Fitzhardinge irq will be disabled so it won't deliver an interrupt. */ 962d9e1e2fSJeremy Fitzhardinge void xen_poll_irq(int irq); 972d9e1e2fSJeremy Fitzhardinge 98d9a8814fSKonrad Rzeszutek Wilk /* Poll waiting for an irq to become pending with a timeout. In the usual case, 99d9a8814fSKonrad Rzeszutek Wilk * the irq will be disabled so it won't deliver an interrupt. */ 100d9a8814fSKonrad Rzeszutek Wilk void xen_poll_irq_timeout(int irq, u64 timeout); 101d9a8814fSKonrad Rzeszutek Wilk 102d4c04536SIan Campbell /* Determine the IRQ which is bound to an event channel */ 1030102e4efSYan Yankovskyi unsigned int irq_from_evtchn(evtchn_port_t evtchn); 1049a489f45SDavid Vrabel int irq_from_virq(unsigned int cpu, unsigned int virq); 1050102e4efSYan Yankovskyi evtchn_port_t evtchn_from_irq(unsigned irq); 106d4c04536SIan Campbell 10738e20b07SSheng Yang int xen_set_callback_via(uint64_t via); 108*37510dd5SJuergen Gross int xen_evtchn_do_upcall(void); 10938e20b07SSheng Yang 110f4d0635bSIan Campbell /* Bind a pirq for a physical interrupt to an irq. */ 111f4d0635bSIan Campbell int xen_bind_pirq_gsi_to_irq(unsigned gsi, 112f4d0635bSIan Campbell unsigned pirq, int shareable, char *name); 113f731e3efSQing He 114f731e3efSQing He #ifdef CONFIG_PCI_MSI 115f4d0635bSIan Campbell /* Allocate a pirq for a MSI style physical interrupt. */ 116bf480d95SIan Campbell int xen_allocate_pirq_msi(struct pci_dev *dev, struct msi_desc *msidesc); 117f4d0635bSIan Campbell /* Bind an PSI pirq to an irq. */ 118bf480d95SIan Campbell int xen_bind_pirq_msi_to_irq(struct pci_dev *dev, struct msi_desc *msidesc, 1194892c9b4SRoger Pau Monne int pirq, int nvec, const char *name, domid_t domid); 120f731e3efSQing He #endif 121d46a78b0SJeremy Fitzhardinge 122b5401a96SAlex Nixon /* De-allocates the above mentioned physical interrupt. */ 123b5401a96SAlex Nixon int xen_destroy_irq(int irq); 124b5401a96SAlex Nixon 125af42b8d1SStefano Stabellini /* Return irq from pirq */ 126af42b8d1SStefano Stabellini int xen_irq_from_pirq(unsigned pirq); 127af42b8d1SStefano Stabellini 128e6197accSKonrad Rzeszutek Wilk /* Return the pirq allocated to the irq. */ 129e6197accSKonrad Rzeszutek Wilk int xen_pirq_from_irq(unsigned irq); 130e6197accSKonrad Rzeszutek Wilk 13168c2c39aSStefano Stabellini /* Return the irq allocated to the gsi */ 13268c2c39aSStefano Stabellini int xen_irq_from_gsi(unsigned gsi); 13368c2c39aSStefano Stabellini 134c7c2c3a2SKonrad Rzeszutek Wilk /* Determine whether to ignore this IRQ if it is passed to a guest. */ 135c7c2c3a2SKonrad Rzeszutek Wilk int xen_test_irq_shared(int irq); 136c7c2c3a2SKonrad Rzeszutek Wilk 1370ec53ecfSStefano Stabellini /* initialize Xen IRQ subsystem */ 1380ec53ecfSStefano Stabellini void xen_init_IRQ(void); 13904d68487SArnd Bergmann 14004d68487SArnd Bergmann irqreturn_t xen_debug_interrupt(int irq, void *dev_id); 14104d68487SArnd Bergmann 14258f6259bSRahul Singh static inline void xen_evtchn_close(evtchn_port_t port) 14358f6259bSRahul Singh { 14458f6259bSRahul Singh struct evtchn_close close; 14558f6259bSRahul Singh 14658f6259bSRahul Singh close.port = port; 14758f6259bSRahul Singh if (HYPERVISOR_event_channel_op(EVTCHNOP_close, &close) != 0) 14858f6259bSRahul Singh BUG(); 14958f6259bSRahul Singh } 15058f6259bSRahul Singh 151e46cdb66SJeremy Fitzhardinge #endif /* _XEN_EVENTS_H */ 152