#include <rte_ethdev.h>

Data Fields
const char *	driver_name

unsigned int	if_index

uint16_t	min_mtu

uint16_t	max_mtu

const uint32_t *	dev_flags

uint32_t	min_rx_bufsize

uint32_t	max_rx_pktlen

uint32_t	max_lro_pkt_size

uint16_t	max_rx_queues

uint16_t	max_tx_queues

uint32_t	max_mac_addrs

uint16_t	max_vfs

uint16_t	max_vmdq_pools

struct rte_eth_rxseg_capa	rx_seg_capa

uint64_t	rx_offload_capa

uint64_t	tx_offload_capa

uint64_t	rx_queue_offload_capa

uint64_t	tx_queue_offload_capa

uint16_t	reta_size

uint8_t	hash_key_size

uint64_t	flow_type_rss_offloads

struct rte_eth_rxconf	default_rxconf

struct rte_eth_txconf	default_txconf

uint16_t	vmdq_queue_base

uint16_t	vmdq_queue_num

uint16_t	vmdq_pool_base

struct rte_eth_desc_lim	rx_desc_lim

struct rte_eth_desc_lim	tx_desc_lim

uint32_t	speed_capa

uint16_t	nb_rx_queues

uint16_t	nb_tx_queues

struct rte_eth_dev_portconf	default_rxportconf

struct rte_eth_dev_portconf	default_txportconf

uint64_t	dev_capa

struct rte_eth_switch_info	switch_info

uint64_t	reserved_64s [2]

void *	reserved_ptrs [2]

Detailed Description

A structure used to retrieve the contextual information of an Ethernet device, such as the controlling driver of the device, etc...

Examples:: examples/bond/main.c, examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/ethtool/lib/rte_ethtool.c, examples/eventdev_pipeline/pipeline_worker_generic.c, examples/eventdev_pipeline/pipeline_worker_tx.c, examples/flow_classify/flow_classify.c, examples/flow_filtering/main.c, examples/ioat/ioatfwd.c, examples/ip_fragmentation/main.c, examples/ip_pipeline/kni.c, examples/ip_pipeline/link.c, examples/ip_reassembly/main.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipsec-secgw/ipsec.c, examples/ipsec-secgw/sa.c, examples/ipv4_multicast/main.c, examples/kni/main.c, examples/l2fwd-crypto/main.c, examples/l2fwd-event/l2fwd_common.c, examples/l2fwd-jobstats/main.c, examples/l2fwd-keepalive/main.c, examples/l2fwd/main.c, examples/l3fwd-acl/main.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, examples/l3fwd/l3fwd_event.c, examples/l3fwd/main.c, examples/link_status_interrupt/main.c, examples/multi_process/symmetric_mp/main.c, examples/ntb/ntb_fwd.c, examples/packet_ordering/main.c, examples/performance-thread/l3fwd-thread/main.c, examples/pipeline/obj.c, examples/ptpclient/ptpclient.c, examples/qos_meter/main.c, examples/qos_sched/init.c, examples/rxtx_callbacks/main.c, examples/server_node_efd/server/init.c, examples/skeleton/basicfwd.c, examples/vhost/main.c, examples/vm_power_manager/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1530 of file rte_ethdev.h.

Field Documentation

◆ driver_name

const char* driver_name

Generic device information Device Driver name.

Examples:: examples/ethtool/lib/rte_ethtool.c.

Definition at line 1532 of file rte_ethdev.h.

◆ if_index

unsigned int if_index

Index to bound host interface, or 0 if none. Use if_indextoname() to translate into an interface name.

Definition at line 1533 of file rte_ethdev.h.

◆ min_mtu

uint16_t min_mtu

Minimum MTU allowed

Examples:: examples/kni/main.c.

Definition at line 1535 of file rte_ethdev.h.

◆ max_mtu

uint16_t max_mtu

Maximum MTU allowed

Examples:: examples/kni/main.c.

Definition at line 1536 of file rte_ethdev.h.

◆ dev_flags

const uint32_t* dev_flags

Device flags

Definition at line 1537 of file rte_ethdev.h.

◆ min_rx_bufsize

uint32_t min_rx_bufsize

Minimum size of RX buffer.

Definition at line 1538 of file rte_ethdev.h.

◆ max_rx_pktlen

uint32_t max_rx_pktlen

Maximum configurable length of RX pkt.

Definition at line 1539 of file rte_ethdev.h.

◆ max_lro_pkt_size

uint32_t max_lro_pkt_size

Maximum configurable size of LRO aggregated packet.

Definition at line 1541 of file rte_ethdev.h.

◆ max_rx_queues

uint16_t max_rx_queues

Maximum number of RX queues.

Examples:: examples/ipsec-secgw/ipsec-secgw.c, examples/l3fwd/main.c, examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1542 of file rte_ethdev.h.

◆ max_tx_queues

uint16_t max_tx_queues

Maximum number of TX queues.

Examples:: examples/ipsec-secgw/ipsec-secgw.c, and examples/vmdq/main.c.

Definition at line 1543 of file rte_ethdev.h.

◆ max_mac_addrs

uint32_t max_mac_addrs

Maximum number of MAC addresses.

Definition at line 1544 of file rte_ethdev.h.

◆ max_vfs

uint16_t max_vfs

Maximum number of hash MAC addresses for MTA and UTA. Maximum number of VFs.

Examples:: examples/ethtool/lib/rte_ethtool.c.

Definition at line 1547 of file rte_ethdev.h.

◆ max_vmdq_pools

uint16_t max_vmdq_pools

Maximum number of VMDq pools.

Examples:: examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1548 of file rte_ethdev.h.

◆ rx_seg_capa

struct rte_eth_rxseg_capa rx_seg_capa

Segmentation capability.

Definition at line 1549 of file rte_ethdev.h.

◆ rx_offload_capa

uint64_t rx_offload_capa

All RX offload capabilities including all per-queue ones

Examples:: examples/eventdev_pipeline/pipeline_worker_generic.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipsec-secgw/sa.c, examples/ptpclient/ptpclient.c, and examples/rxtx_callbacks/main.c.

Definition at line 1550 of file rte_ethdev.h.

◆ tx_offload_capa

uint64_t tx_offload_capa

All TX offload capabilities including all per-queue ones

Examples:: examples/bond/main.c, examples/distributor/main.c, examples/eventdev_pipeline/pipeline_worker_generic.c, examples/eventdev_pipeline/pipeline_worker_tx.c, examples/flow_classify/flow_classify.c, examples/flow_filtering/main.c, examples/ioat/ioatfwd.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipsec-secgw/sa.c, examples/kni/main.c, examples/l2fwd-crypto/main.c, examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-acl/main.c, examples/l3fwd/l3fwd_event.c, examples/l3fwd/main.c, examples/multi_process/symmetric_mp/main.c, examples/packet_ordering/main.c, examples/performance-thread/l3fwd-thread/main.c, examples/ptpclient/ptpclient.c, examples/qos_meter/main.c, examples/qos_sched/init.c, examples/rxtx_callbacks/main.c, examples/server_node_efd/server/init.c, examples/skeleton/basicfwd.c, examples/vhost/main.c, examples/vm_power_manager/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1552 of file rte_ethdev.h.

◆ rx_queue_offload_capa

uint64_t rx_queue_offload_capa

Device per-queue RX offload capabilities.

Definition at line 1554 of file rte_ethdev.h.

◆ tx_queue_offload_capa

uint64_t tx_queue_offload_capa

Device per-queue TX offload capabilities.

Definition at line 1556 of file rte_ethdev.h.

◆ reta_size

uint16_t reta_size

Device redirection table size, the total number of entries.

Definition at line 1558 of file rte_ethdev.h.

◆ hash_key_size

uint8_t hash_key_size

Hash key size in bytes

Definition at line 1560 of file rte_ethdev.h.

◆ flow_type_rss_offloads

uint64_t flow_type_rss_offloads

Bit mask of RSS offloads, the bit offset also means flow type

