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 15*f2fa0e5eSJuergen Gross struct xenbus_device; 16*f2fa0e5eSJuergen Gross 170dc0064aSDavid Vrabel unsigned xen_evtchn_nr_channels(void); 180dc0064aSDavid Vrabel 190102e4efSYan Yankovskyi int bind_evtchn_to_irq(evtchn_port_t evtchn); 200102e4efSYan Yankovskyi int bind_evtchn_to_irqhandler(evtchn_port_t evtchn, 21f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 22e46cdb66SJeremy Fitzhardinge unsigned long irqflags, const char *devname, 23e46cdb66SJeremy Fitzhardinge void *dev_id); 2454c9de89SJuergen Gross int bind_evtchn_to_irqhandler_lateeoi(evtchn_port_t evtchn, 2554c9de89SJuergen Gross irq_handler_t handler, 2654c9de89SJuergen Gross unsigned long irqflags, const char *devname, 2754c9de89SJuergen Gross void *dev_id); 2877bb3dfdSDavid Vrabel int bind_virq_to_irq(unsigned int virq, unsigned int cpu, bool percpu); 29e46cdb66SJeremy Fitzhardinge int bind_virq_to_irqhandler(unsigned int virq, unsigned int cpu, 30f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 31f87e4cacSJeremy Fitzhardinge unsigned long irqflags, const char *devname, 32f87e4cacSJeremy Fitzhardinge void *dev_id); 33f87e4cacSJeremy Fitzhardinge int bind_ipi_to_irqhandler(enum ipi_vector ipi, 34f87e4cacSJeremy Fitzhardinge unsigned int cpu, 35f87e4cacSJeremy Fitzhardinge irq_handler_t handler, 36f87e4cacSJeremy Fitzhardinge unsigned long irqflags, 37f87e4cacSJeremy Fitzhardinge const char *devname, 38f87e4cacSJeremy Fitzhardinge void *dev_id); 39*f2fa0e5eSJuergen Gross int bind_interdomain_evtchn_to_irq_lateeoi(struct xenbus_device *dev, 4054c9de89SJuergen Gross evtchn_port_t remote_port); 41*f2fa0e5eSJuergen Gross int bind_interdomain_evtchn_to_irqhandler_lateeoi(struct xenbus_device *dev, 4254c9de89SJuergen Gross evtchn_port_t remote_port, 4354c9de89SJuergen Gross irq_handler_t handler, 4454c9de89SJuergen Gross unsigned long irqflags, 4554c9de89SJuergen Gross const char *devname, 4654c9de89SJuergen Gross void *dev_id); 47e46cdb66SJeremy Fitzhardinge 48e46cdb66SJeremy Fitzhardinge /* 49e46cdb66SJeremy Fitzhardinge * Common unbind function for all event sources. Takes IRQ to unbind from. 50e46cdb66SJeremy Fitzhardinge * Automatically closes the underlying event channel (even for bindings 51e46cdb66SJeremy Fitzhardinge * made with bind_evtchn_to_irqhandler()). 52e46cdb66SJeremy Fitzhardinge */ 53e46cdb66SJeremy Fitzhardinge void unbind_from_irqhandler(unsigned int irq, void *dev_id); 54e46cdb66SJeremy Fitzhardinge 5554c9de89SJuergen Gross /* 5654c9de89SJuergen Gross * Send late EOI for an IRQ bound to an event channel via one of the *_lateeoi 5754c9de89SJuergen Gross * functions above. 5854c9de89SJuergen Gross */ 5954c9de89SJuergen Gross void xen_irq_lateeoi(unsigned int irq, unsigned int eoi_flags); 6054c9de89SJuergen Gross /* Signal an event was spurious, i.e. there was no action resulting from it. */ 6154c9de89SJuergen Gross #define XEN_EOI_FLAG_SPURIOUS 0x00000001 6254c9de89SJuergen Gross 636ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_MAX EVTCHN_FIFO_PRIORITY_MAX 646ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_DEFAULT EVTCHN_FIFO_PRIORITY_DEFAULT 656ccecb0fSDavid Vrabel #define XEN_IRQ_PRIORITY_MIN EVTCHN_FIFO_PRIORITY_MIN 666ccecb0fSDavid Vrabel int xen_set_irq_priority(unsigned irq, unsigned priority); 676ccecb0fSDavid Vrabel 68420eb554SDaniel De Graaf /* 69420eb554SDaniel De Graaf * Allow extra references to event channels exposed to userspace by evtchn 70420eb554SDaniel De Graaf */ 710102e4efSYan Yankovskyi int evtchn_make_refcounted(evtchn_port_t evtchn); 720102e4efSYan Yankovskyi int evtchn_get(evtchn_port_t evtchn); 730102e4efSYan Yankovskyi void evtchn_put(evtchn_port_t evtchn); 74420eb554SDaniel De Graaf 75f87e4cacSJeremy Fitzhardinge void xen_send_IPI_one(unsigned int cpu, enum ipi_vector vector); 760102e4efSYan Yankovskyi void rebind_evtchn_irq(evtchn_port_t evtchn, int irq); 77bce5963bSJuergen Gross int xen_set_affinity_evtchn(struct irq_desc *desc, unsigned int tcpu); 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); 10838e20b07SSheng Yang void xen_evtchn_do_upcall(struct pt_regs *regs); 10938e20b07SSheng Yang void xen_hvm_evtchn_do_upcall(void); 11038e20b07SSheng Yang 111f4d0635bSIan Campbell /* Bind a pirq for a physical interrupt to an irq. */ 112f4d0635bSIan Campbell int xen_bind_pirq_gsi_to_irq(unsigned gsi, 113f4d0635bSIan Campbell unsigned pirq, int shareable, char *name); 114f731e3efSQing He 115f731e3efSQing He #ifdef CONFIG_PCI_MSI 116f4d0635bSIan Campbell /* Allocate a pirq for a MSI style physical interrupt. */ 117bf480d95SIan Campbell int xen_allocate_pirq_msi(struct pci_dev *dev, struct msi_desc *msidesc); 118f4d0635bSIan Campbell /* Bind an PSI pirq to an irq. */ 119bf480d95SIan Campbell int xen_bind_pirq_msi_to_irq(struct pci_dev *dev, struct msi_desc *msidesc, 1204892c9b4SRoger Pau Monne int pirq, int nvec, const char *name, domid_t domid); 121f731e3efSQing He #endif 122d46a78b0SJeremy Fitzhardinge 123b5401a96SAlex Nixon /* De-allocates the above mentioned physical interrupt. */ 124b5401a96SAlex Nixon int xen_destroy_irq(int irq); 125b5401a96SAlex Nixon 126af42b8d1SStefano Stabellini /* Return irq from pirq */ 127af42b8d1SStefano Stabellini int xen_irq_from_pirq(unsigned pirq); 128af42b8d1SStefano Stabellini 129e6197accSKonrad Rzeszutek Wilk /* Return the pirq allocated to the irq. */ 130e6197accSKonrad Rzeszutek Wilk int xen_pirq_from_irq(unsigned irq); 131e6197accSKonrad Rzeszutek Wilk 13268c2c39aSStefano Stabellini /* Return the irq allocated to the gsi */ 13368c2c39aSStefano Stabellini int xen_irq_from_gsi(unsigned gsi); 13468c2c39aSStefano Stabellini 135c7c2c3a2SKonrad Rzeszutek Wilk /* Determine whether to ignore this IRQ if it is passed to a guest. */ 136c7c2c3a2SKonrad Rzeszutek Wilk int xen_test_irq_shared(int irq); 137c7c2c3a2SKonrad Rzeszutek Wilk 1380ec53ecfSStefano Stabellini /* initialize Xen IRQ subsystem */ 1390ec53ecfSStefano Stabellini void xen_init_IRQ(void); 140e46cdb66SJeremy Fitzhardinge #endif /* _XEN_EVENTS_H */ 141