qpool_create(3)

🦋 NAME 🦋

okay bestie, gather round, because this page is all about qpool_create — it allocates a distributed memory pool ✨. that's the whole job. she's a builder, she sets up the vibe, and she hands you back a pool. periodt.

💅 SYNOPSIS 💅

so like, first you gotta pull in the header, obviously:

#include <qthread/qpool.h>

and then here's the two glow-ups she comes in:

qpool *
qpool_create (const size_t item_size);

qpool *
qpool_create_aligned (const size_t item_size, const size_t alignment);

two icons, one family. pick your fighter 🫶

🎀 DESCRIPTION 🎀

okay so these functions initialize qpool distributed memory pools. that's the whole mission statement, no cap. you call one, it spins you up a pool, you go live your life 💖.

and then there's qpool_create_aligned(), which is the extra one of the two. the way that she works is she lets you specify the alignment — so every single allocated element will align along specific alignment boundaries. very particular, very demure, she knows what she wants 💅.

one lil thing you gotta respect: the alignment value is expected to be a power of two. that's not a suggestion bestie, that's the assignment. give her a power of two and she's happy 🌸.

no drama here, just: header in, pool out, alignment on fleek if you want it. slay.

🌈 SEE ALSO 🌈

• qpool_destroy(3) — the breakup arc 💔
• qpool_alloc(3) — where you actually get your stuff 🍓
• qpool_free(3) — giving it back, we love a responsible queen 👑

and that's the whole page, bestie, you ate 🫶 this lil gem is from the libqthread manual and it's been sitting pretty since MAY 2009 ⭐ no notes, iconic behavior, go make some pools 💖✨