rte_eth_rss_conf(3)

📦
version 25.11.3 · 9 versions
, in ubuntu resolute, ubuntu stonking

✨ NAME ✨

rte_eth_rss_conf — bestie, this is a struct, it lives in the rte_eth_rss_conf(3) page of the library functions manual, and it's the lil' bundle of settings that tells an Ethernet port how to do its RSS thing 💅

🌸 SYNOPSIS 🌸

#include <rte_ethdev.h>

🎀 Data Fields 🎀

  • uint8_t * rss_key
  • uint8_t rss_key_len
  • uint64_t rss_hf
  • enum rte_eth_hash_function algorithm

💖 Detailed Description 💖

Okay so picture this: this struct is the glow-up kit for configuring the Receive Side Scaling (aka RSS) feature on an Ethernet port. That's the whole job. That's the assignment. 🫶

Defined at line 522 of the file rte_ethdev.h.

👑 Field Documentation 👑

🦋 uint8_t* rss_key

When you're in rte_eth_dev_rss_hash_conf_get(), the rss_key_len needs to be greater than or equal to the hash_key_size that you got from the rte_eth_dev_info_get() API. And the rss_key should hold at least hash_key_size bytes. Not me being dramatic but — if you don't meet these requirements, the query result is unreliable, even if the operation returns success. Like it'll look fine and lie to your face 😭

Now for rte_eth_dev_rss_hash_update() or rte_eth_dev_configure(): if rss_key is not NULL, then rss_key_len tells you the length of the rss_key in bytes, and it should be equal to hash_key_size. And if rss_key is NULL? Drivers are free to use a random key or a default key. Their choice, their era. ✨

Defined at line 535 of the file rte_ethdev.h.

💜 uint8_t rss_key_len

Hash key length, in bytes. That's it, that's the vibe. 📏

Defined at line 536 of the file rte_ethdev.h.

🌈 uint64_t rss_hf

This one tells you the type of packets — or the specific part of packets — that RSS hashing is gonna be applied to. Gatekeeping which traffic gets hashed, basically. 🔥

Defined at line 541 of the file rte_ethdev.h.

🍓 enum rte_eth_hash_function algorithm

The hash algorithm. The secret sauce. The whole point. ⭐

Defined at line 542 of the file rte_ethdev.h.

🧚 Author 🧚

Generated automatically by Doxygen for DPDK from the source code. (Not a human, just a robot doing its little automatic thing and honestly? slay 🤖💖)

and that's the page, bestie — no cap, that's genuinely everything it says 🌸

That's the rte_eth_rss_conf(3) page from DPDK Version 25.11.3, mwah, hope this helped, go configure that RSS periodt 💅✨

📦 where this page comes from