DPDK 25.03.0-rc0
Data Fields
rte_event_dev_info Struct Reference

#include <rte_eventdev.h>

Data Fields

const char * driver_name
 
struct rte_device * dev
 
uint32_t min_dequeue_timeout_ns
 
uint32_t max_dequeue_timeout_ns
 
uint32_t dequeue_timeout_ns
 
uint8_t max_event_queues
 
uint32_t max_event_queue_flows
 
uint8_t max_event_queue_priority_levels
 
uint8_t max_event_priority_levels
 
uint8_t max_event_ports
 
uint8_t max_event_port_dequeue_depth
 
uint32_t max_event_port_enqueue_depth
 
uint8_t max_event_port_links
 
int32_t max_num_events
 
uint32_t event_dev_cap
 
uint8_t max_single_link_event_port_queue_pairs
 
uint8_t max_profiles_per_port
 

Detailed Description

Event device information

Examples
examples/eventdev_pipeline/main.c, examples/eventdev_pipeline/pipeline_worker_generic.c, examples/eventdev_pipeline/pipeline_worker_tx.c, examples/ipsec-secgw/event_helper.c, examples/l2fwd-event/l2fwd_event.c, examples/l2fwd-event/l2fwd_event_generic.c, examples/l2fwd-event/l2fwd_event_internal_port.c, examples/l3fwd/l3fwd_event_generic.c, examples/l3fwd/l3fwd_event_internal_port.c, and examples/l3fwd/main.c.

Definition at line 599 of file rte_eventdev.h.

Field Documentation

◆ driver_name

const char* driver_name

Event driver name.

Definition at line 600 of file rte_eventdev.h.

◆ dev

struct rte_device* dev

Device information.

Definition at line 601 of file rte_eventdev.h.

◆ min_dequeue_timeout_ns

uint32_t min_dequeue_timeout_ns

Minimum global dequeue timeout(ns) supported by this device.

Definition at line 602 of file rte_eventdev.h.

◆ max_dequeue_timeout_ns

uint32_t max_dequeue_timeout_ns

Maximum global dequeue timeout(ns) supported by this device.

Definition at line 604 of file rte_eventdev.h.

◆ dequeue_timeout_ns

uint32_t dequeue_timeout_ns

Configured global dequeue timeout(ns) for this device.

Definition at line 606 of file rte_eventdev.h.

◆ max_event_queues

uint8_t max_event_queues

◆ max_event_queue_flows

uint32_t max_event_queue_flows

◆ max_event_queue_priority_levels

uint8_t max_event_queue_priority_levels

Maximum number of event queue priority levels supported by this device.

Valid when the device has RTE_EVENT_DEV_CAP_QUEUE_QOS capability.

The implementation shall normalize priority values specified between RTE_EVENT_DEV_PRIORITY_HIGHEST and RTE_EVENT_DEV_PRIORITY_LOWEST to map them internally to this range of priorities. [For devices supporting a power-of-2 number of priority levels, this normalization will be done via a right-shift operation, so only the top log2(max_levels) bits will be used by the event device.]

See also
rte_event_queue_conf.priority

Definition at line 615 of file rte_eventdev.h.

◆ max_event_priority_levels

uint8_t max_event_priority_levels

Maximum number of event priority levels by this device.

Valid when the device has RTE_EVENT_DEV_CAP_EVENT_QOS capability.

The implementation shall normalize priority values specified between RTE_EVENT_DEV_PRIORITY_HIGHEST and RTE_EVENT_DEV_PRIORITY_LOWEST to map them internally to this range of priorities. [For devices supporting a power-of-2 number of priority levels, this normalization will be done via a right-shift operation, so only the top log2(max_levels) bits will be used by the event device.]

See also
rte_event.priority

Definition at line 629 of file rte_eventdev.h.

◆ max_event_ports

uint8_t max_event_ports

Maximum number of event ports supported by this device.

This count excludes any ports covered by max_single_link_event_port_queue_pairs.

Examples
examples/l2fwd-event/l2fwd_event_generic.c, examples/l2fwd-event/l2fwd_event_internal_port.c, examples/l3fwd/l3fwd_event_generic.c, and examples/l3fwd/l3fwd_event_internal_port.c.

Definition at line 643 of file rte_eventdev.h.

◆ max_event_port_dequeue_depth

uint8_t max_event_port_dequeue_depth

Maximum number of events that can be dequeued at a time from an event port on this device.

A device that does not support burst dequeue (RTE_EVENT_DEV_CAP_BURST_MODE) will set this to 1.

Examples
examples/ipsec-secgw/event_helper.c, examples/l2fwd-event/l2fwd_event_generic.c, examples/l2fwd-event/l2fwd_event_internal_port.c, examples/l3fwd/l3fwd_event_generic.c, and examples/l3fwd/l3fwd_event_internal_port.c.

Definition at line 648 of file rte_eventdev.h.

◆ max_event_port_enqueue_depth

uint32_t max_event_port_enqueue_depth

Maximum number of events that can be enqueued at a time to an event port on this device.

A device that does not support burst enqueue (RTE_EVENT_DEV_CAP_BURST_MODE) will set this to 1.

Examples
examples/ipsec-secgw/event_helper.c, examples/l2fwd-event/l2fwd_event_generic.c, examples/l2fwd-event/l2fwd_event_internal_port.c, examples/l3fwd/l3fwd_event_generic.c, and examples/l3fwd/l3fwd_event_internal_port.c.

Definition at line 655 of file rte_eventdev.h.

◆ max_event_port_links

uint8_t max_event_port_links

Maximum number of queues that can be linked to a single event port on this device.

Definition at line 662 of file rte_eventdev.h.

◆ max_num_events

int32_t max_num_events

A closed system event dev has a limit on the number of events it can manage at a time. Once the number of events tracked by an eventdev exceeds this number, any enqueues of NEW events will fail. An open system event dev does not have a limit and will specify this as -1.

Examples
examples/ipsec-secgw/event_helper.c, examples/l2fwd-event/l2fwd_event_generic.c, examples/l2fwd-event/l2fwd_event_internal_port.c, examples/l3fwd/l3fwd_event_generic.c, and examples/l3fwd/l3fwd_event_internal_port.c.

Definition at line 665 of file rte_eventdev.h.

◆ event_dev_cap

uint32_t event_dev_cap

◆ max_single_link_event_port_queue_pairs

uint8_t max_single_link_event_port_queue_pairs

Maximum number of event ports and queues, supported by this device, that are optimized for (and only capable of) single-link configurations. These ports and queues are not accounted for in max_event_ports or max_event_queues.

Definition at line 674 of file rte_eventdev.h.

◆ max_profiles_per_port

uint8_t max_profiles_per_port

Maximum number of event queue link profiles per event port. A device that doesn't support multiple profiles will set this as 1.

Definition at line 680 of file rte_eventdev.h.


The documentation for this struct was generated from the following file: