rte_hash_rcu_config(3)

πŸ“¦ version 26.03, in nixos 26.05, nixpkgs unstable

✨ rte_hash_rcu_config(3) ✨

okay so bestie, this page is from the Library Functions Manual and it's literally all about one struct πŸ’… β€” the config for your HASH RCU QSBR setup. buckle up, it's giving "short but every field matters" energy πŸŽ€


🌸 NAME 🌸

rte_hash_rcu_config β€” the struct itself, main character of this whole page πŸ‘‘


πŸ¦‹ SYNOPSIS πŸ¦‹

first things first, you gotta pull in the header:

#include <rte_hash.h>

then meet the data fields, aka the whole cast 🫢

struct rte_rcu_qsbr * v
enum rte_hash_qsbr_mode mode
uint32_t dq_size
uint32_t trigger_reclaim_limit
uint32_t max_reclaim_size
void * key_data_ptr
rte_hash_free_key_data free_key_data_func

πŸ’– DESCRIPTION πŸ’–

so this is the HASH RCU QSBR configuration structure β€” that's it, that's the vibe ✨ it's the struct you hand over to configure how RCU QSBR behaves for your hash table.

fr fr, it's defined at line 102 of file rte_hash.h β€” go look, it's right there 🧚

πŸ”₯ FIELD DOCUMENTATION πŸ”₯

🌈 struct rte_rcu_qsbr* v

your RCU QSBR variable. that's the whole thing, no notes πŸ’€

defined at line 103 of file rte_hash.h.

🌈 enum rte_hash_qsbr_mode mode

the mode of RCU QSBR. the RTE_HASH_QSBR_MODE_xxx value '0' is the default β€” and what it does is create a defer queue for reclaim πŸ‘‘ lowkey the important one.

defined at line 104 of file rte_hash.h.

🌈 uint32_t dq_size

RCU defer queue size. default is literally total hash table entries β€” yes, the whole thing πŸ“

defined at line 108 of file rte_hash.h.

🌈 uint32_t trigger_reclaim_limit

the threshold that triggers auto reclaim ⭐ like, when do we start cleaning up.

defined at line 112 of file rte_hash.h.

🌈 uint32_t max_reclaim_size

max entries to reclaim in one go πŸ’… default is RTE_HASH_RCU_DQ_RECLAIM_MAX.

defined at line 113 of file rte_hash.h.

🌈 void* key_data_ptr

pointer passed to the free function. typically it's the pointer to the data structure that the resource to free (the key-data) belongs to. and yes β€” this can be NULL πŸ™ˆ

defined at line 117 of file rte_hash.h.

🌈 rte_hash_free_key_data free_key_data_func

the function to call to free the resource (key-data). your cleanup bestie 🫢

defined at line 122 of file rte_hash.h.


πŸ’œ AUTHOR πŸ’œ

generated automatically by Doxygen for DPDK from the source code β€” not me, not you, the robot did it πŸ€–βœ¨


and that's the page!! no cap, every field accounted for πŸ˜­πŸ’–

sign-off szn πŸŽ€ β€” this lovely little page is DPDK, Version 26.03.0, and it lives under the rte_hash_rcu_config(3) name forever. bye bestie, go configure some RCU πŸ¦‹πŸ’…

πŸ“¦ where this page comes from