DPDK  18.11.2
rte_eventdev.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2016 Cavium, Inc.
3  * Copyright(c) 2016-2018 Intel Corporation.
4  * Copyright 2016 NXP
5  * All rights reserved.
6  */
7 
8 #ifndef _RTE_EVENTDEV_H_
9 #define _RTE_EVENTDEV_H_
10 
210 #ifdef __cplusplus
211 extern "C" {
212 #endif
213 
214 #include <rte_common.h>
215 #include <rte_config.h>
216 #include <rte_memory.h>
217 #include <rte_errno.h>
218 
219 struct rte_mbuf; /* we just use mbuf pointers; no need to include rte_mbuf.h */
220 struct rte_event;
221 
222 /* Event device capability bitmap flags */
223 #define RTE_EVENT_DEV_CAP_QUEUE_QOS (1ULL << 0)
224 
229 #define RTE_EVENT_DEV_CAP_EVENT_QOS (1ULL << 1)
230 
236 #define RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED (1ULL << 2)
237 
245 #define RTE_EVENT_DEV_CAP_QUEUE_ALL_TYPES (1ULL << 3)
246 
252 #define RTE_EVENT_DEV_CAP_BURST_MODE (1ULL << 4)
253 
260 #define RTE_EVENT_DEV_CAP_IMPLICIT_RELEASE_DISABLE (1ULL << 5)
261 
271 #define RTE_EVENT_DEV_CAP_NONSEQ_MODE (1ULL << 6)
272 
281 #define RTE_EVENT_DEV_CAP_RUNTIME_PORT_LINK (1ULL << 7)
282 
287 #define RTE_EVENT_DEV_CAP_MULTIPLE_QUEUE_PORT (1ULL << 8)
288 
293 /* Event device priority levels */
294 #define RTE_EVENT_DEV_PRIORITY_HIGHEST 0
295 
299 #define RTE_EVENT_DEV_PRIORITY_NORMAL 128
300 
304 #define RTE_EVENT_DEV_PRIORITY_LOWEST 255
305 
317 uint8_t
318 rte_event_dev_count(void);
319 
330 int
331 rte_event_dev_get_dev_id(const char *name);
332 
343 int
344 rte_event_dev_socket_id(uint8_t dev_id);
345 
350  const char *driver_name;
351  struct rte_device *dev;
382  int32_t max_num_events;
387  uint32_t event_dev_cap;
389 };
390 
406 int
407 rte_event_dev_info_get(uint8_t dev_id, struct rte_event_dev_info *dev_info);
408 
412 #define RTE_EVENT_DEV_ATTR_PORT_COUNT 0
413 
416 #define RTE_EVENT_DEV_ATTR_QUEUE_COUNT 1
417 
420 #define RTE_EVENT_DEV_ATTR_STARTED 2
421 
434 int
435 rte_event_dev_attr_get(uint8_t dev_id, uint32_t attr_id,
436  uint32_t *attr_value);
437 
438 
439 /* Event device configuration bitmap flags */
440 #define RTE_EVENT_DEV_CFG_PER_DEQUEUE_TIMEOUT (1ULL << 0)
441 
468  uint8_t nb_event_ports;
494  uint32_t event_dev_cfg;
496 };
497 
517 int
518 rte_event_dev_configure(uint8_t dev_id,
519  const struct rte_event_dev_config *dev_conf);
520 
521 
522 /* Event queue specific APIs */
523 
524 /* Event queue configuration bitmap flags */
525 #define RTE_EVENT_QUEUE_CFG_ALL_TYPES (1ULL << 0)
526 
531 #define RTE_EVENT_QUEUE_CFG_SINGLE_LINK (1ULL << 1)
532 
539  uint32_t nb_atomic_flows;
561  uint32_t event_queue_cfg;
563  uint8_t schedule_type;
568  uint8_t priority;
576 };
577 
600 int
601 rte_event_queue_default_conf_get(uint8_t dev_id, uint8_t queue_id,
602  struct rte_event_queue_conf *queue_conf);
603 
622 int
623 rte_event_queue_setup(uint8_t dev_id, uint8_t queue_id,
624  const struct rte_event_queue_conf *queue_conf);
625 
629 #define RTE_EVENT_QUEUE_ATTR_PRIORITY 0
630 
633 #define RTE_EVENT_QUEUE_ATTR_NB_ATOMIC_FLOWS 1
634 
637 #define RTE_EVENT_QUEUE_ATTR_NB_ATOMIC_ORDER_SEQUENCES 2
638 
641 #define RTE_EVENT_QUEUE_ATTR_EVENT_QUEUE_CFG 3
642 
645 #define RTE_EVENT_QUEUE_ATTR_SCHEDULE_TYPE 4
646 
667 int
668 rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id,
669  uint32_t *attr_value);
670 
671 /* Event port specific APIs */
672 
688  uint16_t dequeue_depth;
694  uint16_t enqueue_depth;
707 };
708 
731 int
732 rte_event_port_default_conf_get(uint8_t dev_id, uint8_t port_id,
733  struct rte_event_port_conf *port_conf);
734 
755 int
756 rte_event_port_setup(uint8_t dev_id, uint8_t port_id,
757  const struct rte_event_port_conf *port_conf);
758 
762 #define RTE_EVENT_PORT_ATTR_ENQ_DEPTH 0
763 
766 #define RTE_EVENT_PORT_ATTR_DEQ_DEPTH 1
767 
770 #define RTE_EVENT_PORT_ATTR_NEW_EVENT_THRESHOLD 2
771 
788 int
789 rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id,
790  uint32_t *attr_value);
791 
808 int
809 rte_event_dev_start(uint8_t dev_id);
810 
829 void
830 rte_event_dev_stop(uint8_t dev_id);
831 
832 typedef void (*eventdev_stop_flush_t)(uint8_t dev_id, struct rte_event event,
833  void *arg);
862 int
864  eventdev_stop_flush_t callback, void *userdata);
865 
877 int
878 rte_event_dev_close(uint8_t dev_id);
879 
880 /* Scheduler type definitions */
881 #define RTE_SCHED_TYPE_ORDERED 0
882 
908 #define RTE_SCHED_TYPE_ATOMIC 1
909 
927 #define RTE_SCHED_TYPE_PARALLEL 2
928 
940 /* Event types to classify the event source */
941 #define RTE_EVENT_TYPE_ETHDEV 0x0
942 
943 #define RTE_EVENT_TYPE_CRYPTODEV 0x1
944 
945 #define RTE_EVENT_TYPE_TIMER 0x2
946 
947 #define RTE_EVENT_TYPE_CPU 0x3
948 
951 #define RTE_EVENT_TYPE_ETH_RX_ADAPTER 0x4
952 
953 #define RTE_EVENT_TYPE_MAX 0x10
954 
956 /* Event enqueue operations */
957 #define RTE_EVENT_OP_NEW 0
958 
961 #define RTE_EVENT_OP_FORWARD 1
962 
969 #define RTE_EVENT_OP_RELEASE 2
970 
1007 struct rte_event {
1009  union {
1010  uint64_t event;
1012  struct {
1013  uint32_t flow_id:20;
1020  uint32_t sub_event_type:8;
1024  uint32_t event_type:4;
1028  uint8_t op:2;
1034  uint8_t rsvd:4;
1036  uint8_t sched_type:2;
1041  uint8_t queue_id;
1048  uint8_t priority;
1058  uint8_t impl_opaque;
1065  };
1066  };
1068  union {
1069  uint64_t u64;
1071  void *event_ptr;
1073  struct rte_mbuf *mbuf;
1075  };
1076 };
1077 
1078 /* Ethdev Rx adapter capability bitmap flags */
1079 #define RTE_EVENT_ETH_RX_ADAPTER_CAP_INTERNAL_PORT 0x1
1080 
1083 #define RTE_EVENT_ETH_RX_ADAPTER_CAP_MULTI_EVENTQ 0x2
1084 
1087 #define RTE_EVENT_ETH_RX_ADAPTER_CAP_OVERRIDE_FLOW_ID 0x4
1088 
1114 int
1115 rte_event_eth_rx_adapter_caps_get(uint8_t dev_id, uint16_t eth_port_id,
1116  uint32_t *caps);
1117 
1118 #define RTE_EVENT_TIMER_ADAPTER_CAP_INTERNAL_PORT (1ULL << 0)
1119 
1134 int __rte_experimental
1135 rte_event_timer_adapter_caps_get(uint8_t dev_id, uint32_t *caps);
1136 
1137 /* Crypto adapter capability bitmap flag */
1138 #define RTE_EVENT_CRYPTO_ADAPTER_CAP_INTERNAL_PORT_OP_NEW 0x1
1139 
1145 #define RTE_EVENT_CRYPTO_ADAPTER_CAP_INTERNAL_PORT_OP_FWD 0x2
1146 
1152 #define RTE_EVENT_CRYPTO_ADAPTER_CAP_INTERNAL_PORT_QP_EV_BIND 0x4
1153 
1157 #define RTE_EVENT_CRYPTO_ADAPTER_CAP_SESSION_PRIVATE_DATA 0x8
1158 
1185 int __rte_experimental
1186 rte_event_crypto_adapter_caps_get(uint8_t dev_id, uint8_t cdev_id,
1187  uint32_t *caps);
1188 
1189 /* Ethdev Tx adapter capability bitmap flags */
1190 #define RTE_EVENT_ETH_TX_ADAPTER_CAP_INTERNAL_PORT 0x1
1191 
1211 int __rte_experimental
1212 rte_event_eth_tx_adapter_caps_get(uint8_t dev_id, uint16_t eth_port_id,
1213  uint32_t *caps);
1214 
1215 struct rte_eventdev_ops;
1216 struct rte_eventdev;
1217 
1218 typedef uint16_t (*event_enqueue_t)(void *port, const struct rte_event *ev);
1221 typedef uint16_t (*event_enqueue_burst_t)(void *port,
1222  const struct rte_event ev[], uint16_t nb_events);
1225 typedef uint16_t (*event_dequeue_t)(void *port, struct rte_event *ev,
1226  uint64_t timeout_ticks);
1229 typedef uint16_t (*event_dequeue_burst_t)(void *port, struct rte_event ev[],
1230  uint16_t nb_events, uint64_t timeout_ticks);
1233 typedef uint16_t (*event_tx_adapter_enqueue)(void *port,
1234  struct rte_event ev[], uint16_t nb_events);
1237 #define RTE_EVENTDEV_NAME_MAX_LEN (64)
1238 
1247 struct rte_eventdev_data {
1248  int socket_id;
1250  uint8_t dev_id;
1252  uint8_t nb_queues;
1254  uint8_t nb_ports;
1256  void **ports;
1258  struct rte_event_port_conf *ports_cfg;
1260  struct rte_event_queue_conf *queues_cfg;
1262  uint16_t *links_map;
1264  void *dev_private;
1266  uint32_t event_dev_cap;
1268  struct rte_event_dev_config dev_conf;
1270  uint8_t service_inited;
1271  /* Service initialization state */
1272  uint32_t service_id;
1273  /* Service ID*/
1274  void *dev_stop_flush_arg;
1277  RTE_STD_C11
1278  uint8_t dev_started : 1;
1281  char name[RTE_EVENTDEV_NAME_MAX_LEN];
1284 
1286 struct rte_eventdev {
1287  event_enqueue_t enqueue;
1289  event_enqueue_burst_t enqueue_burst;
1291  event_enqueue_burst_t enqueue_new_burst;
1293  event_enqueue_burst_t enqueue_forward_burst;
1295  event_dequeue_t dequeue;
1297  event_dequeue_burst_t dequeue_burst;
1299  event_tx_adapter_enqueue txa_enqueue;
1301  struct rte_eventdev_data *data;
1303  struct rte_eventdev_ops *dev_ops;
1305  struct rte_device *dev;
1308  RTE_STD_C11
1309  uint8_t attached : 1;
1312 
1313 extern struct rte_eventdev *rte_eventdevs;
1316 static __rte_always_inline uint16_t
1317 __rte_event_enqueue_burst(uint8_t dev_id, uint8_t port_id,
1318  const struct rte_event ev[], uint16_t nb_events,
1319  const event_enqueue_burst_t fn)
1320 {
1321  const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1322 
1323 #ifdef RTE_LIBRTE_EVENTDEV_DEBUG
1324  if (dev_id >= RTE_EVENT_MAX_DEVS || !rte_eventdevs[dev_id].attached) {
1325  rte_errno = -EINVAL;
1326  return 0;
1327  }
1328 
1329  if (port_id >= dev->data->nb_ports) {
1330  rte_errno = -EINVAL;
1331  return 0;
1332  }
1333 #endif
1334  /*
1335  * Allow zero cost non burst mode routine invocation if application
1336  * requests nb_events as const one
1337  */
1338  if (nb_events == 1)
1339  return (*dev->enqueue)(dev->data->ports[port_id], ev);
1340  else
1341  return fn(dev->data->ports[port_id], ev, nb_events);
1342 }
1343 
1387 static inline uint16_t
1388 rte_event_enqueue_burst(uint8_t dev_id, uint8_t port_id,
1389  const struct rte_event ev[], uint16_t nb_events)
1390 {
1391  const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1392 
1393  return __rte_event_enqueue_burst(dev_id, port_id, ev, nb_events,
1394  dev->enqueue_burst);
1395 }
1396 
1438 static inline uint16_t
1439 rte_event_enqueue_new_burst(uint8_t dev_id, uint8_t port_id,
1440  const struct rte_event ev[], uint16_t nb_events)
1441 {
1442  const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1443 
1444  return __rte_event_enqueue_burst(dev_id, port_id, ev, nb_events,
1445  dev->enqueue_new_burst);
1446 }
1447 
1489 static inline uint16_t
1490 rte_event_enqueue_forward_burst(uint8_t dev_id, uint8_t port_id,
1491  const struct rte_event ev[], uint16_t nb_events)
1492 {
1493  const struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1494 
1495  return __rte_event_enqueue_burst(dev_id, port_id, ev, nb_events,
1496  dev->enqueue_forward_burst);
1497 }
1498 
1524 int
1525 rte_event_dequeue_timeout_ticks(uint8_t dev_id, uint64_t ns,
1526  uint64_t *timeout_ticks);
1527 
1594 static inline uint16_t
1595 rte_event_dequeue_burst(uint8_t dev_id, uint8_t port_id, struct rte_event ev[],
1596  uint16_t nb_events, uint64_t timeout_ticks)
1597 {
1598  struct rte_eventdev *dev = &rte_eventdevs[dev_id];
1599 
1600 #ifdef RTE_LIBRTE_EVENTDEV_DEBUG
1601  if (dev_id >= RTE_EVENT_MAX_DEVS || !rte_eventdevs[dev_id].attached) {
1602  rte_errno = -EINVAL;
1603  return 0;
1604  }
1605 
1606  if (port_id >= dev->data->nb_ports) {
1607  rte_errno = -EINVAL;
1608  return 0;
1609  }
1610 #endif
1611 
1612  /*
1613  * Allow zero cost non burst mode routine invocation if application
1614  * requests nb_events as const one
1615  */
1616  if (nb_events == 1)
1617  return (*dev->dequeue)(
1618  dev->data->ports[port_id], ev, timeout_ticks);
1619  else
1620  return (*dev->dequeue_burst)(
1621  dev->data->ports[port_id], ev, nb_events,
1622  timeout_ticks);
1623 }
1624 
1685 int
1686 rte_event_port_link(uint8_t dev_id, uint8_t port_id,
1687  const uint8_t queues[], const uint8_t priorities[],
1688  uint16_t nb_links);
1689 
1729 int
1730 rte_event_port_unlink(uint8_t dev_id, uint8_t port_id,
1731  uint8_t queues[], uint16_t nb_unlinks);
1732 
1757 int __rte_experimental
1758 rte_event_port_unlinks_in_progress(uint8_t dev_id, uint8_t port_id);
1759 
1787 int
1788 rte_event_port_links_get(uint8_t dev_id, uint8_t port_id,
1789  uint8_t queues[], uint8_t priorities[]);
1790 
1806 int
1807 rte_event_dev_service_id_get(uint8_t dev_id, uint32_t *service_id);
1808 
1822 int
1823 rte_event_dev_dump(uint8_t dev_id, FILE *f);
1824 
1826 #define RTE_EVENT_DEV_XSTATS_NAME_SIZE 64
1827 
1832  RTE_EVENT_DEV_XSTATS_DEVICE,
1833  RTE_EVENT_DEV_XSTATS_PORT,
1834  RTE_EVENT_DEV_XSTATS_QUEUE,
1835 };
1836 
1844  char name[RTE_EVENT_DEV_XSTATS_NAME_SIZE];
1845 };
1846 
1879 int
1880 rte_event_dev_xstats_names_get(uint8_t dev_id,
1881  enum rte_event_dev_xstats_mode mode,
1882  uint8_t queue_port_id,
1883  struct rte_event_dev_xstats_name *xstats_names,
1884  unsigned int *ids,
1885  unsigned int size);
1886 
1913 int
1914 rte_event_dev_xstats_get(uint8_t dev_id,
1915  enum rte_event_dev_xstats_mode mode,
1916  uint8_t queue_port_id,
1917  const unsigned int ids[],
1918  uint64_t values[], unsigned int n);
1919 
1936 uint64_t
1937 rte_event_dev_xstats_by_name_get(uint8_t dev_id, const char *name,
1938  unsigned int *id);
1939 
1960 int
1961 rte_event_dev_xstats_reset(uint8_t dev_id,
1962  enum rte_event_dev_xstats_mode mode,
1963  int16_t queue_port_id,
1964  const uint32_t ids[],
1965  uint32_t nb_ids);
1966 
1977 int rte_event_dev_selftest(uint8_t dev_id);
1978 
1979 #ifdef __cplusplus
1980 }
1981 #endif
1982 
1983 #endif /* _RTE_EVENTDEV_H_ */
void rte_event_dev_stop(uint8_t dev_id)
uint32_t min_dequeue_timeout_ns
Definition: rte_eventdev.h:352
int rte_event_dequeue_timeout_ticks(uint8_t dev_id, uint64_t ns, uint64_t *timeout_ticks)
static uint16_t rte_event_enqueue_new_burst(uint8_t dev_id, uint8_t port_id, const struct rte_event ev[], uint16_t nb_events)
#define __rte_always_inline
Definition: rte_common.h:146
#define RTE_EVENT_DEV_XSTATS_NAME_SIZE
uint64_t u64
int rte_event_dev_attr_get(uint8_t dev_id, uint32_t attr_id, uint32_t *attr_value)
uint32_t flow_id
int rte_event_dev_stop_flush_callback_register(uint8_t dev_id, eventdev_stop_flush_t callback, void *userdata)
uint8_t priority
struct rte_device * dev
Definition: rte_eventdev.h:351
int rte_event_queue_setup(uint8_t dev_id, uint8_t queue_id, const struct rte_event_queue_conf *queue_conf)
int rte_event_queue_default_conf_get(uint8_t dev_id, uint8_t queue_id, struct rte_event_queue_conf *queue_conf)
int rte_event_port_default_conf_get(uint8_t dev_id, uint8_t port_id, struct rte_event_port_conf *port_conf)
uint32_t dequeue_timeout_ns
Definition: rte_eventdev.h:356
#define rte_errno
Definition: rte_errno.h:29
uint32_t event_type
uint32_t event_dev_cap
Definition: rte_eventdev.h:387
int rte_event_dev_socket_id(uint8_t dev_id)
uint32_t max_event_port_enqueue_depth
Definition: rte_eventdev.h:377
uint64_t rte_event_dev_xstats_by_name_get(uint8_t dev_id, const char *name, unsigned int *id)
int rte_event_dev_info_get(uint8_t dev_id, struct rte_event_dev_info *dev_info)
uint32_t nb_atomic_order_sequences
Definition: rte_eventdev.h:547
uint32_t nb_event_port_dequeue_depth
Definition: rte_eventdev.h:478
void * event_ptr
int rte_event_port_link(uint8_t dev_id, uint8_t port_id, const uint8_t queues[], const uint8_t priorities[], uint16_t nb_links)
int rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id, uint32_t *attr_value)
uint8_t disable_implicit_release
Definition: rte_eventdev.h:700
rte_event_dev_xstats_mode
int rte_event_port_links_get(uint8_t dev_id, uint8_t port_id, uint8_t queues[], uint8_t priorities[])
int __rte_experimental rte_event_eth_tx_adapter_caps_get(uint8_t dev_id, uint16_t eth_port_id, uint32_t *caps)
int rte_event_dev_selftest(uint8_t dev_id)
static uint16_t rte_event_enqueue_burst(uint8_t dev_id, uint8_t port_id, const struct rte_event ev[], uint16_t nb_events)
int rte_event_dev_start(uint8_t dev_id)
int rte_event_port_setup(uint8_t dev_id, uint8_t port_id, const struct rte_event_port_conf *port_conf)
uint8_t max_event_port_dequeue_depth
Definition: rte_eventdev.h:372
int rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id, uint32_t *attr_value)
uint32_t nb_event_port_enqueue_depth
Definition: rte_eventdev.h:486
const char * driver_name
Definition: rte_eventdev.h:350
uint8_t impl_opaque
uint8_t queue_id
static uint16_t rte_event_dequeue_burst(uint8_t dev_id, uint8_t port_id, struct rte_event ev[], uint16_t nb_events, uint64_t timeout_ticks)
int rte_event_dev_get_dev_id(const char *name)
int __rte_experimental rte_event_port_unlinks_in_progress(uint8_t dev_id, uint8_t port_id)
uint8_t rte_event_dev_count(void)
int rte_event_dev_close(uint8_t dev_id)
int __rte_experimental rte_event_crypto_adapter_caps_get(uint8_t dev_id, uint8_t cdev_id, uint32_t *caps)
int rte_event_dev_xstats_get(uint8_t dev_id, enum rte_event_dev_xstats_mode mode, uint8_t queue_port_id, const unsigned int ids[], uint64_t values[], unsigned int n)
int rte_event_dev_xstats_reset(uint8_t dev_id, enum rte_event_dev_xstats_mode mode, int16_t queue_port_id, const uint32_t ids[], uint32_t nb_ids)
#define RTE_STD_C11
Definition: rte_common.h:37
uint32_t dequeue_timeout_ns
Definition: rte_eventdev.h:447
int rte_event_dev_service_id_get(uint8_t dev_id, uint32_t *service_id)
static uint16_t rte_event_enqueue_forward_burst(uint8_t dev_id, uint8_t port_id, const struct rte_event ev[], uint16_t nb_events)
#define __rte_cache_aligned
Definition: rte_memory.h:66
int rte_event_dev_dump(uint8_t dev_id, FILE *f)
uint8_t rsvd
uint8_t op
int32_t new_event_threshold
Definition: rte_eventdev.h:675
uint8_t max_event_priority_levels
Definition: rte_eventdev.h:366
struct rte_mbuf * mbuf
uint32_t max_dequeue_timeout_ns
Definition: rte_eventdev.h:354
int __rte_experimental rte_event_timer_adapter_caps_get(uint8_t dev_id, uint32_t *caps)
uint32_t max_event_queue_flows
Definition: rte_eventdev.h:360
int rte_event_dev_configure(uint8_t dev_id, const struct rte_event_dev_config *dev_conf)
void(* eventdev_stop_flush_t)(uint8_t dev_id, struct rte_event event, void *arg)
Definition: rte_eventdev.h:832
uint32_t sub_event_type
uint8_t sched_type
uint8_t max_event_queues
Definition: rte_eventdev.h:358
uint8_t max_event_queue_priority_levels
Definition: rte_eventdev.h:362
int rte_event_port_unlink(uint8_t dev_id, uint8_t port_id, uint8_t queues[], uint16_t nb_unlinks)
int rte_event_eth_rx_adapter_caps_get(uint8_t dev_id, uint16_t eth_port_id, uint32_t *caps)
int rte_event_dev_xstats_names_get(uint8_t dev_id, enum rte_event_dev_xstats_mode mode, uint8_t queue_port_id, struct rte_event_dev_xstats_name *xstats_names, unsigned int *ids, unsigned int size)
uint32_t nb_event_queue_flows
Definition: rte_eventdev.h:473