qpool_free(3)

📦 version 1.22^20251007gitcedb1fc, in fedora 43, fedora 44

💖 qpool_free — the libqthread girlies' guide to giving memory back 💖

okay bestie, so this page is qpool_free(3) from the libqthread manual, and it's literally the moment where you hand a memory block back to the pool it came from. no cap, it's short, but it's important, so let's get into it. 🫶

✨ SYNOPSIS ✨

#include <qthread/qpool.h>

void
qpool_free (qpool *restrict pool, void *restrict mem);

that's it. that's the whole vibe. two pointers, one function, zero drama. 💅

🦋 DESCRIPTION 🦋

so what this function does is: it takes a block of memory (mem) and returns it to its distributed memory pool (pool). giving it back, handing it over, returning it home. it's giving "reunited and it feels so good". 🎀

and here's the thing, the one rule you cannot break, bestie:

This memory must have originated in that pool. like, it has to be from there. that's the whole contract. no bringing random memory to a pool party it wasn't invited to. 🙈

so if mem came from some other pool, or from nowhere in particular, that's not this function's moment. it came from the pool, it goes back to the pool. periodt. 👑

🌸 SEE ALSO 🌸

the whole friend group, in order:

qpool_alloc(3) is the one that gives you the memory in the first place (iykyk), qpool_create(3) makes the pool, and qpool_destroy(3) is the finale. this one right here is the little handoff in the middle. ✨

okay and one last thing before you go, the official receipts: this page lives in libqthread, and it's dated APRIL 2011. iconic, historic, still out here helping girlies free their memory blocks. mwah. 💋 💜

📦 where this page comes from