Linux Audio

Check our new training course

Linux kernel drivers training

May 6-19, 2025
Register
Loading...
v6.8
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef _XEN_EVENTS_H
  3#define _XEN_EVENTS_H
  4
  5#include <linux/interrupt.h>
  6#include <linux/irq.h>
  7#ifdef CONFIG_PCI_MSI
  8#include <linux/msi.h>
  9#endif
 10
 11#include <xen/interface/event_channel.h>
 12#include <asm/xen/hypercall.h>
 13#include <asm/xen/events.h>
 14
 15struct xenbus_device;
 16
 17unsigned xen_evtchn_nr_channels(void);
 18
 19int bind_evtchn_to_irq(evtchn_port_t evtchn);
 20int bind_evtchn_to_irq_lateeoi(evtchn_port_t evtchn);
 21int bind_evtchn_to_irqhandler(evtchn_port_t evtchn,
 22			      irq_handler_t handler,
 23			      unsigned long irqflags, const char *devname,
 24			      void *dev_id);
 25int bind_evtchn_to_irqhandler_lateeoi(evtchn_port_t evtchn,
 26			      irq_handler_t handler,
 27			      unsigned long irqflags, const char *devname,
 28			      void *dev_id);
 29int bind_virq_to_irq(unsigned int virq, unsigned int cpu, bool percpu);
 30int bind_virq_to_irqhandler(unsigned int virq, unsigned int cpu,
 31			    irq_handler_t handler,
 32			    unsigned long irqflags, const char *devname,
 33			    void *dev_id);
 34int bind_ipi_to_irqhandler(enum ipi_vector ipi,
 35			   unsigned int cpu,
 36			   irq_handler_t handler,
 37			   unsigned long irqflags,
 38			   const char *devname,
 39			   void *dev_id);
 40int bind_interdomain_evtchn_to_irq_lateeoi(struct xenbus_device *dev,
 41					   evtchn_port_t remote_port);
 42int bind_interdomain_evtchn_to_irqhandler_lateeoi(struct xenbus_device *dev,
 43						  evtchn_port_t remote_port,
 44						  irq_handler_t handler,
 45						  unsigned long irqflags,
 46						  const char *devname,
 47						  void *dev_id);
 48
 49/*
 50 * Common unbind function for all event sources. Takes IRQ to unbind from.
 51 * Automatically closes the underlying event channel (even for bindings
 52 * made with bind_evtchn_to_irqhandler()).
 53 */
 54void unbind_from_irqhandler(unsigned int irq, void *dev_id);
 55
 56/*
 57 * Send late EOI for an IRQ bound to an event channel via one of the *_lateeoi
 58 * functions above.
 59 */
 60void xen_irq_lateeoi(unsigned int irq, unsigned int eoi_flags);
 61/* Signal an event was spurious, i.e. there was no action resulting from it. */
 62#define XEN_EOI_FLAG_SPURIOUS	0x00000001
 63
 64#define XEN_IRQ_PRIORITY_MAX     EVTCHN_FIFO_PRIORITY_MAX
 65#define XEN_IRQ_PRIORITY_DEFAULT EVTCHN_FIFO_PRIORITY_DEFAULT
 66#define XEN_IRQ_PRIORITY_MIN     EVTCHN_FIFO_PRIORITY_MIN
 67int xen_set_irq_priority(unsigned irq, unsigned priority);
 68
 69/*
 70 * Allow extra references to event channels exposed to userspace by evtchn
 71 */
 72int evtchn_make_refcounted(evtchn_port_t evtchn, bool is_static);
 73int evtchn_get(evtchn_port_t evtchn);
 74void evtchn_put(evtchn_port_t evtchn);
 75
 76void xen_send_IPI_one(unsigned int cpu, enum ipi_vector vector);
 77void rebind_evtchn_irq(evtchn_port_t evtchn, int irq);
 
 78
 79static inline void notify_remote_via_evtchn(evtchn_port_t port)
 80{
 81	struct evtchn_send send = { .port = port };
 82	(void)HYPERVISOR_event_channel_op(EVTCHNOP_send, &send);
 83}
 84
 85void notify_remote_via_irq(int irq);
 86
 87void xen_irq_resume(void);
 88
 89/* Clear an irq's pending state, in preparation for polling on it */
 90void xen_clear_irq_pending(int irq);
 
 91bool xen_test_irq_pending(int irq);
 92
 93/* Poll waiting for an irq to become pending.  In the usual case, the
 94   irq will be disabled so it won't deliver an interrupt. */
 95void xen_poll_irq(int irq);
 96
 97/* Poll waiting for an irq to become pending with a timeout.  In the usual case,
 98 * the irq will be disabled so it won't deliver an interrupt. */
 99void xen_poll_irq_timeout(int irq, u64 timeout);
100
101/* Determine the IRQ which is bound to an event channel */
102unsigned int irq_from_evtchn(evtchn_port_t evtchn);
103int irq_evtchn_from_virq(unsigned int cpu, unsigned int virq,
104			 evtchn_port_t *evtchn);
105
 
 
 
 
 
106int xen_set_callback_via(uint64_t via);
107int xen_evtchn_do_upcall(void);
 
108
109/* Bind a pirq for a physical interrupt to an irq. */
110int xen_bind_pirq_gsi_to_irq(unsigned gsi,
111			     unsigned pirq, int shareable, char *name);
112
113#ifdef CONFIG_PCI_MSI
114/* Allocate a pirq for a MSI style physical interrupt. */
115int xen_allocate_pirq_msi(struct pci_dev *dev, struct msi_desc *msidesc);
116/* Bind an PSI pirq to an irq. */
117int xen_bind_pirq_msi_to_irq(struct pci_dev *dev, struct msi_desc *msidesc,
118			     int pirq, int nvec, const char *name, domid_t domid);
119#endif
120
121/* De-allocates the above mentioned physical interrupt. */
122int xen_destroy_irq(int irq);
123
 
 
 
124/* Return the pirq allocated to the irq. */
125int xen_pirq_from_irq(unsigned irq);
126
127/* Return the irq allocated to the gsi */
128int xen_irq_from_gsi(unsigned gsi);
129
130/* Determine whether to ignore this IRQ if it is passed to a guest. */
131int xen_test_irq_shared(int irq);
132
133/* initialize Xen IRQ subsystem */
134void xen_init_IRQ(void);
135
136irqreturn_t xen_debug_interrupt(int irq, void *dev_id);
137
138static inline void xen_evtchn_close(evtchn_port_t port)
139{
140	struct evtchn_close close;
141
142	close.port = port;
143	if (HYPERVISOR_event_channel_op(EVTCHNOP_close, &close) != 0)
144		BUG();
145}
146
147#endif	/* _XEN_EVENTS_H */
v4.17
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef _XEN_EVENTS_H
  3#define _XEN_EVENTS_H
  4
  5#include <linux/interrupt.h>
 
  6#ifdef CONFIG_PCI_MSI
  7#include <linux/msi.h>
  8#endif
  9
 10#include <xen/interface/event_channel.h>
 11#include <asm/xen/hypercall.h>
 12#include <asm/xen/events.h>
 13
 
 
 14unsigned xen_evtchn_nr_channels(void);
 15
 16int bind_evtchn_to_irq(unsigned int evtchn);
 17int bind_evtchn_to_irqhandler(unsigned int evtchn,
 
 
 
 
 
 18			      irq_handler_t handler,
 19			      unsigned long irqflags, const char *devname,
 20			      void *dev_id);
 21int bind_virq_to_irq(unsigned int virq, unsigned int cpu, bool percpu);
 22int bind_virq_to_irqhandler(unsigned int virq, unsigned int cpu,
 23			    irq_handler_t handler,
 24			    unsigned long irqflags, const char *devname,
 25			    void *dev_id);
 26int bind_ipi_to_irqhandler(enum ipi_vector ipi,
 27			   unsigned int cpu,
 28			   irq_handler_t handler,
 29			   unsigned long irqflags,
 30			   const char *devname,
 31			   void *dev_id);
 32int bind_interdomain_evtchn_to_irq(unsigned int remote_domain,
 33				   unsigned int remote_port);
 34int bind_interdomain_evtchn_to_irqhandler(unsigned int remote_domain,
 35					  unsigned int remote_port,
 36					  irq_handler_t handler,
 37					  unsigned long irqflags,
 38					  const char *devname,
 39					  void *dev_id);
 40
 41/*
 42 * Common unbind function for all event sources. Takes IRQ to unbind from.
 43 * Automatically closes the underlying event channel (even for bindings
 44 * made with bind_evtchn_to_irqhandler()).
 45 */
 46void unbind_from_irqhandler(unsigned int irq, void *dev_id);
 47
 
 
 
 
 
 
 
 
 48#define XEN_IRQ_PRIORITY_MAX     EVTCHN_FIFO_PRIORITY_MAX
 49#define XEN_IRQ_PRIORITY_DEFAULT EVTCHN_FIFO_PRIORITY_DEFAULT
 50#define XEN_IRQ_PRIORITY_MIN     EVTCHN_FIFO_PRIORITY_MIN
 51int xen_set_irq_priority(unsigned irq, unsigned priority);
 52
 53/*
 54 * Allow extra references to event channels exposed to userspace by evtchn
 55 */
 56int evtchn_make_refcounted(unsigned int evtchn);
 57int evtchn_get(unsigned int evtchn);
 58void evtchn_put(unsigned int evtchn);
 59
 60void xen_send_IPI_one(unsigned int cpu, enum ipi_vector vector);
 61void rebind_evtchn_irq(int evtchn, int irq);
 62int xen_rebind_evtchn_to_cpu(int evtchn, unsigned tcpu);
 63
 64static inline void notify_remote_via_evtchn(int port)
 65{
 66	struct evtchn_send send = { .port = port };
 67	(void)HYPERVISOR_event_channel_op(EVTCHNOP_send, &send);
 68}
 69
 70void notify_remote_via_irq(int irq);
 71
 72void xen_irq_resume(void);
 73
 74/* Clear an irq's pending state, in preparation for polling on it */
 75void xen_clear_irq_pending(int irq);
 76void xen_set_irq_pending(int irq);
 77bool xen_test_irq_pending(int irq);
 78
 79/* Poll waiting for an irq to become pending.  In the usual case, the
 80   irq will be disabled so it won't deliver an interrupt. */
 81void xen_poll_irq(int irq);
 82
 83/* Poll waiting for an irq to become pending with a timeout.  In the usual case,
 84 * the irq will be disabled so it won't deliver an interrupt. */
 85void xen_poll_irq_timeout(int irq, u64 timeout);
 86
 87/* Determine the IRQ which is bound to an event channel */
 88unsigned irq_from_evtchn(unsigned int evtchn);
 89int irq_from_virq(unsigned int cpu, unsigned int virq);
 90unsigned int evtchn_from_irq(unsigned irq);
 91
 92/* Xen HVM evtchn vector callback */
 93void xen_hvm_callback_vector(void);
 94#ifdef CONFIG_TRACING
 95#define trace_xen_hvm_callback_vector xen_hvm_callback_vector
 96#endif
 97int xen_set_callback_via(uint64_t via);
 98void xen_evtchn_do_upcall(struct pt_regs *regs);
 99void xen_hvm_evtchn_do_upcall(void);
100
101/* Bind a pirq for a physical interrupt to an irq. */
102int xen_bind_pirq_gsi_to_irq(unsigned gsi,
103			     unsigned pirq, int shareable, char *name);
104
105#ifdef CONFIG_PCI_MSI
106/* Allocate a pirq for a MSI style physical interrupt. */
107int xen_allocate_pirq_msi(struct pci_dev *dev, struct msi_desc *msidesc);
108/* Bind an PSI pirq to an irq. */
109int xen_bind_pirq_msi_to_irq(struct pci_dev *dev, struct msi_desc *msidesc,
110			     int pirq, int nvec, const char *name, domid_t domid);
111#endif
112
113/* De-allocates the above mentioned physical interrupt. */
114int xen_destroy_irq(int irq);
115
116/* Return irq from pirq */
117int xen_irq_from_pirq(unsigned pirq);
118
119/* Return the pirq allocated to the irq. */
120int xen_pirq_from_irq(unsigned irq);
121
122/* Return the irq allocated to the gsi */
123int xen_irq_from_gsi(unsigned gsi);
124
125/* Determine whether to ignore this IRQ if it is passed to a guest. */
126int xen_test_irq_shared(int irq);
127
128/* initialize Xen IRQ subsystem */
129void xen_init_IRQ(void);
 
 
 
 
 
 
 
 
 
 
 
 
130#endif	/* _XEN_EVENTS_H */