Examples:: examples/bond/main.c, examples/distributor/main.c, examples/eventdev_pipeline/pipeline_worker_generic.c, examples/eventdev_pipeline/pipeline_worker_tx.c, examples/ioat/ioatfwd.c, examples/ipsec-secgw/ipsec-secgw.c, examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-acl/main.c, examples/l3fwd/l3fwd_event.c, examples/l3fwd/main.c, examples/multi_process/symmetric_mp/main.c, examples/ntb/ntb_fwd.c, examples/performance-thread/l3fwd-thread/main.c, examples/qos_meter/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1562 of file rte_ethdev.h.

◆ default_rxconf

◆ default_txconf

struct rte_eth_txconf default_txconf

Default TX configuration

Examples:: examples/bond/main.c, examples/distributor/main.c, examples/eventdev_pipeline/pipeline_worker_generic.c, examples/eventdev_pipeline/pipeline_worker_tx.c, examples/flow_classify/flow_classify.c, examples/flow_filtering/main.c, examples/ioat/ioatfwd.c, examples/ipsec-secgw/ipsec-secgw.c, examples/kni/main.c, examples/l2fwd-crypto/main.c, examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-acl/main.c, examples/l3fwd/l3fwd_event.c, examples/l3fwd/main.c, examples/multi_process/symmetric_mp/main.c, examples/ntb/ntb_fwd.c, examples/packet_ordering/main.c, examples/performance-thread/l3fwd-thread/main.c, examples/ptpclient/ptpclient.c, examples/qos_meter/main.c, examples/rxtx_callbacks/main.c, examples/server_node_efd/server/init.c, examples/skeleton/basicfwd.c, examples/vhost/main.c, examples/vm_power_manager/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1564 of file rte_ethdev.h.

◆ vmdq_queue_base

uint16_t vmdq_queue_base

First queue ID for VMDQ pools.

Examples:: examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1565 of file rte_ethdev.h.

◆ vmdq_queue_num

uint16_t vmdq_queue_num

Queue number for VMDQ pools.

Examples:: examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1566 of file rte_ethdev.h.

◆ vmdq_pool_base

uint16_t vmdq_pool_base

First ID of VMDQ pools.

Examples:: examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 1567 of file rte_ethdev.h.

◆ rx_desc_lim

struct rte_eth_desc_lim rx_desc_lim

RX descriptors limits

Examples:: examples/ethtool/ethtool-app/main.c, and examples/ethtool/lib/rte_ethtool.c.

Definition at line 1568 of file rte_ethdev.h.

◆ tx_desc_lim

struct rte_eth_desc_lim tx_desc_lim

TX descriptors limits

Examples:: examples/ethtool/ethtool-app/main.c, and examples/ethtool/lib/rte_ethtool.c.

Definition at line 1569 of file rte_ethdev.h.

◆ speed_capa

uint32_t speed_capa

Supported speeds bitmap (ETH_LINK_SPEED_).

Definition at line 1570 of file rte_ethdev.h.

◆ nb_rx_queues

uint16_t nb_rx_queues

Configured number of rx/tx queues Number of RX queues.

Examples:: examples/ipsec-secgw/ipsec.c.

Definition at line 1572 of file rte_ethdev.h.

◆ nb_tx_queues

uint16_t nb_tx_queues

Number of TX queues.

Definition at line 1573 of file rte_ethdev.h.

◆ default_rxportconf

struct rte_eth_dev_portconf default_rxportconf

Rx parameter recommendations

Definition at line 1575 of file rte_ethdev.h.

◆ default_txportconf

struct rte_eth_dev_portconf default_txportconf

Tx parameter recommendations

Definition at line 1577 of file rte_ethdev.h.

◆ dev_capa

uint64_t dev_capa

Generic device capabilities (RTE_ETH_DEV_CAPA_).

Definition at line 1579 of file rte_ethdev.h.

◆ switch_info

struct rte_eth_switch_info switch_info

Switching information for ports on a device with a embedded managed interconnect/switch.

Definition at line 1584 of file rte_ethdev.h.

◆ reserved_64s

uint64_t reserved_64s[2]

Reserved for future fields

Definition at line 1586 of file rte_ethdev.h.

◆ reserved_ptrs

void* reserved_ptrs[2]