#include <rte_ethdev.h>

Data Fields
struct rte_device *	device

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

uint32_t	max_hash_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

uint16_t	max_rx_mempools

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

enum rte_eth_err_handle_mode	err_handle_mode

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/dma/dmafwd.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/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/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-graph/main.c, examples/l3fwd-power/main.c, examples/l3fwd/l3fwd_em.c, examples/l3fwd/l3fwd_event.c, examples/l3fwd/l3fwd_fib.c, examples/l3fwd/l3fwd_lpm.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/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 1716 of file rte_ethdev.h.

Field Documentation

◆ device

struct rte_device* device

Generic device information

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

Definition at line 1717 of file rte_ethdev.h.

◆ driver_name

const char* driver_name

Device Driver name.

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

Definition at line 1718 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 1719 of file rte_ethdev.h.

◆ min_mtu

uint16_t min_mtu

Minimum MTU allowed

Definition at line 1721 of file rte_ethdev.h.

◆ max_mtu

uint16_t max_mtu

Maximum MTU allowed

Examples: examples/dma/dmafwd.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, and examples/l3fwd/main.c.

Definition at line 1722 of file rte_ethdev.h.

◆ dev_flags

const uint32_t* dev_flags

Device flags

Definition at line 1723 of file rte_ethdev.h.

◆ min_rx_bufsize

uint32_t min_rx_bufsize

Minimum size of Rx buffer.

Definition at line 1724 of file rte_ethdev.h.

◆ max_rx_pktlen

uint32_t max_rx_pktlen

Maximum configurable length of Rx pkt.

Examples: examples/dma/dmafwd.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, and examples/l3fwd/main.c.

Definition at line 1725 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 1727 of file rte_ethdev.h.

◆ max_rx_queues

uint16_t max_rx_queues

Maximum number of Rx queues.

Examples: examples/l3fwd-power/main.c, and examples/l3fwd/main.c.

Definition at line 1728 of file rte_ethdev.h.

◆ max_tx_queues

uint16_t max_tx_queues

Maximum number of Tx queues.

Examples: examples/l3fwd-power/main.c.

Definition at line 1729 of file rte_ethdev.h.

◆ max_mac_addrs

uint32_t max_mac_addrs

Maximum number of MAC addresses.

Definition at line 1730 of file rte_ethdev.h.

◆ max_hash_mac_addrs

uint32_t max_hash_mac_addrs

Maximum number of hash MAC addresses for MTA and UTA.

Definition at line 1732 of file rte_ethdev.h.

◆ max_vfs

uint16_t max_vfs

Maximum number of VFs.

Definition at line 1733 of file rte_ethdev.h.

◆ max_vmdq_pools

uint16_t max_vmdq_pools

Maximum number of VMDq pools.

Definition at line 1734 of file rte_ethdev.h.

◆ rx_seg_capa

struct rte_eth_rxseg_capa rx_seg_capa

Segmentation capability.

Definition at line 1735 of file rte_ethdev.h.

◆ rx_offload_capa

uint64_t rx_offload_capa

All Rx offload capabilities including all per-queue ones

Examples: examples/l3fwd-power/main.c.

Definition at line 1737 of file rte_ethdev.h.

◆ tx_offload_capa

uint64_t tx_offload_capa

All Tx offload capabilities including all per-queue ones

Examples: examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, examples/l3fwd/main.c, examples/skeleton/basicfwd.c, and examples/vm_power_manager/main.c.

Definition at line 1739 of file rte_ethdev.h.

◆ rx_queue_offload_capa

uint64_t rx_queue_offload_capa

Device per-queue Rx offload capabilities.

Definition at line 1741 of file rte_ethdev.h.

◆ tx_queue_offload_capa

uint64_t tx_queue_offload_capa

Device per-queue Tx offload capabilities.

Definition at line 1743 of file rte_ethdev.h.

◆ reta_size

uint16_t reta_size

Device redirection table size, the total number of entries.

Definition at line 1745 of file rte_ethdev.h.

◆ hash_key_size

uint8_t hash_key_size

Hash key size in bytes

Definition at line 1746 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/dma/dmafwd.c, examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, and examples/l3fwd/main.c.

Definition at line 1748 of file rte_ethdev.h.

◆ default_rxconf

struct rte_eth_rxconf default_rxconf

Default Rx configuration

Examples: examples/dma/dmafwd.c, examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, and examples/l3fwd/main.c.

Definition at line 1749 of file rte_ethdev.h.

◆ default_txconf

struct rte_eth_txconf default_txconf

Default Tx configuration

Examples: examples/dma/dmafwd.c, examples/l2fwd-event/l2fwd_common.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, examples/l3fwd/main.c, examples/skeleton/basicfwd.c, and examples/vm_power_manager/main.c.

Definition at line 1750 of file rte_ethdev.h.

◆ vmdq_queue_base

uint16_t vmdq_queue_base

First queue ID for VMDq pools.

Definition at line 1751 of file rte_ethdev.h.

◆ vmdq_queue_num

uint16_t vmdq_queue_num

Queue number for VMDq pools.

Definition at line 1752 of file rte_ethdev.h.

◆ vmdq_pool_base

uint16_t vmdq_pool_base

First ID of VMDq pools.

Definition at line 1753 of file rte_ethdev.h.

◆ rx_desc_lim

struct rte_eth_desc_lim rx_desc_lim

Rx descriptors limits

Definition at line 1754 of file rte_ethdev.h.

◆ tx_desc_lim

struct rte_eth_desc_lim tx_desc_lim

Tx descriptors limits

Definition at line 1755 of file rte_ethdev.h.

◆ speed_capa

uint32_t speed_capa

Supported speeds bitmap (RTE_ETH_LINK_SPEED_).

Definition at line 1756 of file rte_ethdev.h.

◆ nb_rx_queues

uint16_t nb_rx_queues

Configured number of Rx/Tx queues Number of Rx queues.

Definition at line 1758 of file rte_ethdev.h.

◆ nb_tx_queues

uint16_t nb_tx_queues

Number of Tx queues.

Definition at line 1759 of file rte_ethdev.h.

◆ max_rx_mempools

uint16_t max_rx_mempools

Maximum number of Rx mempools supported per Rx queue.

Value greater than 0 means that the driver supports Rx queue mempools specification via rx_conf->rx_mempools.

Definition at line 1766 of file rte_ethdev.h.

◆ default_rxportconf

struct rte_eth_dev_portconf default_rxportconf

Rx parameter recommendations

Definition at line 1768 of file rte_ethdev.h.

◆ default_txportconf

struct rte_eth_dev_portconf default_txportconf

Tx parameter recommendations

Definition at line 1770 of file rte_ethdev.h.

◆ dev_capa

uint64_t dev_capa

Generic device capabilities (RTE_ETH_DEV_CAPA_).

Definition at line 1772 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 1777 of file rte_ethdev.h.

◆ err_handle_mode

enum rte_eth_err_handle_mode err_handle_mode

Supported error handling mode.

Definition at line 1779 of file rte_ethdev.h.

◆ reserved_64s

uint64_t reserved_64s[2]

Reserved for future fields

Definition at line 1781 of file rte_ethdev.h.

◆ reserved_ptrs

void* reserved_ptrs[2]