rhashtable_remove_fast(9)

📦 version 7.3.1, in nixpkgs unstable

💅 rhashtable_remove_fast — like, the Kernel API Manual page you actually wanna read

okay so bestie, welcome to the Kernel API Manual entry for rhashtable_remove_fast(9) — the one where we yeet an object OUT of a hash table. yes, that's the whole vibe. let's get into it 🎀

✨ NAME ✨

rhashtable_remove_fast — remove object from hash table

no cap, that's it. it removes objects from hash tables. the main character of today's episode 💅

🌸 SYNOPSIS 🌸

int rhashtable_remove_fast (struct rhashtable *ht , struct rhash_head *obj , const struct rhashtable_params params );

look at her. three params, one int return, zero drama (okay, minor drama, see below) ✨

🦋 ARGUMENTS 🦋

  • ht — the hash table. the whole vibe. the bucket-holding queen herself 👑
  • obj — pointer to hash head inside object. not the object itself, bestie — the struct rhash_head inside it. read that twice, iykyk 🙈
  • params — hash table parameters. the settings. the config. the ~preferences~ 🎀

💖 DESCRIPTION 💖

so here's the tea, and it's kind of a big deal: the hash chain is single linked. one-way. no going back. which means when you remove something, it has to walk the bucket chain to find it first 😭

and because of that walk? the removal operation is considerable slow if the hash table is not correctly sized. fr fr. size your table right or you're gonna have a bad time. it's giving "oops my bucket chain is a whole novel" energy 💀

the good news tho: it will automatically shrink the table if permitted, when residency drops below 30%. self-care!! the table literally declutters itself 🧚✨

returns zero on success, and -ENOENT if the entry could not be found. that's it. that's the return value lore 🍓

lowkey important: if you're seeing slow removals, that's not the table being mean, that's the table being undersized. check your sizing before you blame the kernel, bestie 🫶

🔥 SEE ALSO 🔥

okay this list is LONG and honestly iconic — we're shouting out the whole rhashtable family reunion 👑

like, go read all of them. or don't. but they're there 💜

aaaand that's a wrap!! this page lives at ./include/linux, stamped October 2026, and it's literally called rhashtable_remove_fast(9) — so next time your bucket chain is too long, you know who to call 🦋✨ periodt 💅

📦 where this page comes from