rte_eth_conf(3)

📦 version 26.03, in nixos 26.05, nixpkgs unstable

💖 rte_eth_conf 💖

okay bestie, welcome to the rte_eth_conf(3) page from the Library Functions Manual ✨ this is the struct situation for configuring an Ethernet port, and yes, we are going to go through every single field like the responsible Unix girlies we are 💅

🌸 NAME 🌸

rte_eth_conf — the structure used to configure an Ethernet port 🦋

✨ SYNOPSIS ✨

#include <rte_ethdev.h>

   Data Fields
       uint32_t link_speeds
       struct rte_eth_rxmode rxmode
       struct rte_eth_txmode txmode
       uint32_t lpbk_mode
       struct {
          struct rte_eth_rss_conf rss_conf
          struct rte_eth_vmdq_dcb_conf vmdq_dcb_conf
          struct rte_eth_dcb_rx_conf dcb_rx_conf
          struct rte_eth_vmdq_rx_conf vmdq_rx_conf
       } rx_adv_conf
       union {
          struct rte_eth_vmdq_dcb_tx_conf vmdq_dcb_tx_conf
          struct rte_eth_dcb_tx_conf dcb_tx_conf
          struct rte_eth_vmdq_tx_conf vmdq_tx_conf
       } tx_adv_conf
       uint32_t dcb_capability_en
       struct rte_eth_intr_conf intr_conf

🦋 Detailed Description 🦋

So this is A structure used to configure an Ethernet port. Depending upon the Rx multi-queue mode, extra advanced configuration settings may be needed. That's the whole vibe: basic config lives here, and sometimes the advanced settings need to come out to play too 💖

Definition at line 1542 of file rte_ethdev.h.

💅 Field Documentation 💅

okay, field-by-field, no skips, no "we'll come back to it" energy — we are doing this properly 🎀

bitmap of RTE_ETH_LINK_SPEED_XXX of speeds to be used. RTE_ETH_LINK_SPEED_FIXED disables link autonegotiation, and a unique speed shall be set. Otherwise, the bitmap defines the set of speeds to be advertised. If the special value RTE_ETH_LINK_SPEED_AUTONEG (0) is used, all speeds supported are advertised. slay, but read that carefully 👑

Definition at line 1543 of file rte_ethdev.h.

struct rte_eth_rxmode rxmode

Port Rx configuration. the receive-side main character energy 🫶

Definition at line 1550 of file rte_ethdev.h.

struct rte_eth_txmode txmode

Port Tx configuration. transmit side, matching energy ✨

Definition at line 1551 of file rte_ethdev.h.

uint32_t lpbk_mode

Loopback operation mode. By default the value is 0, meaning the loopback mode is disabled. Read the datasheet of given Ethernet controller for details. The possible values of this field are defined in implementation of each driver. no cap, this one is driver-dependent so don't just freestyle it 😭

Definition at line 1552 of file rte_ethdev.h.

struct rte_eth_rss_conf rss_conf

Port RSS configuration. this one lives inside rx_adv_conf in the synopsis, and the page lists it here first — we're keeping that exact order, bestie 💅

Definition at line 1558 of file rte_ethdev.h.

struct rte_eth_vmdq_dcb_conf vmdq_dcb_conf

Port VMDq+DCB configuration. also chillin' inside rx_adv_conf in the synopsis 🌸

Definition at line 1560 of file rte_ethdev.h.

struct rte_eth_dcb_rx_conf dcb_rx_conf

Port DCB Rx configuration. yep, another rx_adv_conf resident 🦋

Definition at line 1562 of file rte_ethdev.h.

struct rte_eth_vmdq_rx_conf vmdq_rx_conf

Port VMDq Rx configuration. last of the Rx advanced crew listed before the wrapper 🎀

Definition at line 1564 of file rte_ethdev.h.

struct { ... } rx_adv_conf

Port Rx filtering configuration. this is the struct wrapper for the advanced Rx fields above; the page lists it after them, so we're keeping that exact order 💖

struct rte_eth_vmdq_dcb_tx_conf vmdq_dcb_tx_conf

Port VMDq+DCB Tx configuration. transmit-side advanced business 🔥

Definition at line 1568 of file rte_ethdev.h.

struct rte_eth_dcb_tx_conf dcb_tx_conf

Port DCB Tx configuration. yes ma'am 💅

Definition at line 1570 of file rte_ethdev.h.

struct rte_eth_vmdq_tx_conf vmdq_tx_conf

Port VMDq Tx configuration. the last Tx advanced field listed before the union wrapper ✨

Definition at line 1572 of file rte_ethdev.h.

union { ... } tx_adv_conf

Port Tx DCB configuration (union). okay union icon behavior 👑

uint32_t dcb_capability_en

Currently, Priority Flow Control (PFC) are supported, if DCB with PFC is needed, and the variable must be set RTE_ETH_DCB_PFC_SUPPORT. that's a must-set, not a maybe-set, bestie 💀

Definition at line 1576 of file rte_ethdev.h.

struct rte_eth_intr_conf intr_conf

Interrupt mode configuration. interrupts said "notice me" 🫶

Definition at line 1577 of file rte_ethdev.h.

👑 Author 👑

Generated automatically by Doxygen for DPDK from the source code.

okay that's the whole page, bestie — signing off with the footer energy from DPDK, Version 26.03.0, page rte_eth_conf(3) 💖 the footer doesn't hand us a date so I'm not inventing one, periodt 🫶✨

📦 where this page comes from