rte_eth_vmdq_rx_conf(3)

📦 version 26.03, in nixos 26.05, nixpkgs unstable

💖 NAME 💖

rte_eth_vmdq_rx_conf — hi bestie, welcome to the rte_eth_vmdq_rx_conf(3) page from the Library Functions Manual. It's literally the struct for configuring the VMDq feature of an Ethernet port when it's not combined with the DCB feature. Iconic config energy, let's go. 🫶

✨ SYNOPSIS ✨

#include <rte_ethdev.h>

🧚 Data Fields 🧚

  • enum rte_eth_nb_pools nb_queue_pools
  • uint8_t enable_default_pool
  • uint8_t default_pool
  • uint8_t enable_loop_back
  • uint8_t nb_pool_maps
  • uint32_t rx_mode
  • and the anonymous struct situation, which is exactly this:
struct {
   uint16_t vlan_id
   uint64_t pools
} pool_map [RTE_ETH_VMDQ_MAX_VLAN_FILTERS]

🔥 DETAILED DESCRIPTION 🔥

Okay so this is a structure used to configure the VMDq feature of an Ethernet port when not combined with the DCB feature. Main character config behavior, no cap.

Using this feature, packets are routed to a pool of queues. By default, the pool selection is based on the MAC address, the VLAN ID in the VLAN tag as specified in the pool_map array. Passing the RTE_ETH_VMDQ_ACCEPT_UNTAG in the rx_mode field allows pool selection using only the MAC address. MAC address to pool mapping is done using the rte_eth_dev_mac_addr_add function, with the pool parameter corresponding to the pool ID. Obsessed with a clean mapping, honestly.

Queue selection within the selected pool will be done using RSS when it is enabled or revert to the first queue of the pool if not. That's the whole rule, periodt.

A default pool may be used, if desired, to route all traffic which does not match the VLAN filter rules or any pool MAC address.

Definition at line 1025 of file rte_ethdev.h.

🎀 FIELD DOCUMENTATION 🎀

💅 enum rte_eth_nb_pools nb_queue_pools

VMDq only mode, 8 or 64 pools.

Definition at line 1026 of file rte_ethdev.h.

🫶 uint8_t enable_default_pool

If non-zero, use a default pool.

Definition at line 1027 of file rte_ethdev.h.

🦋 uint8_t default_pool

The default pool, if applicable.

Definition at line 1028 of file rte_ethdev.h.

🍓 uint8_t enable_loop_back

Enable VT loop back.

Definition at line 1029 of file rte_ethdev.h.

🌸 uint8_t nb_pool_maps

We can have up to 64 filters/mappings.

Definition at line 1030 of file rte_ethdev.h.

⭐ uint32_t rx_mode

Flags from RTE_ETH_VMDQ_ACCEPT_*.

Definition at line 1031 of file rte_ethdev.h.

🧚 uint16_t vlan_id

The VLAN ID of the received frame.

Definition at line 1033 of file rte_ethdev.h.

👑 uint64_t pools

Bitmask of pools for packet Rx.

Definition at line 1034 of file rte_ethdev.h.

🎀 struct { ... } pool_map[RTE_ETH_VMDQ_MAX_VLAN_FILTERS]

VMDq VLAN pool maps.

🌈 AUTHOR 🌈

Generated automatically by Doxygen for DPDK from the source code.

Cute sign-off 💖: source/version is DPDK Version 26.03.0, and the manual page is rte_eth_vmdq_rx_conf(3). Date check: the original footer doesn't stamp a separate date, so I'm not inventing one — just the version, and that's periodt. 🎀

📦 where this page comes from