#include <rte_eventdev.h>

Data Fields
uint32_t	dequeue_timeout_ns

int32_t	nb_events_limit

uint8_t	nb_event_queues

uint8_t	nb_event_ports

uint32_t	nb_event_queue_flows

uint32_t	nb_event_port_dequeue_depth

uint32_t	nb_event_port_enqueue_depth

uint32_t	event_dev_cfg

uint8_t	nb_single_link_event_port_queues

enum rte_event_dev_preschedule_type	preschedule_type

Detailed Description

Event device configuration structure

Examples:: 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_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 767 of file rte_eventdev.h.

Field Documentation

◆ dequeue_timeout_ns

uint32_t dequeue_timeout_ns

rte_event_dequeue_burst() timeout on this device. This value should be in the range of rte_event_dev_info::min_dequeue_timeout_ns and rte_event_dev_info::max_dequeue_timeout_ns returned by rte_event_dev_info_get() The value 0 is allowed, in which case, default dequeue timeout used.

See also: RTE_EVENT_DEV_CFG_PER_DEQUEUE_TIMEOUT

Definition at line 768 of file rte_eventdev.h.

◆ nb_events_limit

int32_t nb_events_limit

In a closed system this field is the limit on maximum number of events that can be inflight in the eventdev at a given time. The limit is required to ensure that the finite space in a closed system is not exhausted. The value cannot exceed rte_event_dev_info::max_num_events returned by rte_event_dev_info_get().

This value should be set to -1 for open systems, that is, those systems returning -1 in rte_event_dev_info::max_num_events.

See also: rte_event_port_conf.new_event_threshold

Examples:: 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_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 776 of file rte_eventdev.h.

◆ nb_event_queues

uint8_t nb_event_queues

Number of event queues to configure on this device. This value includes any single-link queue-port pairs to be used. This value cannot exceed rte_event_dev_info::max_event_queues + rte_event_dev_info::max_single_link_event_port_queue_pairs returned by rte_event_dev_info_get(). The number of non-single-link queues i.e. this value less nb_single_link_event_port_queues in this struct, cannot exceed rte_event_dev_info::max_event_queues

Examples:: 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_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 789 of file rte_eventdev.h.

◆ nb_event_ports

uint8_t nb_event_ports

Number of event ports to configure on this device. This value includes any single-link queue-port pairs to be used. This value cannot exceed rte_event_dev_info::max_event_ports + rte_event_dev_info::max_single_link_event_port_queue_pairs returned by rte_event_dev_info_get(). The number of non-single-link ports i.e. this value less nb_single_link_event_port_queues in this struct, cannot exceed rte_event_dev_info::max_event_ports

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 799 of file rte_eventdev.h.

◆ nb_event_queue_flows

uint32_t nb_event_queue_flows

Max number of flows needed for a single event queue on this device. This value cannot exceed rte_event_dev_info::max_event_queue_flows returned by rte_event_dev_info_get()

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 809 of file rte_eventdev.h.

◆ nb_event_port_dequeue_depth

uint32_t nb_event_port_dequeue_depth

Max number of events that can be dequeued at a time from an event port on this device. This value cannot exceed rte_event_dev_info::max_event_port_dequeue_depth returned by rte_event_dev_info_get(). Ignored when device is not RTE_EVENT_DEV_CAP_BURST_MODE capable.

See also: rte_event_port_setup() rte_event_dequeue_burst()

Examples:: 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_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 814 of file rte_eventdev.h.

◆ nb_event_port_enqueue_depth

uint32_t nb_event_port_enqueue_depth

Maximum number of events can be enqueued at a time to an event port on this device. This value cannot exceed rte_event_dev_info::max_event_port_enqueue_depth returned by rte_event_dev_info_get(). Ignored when device is not RTE_EVENT_DEV_CAP_BURST_MODE capable.

See also: rte_event_port_setup() rte_event_enqueue_burst()

Examples:: 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_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 821 of file rte_eventdev.h.

◆ event_dev_cfg

uint32_t event_dev_cfg

Event device config flags(RTE_EVENT_DEV_CFG_)

Definition at line 828 of file rte_eventdev.h.

◆ nb_single_link_event_port_queues

uint8_t nb_single_link_event_port_queues

Number of event ports and queues that will be singly-linked to each other. These are a subset of the overall event ports and queues; this value cannot exceed nb_event_ports or nb_event_queues. If the device has ports and queues that are optimized for single-link usage, this field is a hint for how many to allocate; otherwise, regular event ports and queues will be used.

Definition at line 830 of file rte_eventdev.h.