1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2014 Intel Corporation
5 #ifndef _RTE_INTERRUPTS_H_
6 #error "don't include this file directly, please include generic <rte_interrupts.h>"
10 * @file rte_eal_interrupts.h
13 * Contains function prototypes exposed by the EAL for interrupt handling by
14 * drivers and other DPDK internal consumers.
17 #ifndef _RTE_EAL_INTERRUPTS_H_
18 #define _RTE_EAL_INTERRUPTS_H_
20 #define RTE_MAX_RXTX_INTR_VEC_ID 32
21 #define RTE_INTR_VEC_ZERO_OFFSET 0
22 #define RTE_INTR_VEC_RXTX_OFFSET 1
25 * The interrupt source type, e.g. UIO, VFIO, ALARM etc.
27 enum rte_intr_handle_type {
28 RTE_INTR_HANDLE_UNKNOWN = 0, /**< generic unknown handle */
29 RTE_INTR_HANDLE_UIO, /**< uio device handle */
30 RTE_INTR_HANDLE_UIO_INTX, /**< uio generic handle */
31 RTE_INTR_HANDLE_VFIO_LEGACY, /**< vfio device handle (legacy) */
32 RTE_INTR_HANDLE_VFIO_MSI, /**< vfio device handle (MSI) */
33 RTE_INTR_HANDLE_VFIO_MSIX, /**< vfio device handle (MSIX) */
34 RTE_INTR_HANDLE_ALARM, /**< alarm handle */
35 RTE_INTR_HANDLE_EXT, /**< external handler */
36 RTE_INTR_HANDLE_VDEV, /**< virtual device */
37 RTE_INTR_HANDLE_MAX /**< count of elements */
40 #define RTE_INTR_EVENT_ADD 1UL
41 #define RTE_INTR_EVENT_DEL 2UL
43 typedef void (*rte_intr_event_cb_t)(int fd, void *arg);
45 struct rte_epoll_data {
46 uint32_t event; /**< event type */
47 void *data; /**< User data */
48 rte_intr_event_cb_t cb_fun; /**< IN: callback fun */
49 void *cb_arg; /**< IN: callback arg */
53 RTE_EPOLL_INVALID = 0,
58 /** interrupt epoll event obj, taken by epoll_event.ptr */
59 struct rte_epoll_event {
60 volatile uint32_t status; /**< OUT: event status */
61 int fd; /**< OUT: event fd */
62 int epfd; /**< OUT: epoll instance the ev associated with */
63 struct rte_epoll_data epdata;
66 /** Handle for interrupts. */
67 struct rte_intr_handle {
70 int vfio_dev_fd; /**< VFIO device file descriptor */
71 int uio_cfg_fd; /**< UIO cfg file desc for uio_pci_generic */
73 int fd; /**< interrupt event file descriptor */
74 enum rte_intr_handle_type type; /**< handle type */
75 uint32_t max_intr; /**< max interrupt requested */
76 uint32_t nb_efd; /**< number of available efd(event fd) */
77 uint8_t efd_counter_size; /**< size of efd counter, used for vdev */
78 int efds[RTE_MAX_RXTX_INTR_VEC_ID]; /**< intr vectors/efds mapping */
79 struct rte_epoll_event elist[RTE_MAX_RXTX_INTR_VEC_ID];
80 /**< intr vector epoll event */
81 int *intr_vec; /**< intr vector number array */
84 #define RTE_EPOLL_PER_THREAD -1 /**< to hint using per thread epfd */
87 * It waits for events on the epoll instance.
90 * Epoll instance fd on which the caller wait for events.
92 * Memory area contains the events that will be available for the caller.
94 * Up to maxevents are returned, must greater than zero.
96 * Specifying a timeout of -1 causes a block indefinitely.
97 * Specifying a timeout equal to zero cause to return immediately.
99 * - On success, returns the number of available event.
100 * - On failure, a negative value.
103 rte_epoll_wait(int epfd, struct rte_epoll_event *events,
104 int maxevents, int timeout);
107 * It performs control operations on epoll instance referred by the epfd.
108 * It requests that the operation op be performed for the target fd.
111 * Epoll instance fd on which the caller perform control operations.
113 * The operation be performed for the target fd.
115 * The target fd on which the control ops perform.
117 * Describes the object linked to the fd.
118 * Note: The caller must take care the object deletion after CTL_DEL.
120 * - On success, zero.
121 * - On failure, a negative value.
124 rte_epoll_ctl(int epfd, int op, int fd,
125 struct rte_epoll_event *event);
128 * The function returns the per thread epoll instance.
131 * epfd the epoll instance referred to.
134 rte_intr_tls_epfd(void);
138 * Pointer to the interrupt handle.
140 * Epoll instance fd which the intr vector associated to.
142 * The operation be performed for the vector.
143 * Operation type of {ADD, DEL}.
145 * RX intr vector number added to the epoll instance wait list.
149 * - On success, zero.
150 * - On failure, a negative value.
153 rte_intr_rx_ctl(struct rte_intr_handle *intr_handle,
154 int epfd, int op, unsigned int vec, void *data);
157 * It deletes registered eventfds.
160 * Pointer to the interrupt handle.
163 rte_intr_free_epoll_fd(struct rte_intr_handle *intr_handle);
166 * It enables the packet I/O interrupt event if it's necessary.
167 * It creates event fd for each interrupt vector when MSIX is used,
168 * otherwise it multiplexes a single event fd.
171 * Pointer to the interrupt handle.
173 * Number of interrupt vector trying to enable.
174 * The value 0 is not allowed.
176 * - On success, zero.
177 * - On failure, a negative value.
180 rte_intr_efd_enable(struct rte_intr_handle *intr_handle, uint32_t nb_efd);
183 * It disables the packet I/O interrupt event.
184 * It deletes registered eventfds and closes the open fds.
187 * Pointer to the interrupt handle.
190 rte_intr_efd_disable(struct rte_intr_handle *intr_handle);
193 * The packet I/O interrupt on datapath is enabled or not.
196 * Pointer to the interrupt handle.
199 rte_intr_dp_is_en(struct rte_intr_handle *intr_handle);
202 * The interrupt handle instance allows other causes or not.
203 * Other causes stand for any none packet I/O interrupts.
206 * Pointer to the interrupt handle.
209 rte_intr_allow_others(struct rte_intr_handle *intr_handle);
212 * The multiple interrupt vector capability of interrupt handle instance.
213 * It returns zero if no multiple interrupt vector support.
216 * Pointer to the interrupt handle.
219 rte_intr_cap_multiple(struct rte_intr_handle *intr_handle);
221 #endif /* _RTE_EAL_INTERRUPTS_H_ */