objpool_fini(9)

✨ objpool_fini(9) ✨

okay so this page comes from the Kernel API Manual, and it's all about objpool_fini — the deref-the-object-pool era. bestie, let's get into it 💅

---

🌸 NAME 🌸

objpool_fini — deref object pool (also releasing unused objects) 🫶

✨ SYNOPSIS ✨

void objpool_fini (struct objpool_head *pool );

🎀 ARGUMENTS 🎀

• pool — the object pool to be dereferenced. that's the whole argument, no cap 💖

💅 DESCRIPTION 💅

okay so here's the vibe: objpool_fini is gonna try to release all remained free objects, and then it drops an extra reference of the objpool. that's the main character move ✨

If all objects are already returned to objpool — the so called synchronous use cases — then the objpool itself will be freed together. slay, cleanup complete 🎀

But if there are still outstanding objects — asynchronous use cases, such like blockable kretprobe — the objpool won't be released until all the outstanding objects are dropped. not me warning you: the caller must assure there are no concurrent objpool_push on the fly. 🚨

Normally RCU is being required to make sure all ongoing objpool_push must be finished before calling objpool_fini, so does test_objpool, kretprobe or rethook. so yeah, that's the requirement before you call — iykyk 🦋

🦋 SEE ALSO 🦋

Kernel file ./include/linux/objpool.h is right there, and these are the besties in the same friend group:

• struct objpool_slot(9)
• struct objpool_head(9)
• objpool_init(9)
• objpool_pop(9)
• objpool_push(9)
• objpool_drop(9)
• objpool_free(9)

---

mwah 💋 source/version: ./include/linux; date: October 2026; page: objpool_fini(9) — bye bestie 🫶