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
notify_remote_via_evtchn(evtchn_port_t port)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);
104*b79345efSJuergen Gross int irq_evtchn_from_virq(unsigned int cpu, unsigned int virq,
105*b79345efSJuergen Gross evtchn_port_t *evtchn);
106d4c04536SIan Campbell
10738e20b07SSheng Yang int xen_set_callback_via(uint64_t via);
10837510dd5SJuergen 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
xen_evtchn_close(evtchn_port_t port)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