mempool_create_node(9)

💖 mempool_create_node(9) 💖

so this is a page from the Kernel API Manual, bestie — it's mempool_create_node, and it's literally the glow-up version of "make me a memory pool, but on this specific NUMA node." let's get into it ✨

---

🌸 NAME 🌸

mempool_create_node — create a memory pool 🫶

---

🎀 SYNOPSIS 🎀

struct mempool * mempool_create_node (int min_nr , mempool_alloc_t
*alloc_fn , mempool_free_t *free_fn , void *pool_data , gfp_t gfp_mask ,
int node_id );

like, six args, no cap. keep them exactly like that 💅

---

✨ ARGUMENTS ✨

• min_nr — the minimum number of elements that are guaranteed to be allocated for this pool. it's the floor, the bare minimum, the "at least this many, periodt" 💖
• alloc_fn — your very own user-defined element-allocation function. you bring the function, the kernel brings the vibes 🔥
• free_fn — your very own user-defined element-freeing function. the matching pair to alloc_fn, iykyk 🦋
• pool_data — optional private data that gets handed to your user-defined functions. optional! but like, sometimes you need it 🌸
• gfp_mask — the memory allocation flags. the whole personality of the allocation, honestly ⭐
• node_id — the numa node to allocate on. location, location, location 👑

---

🧚 DESCRIPTION 🧚

okay so this function creates and allocates a guaranteed-size, preallocated memory pool. yes — guaranteed size, already preallocated, no surprises 💅 the pool is then usable from the mempool_alloc and mempool_free functions.

important vibe check: this function might sleep. 😴 and it's not just her — both alloc_fn and free_fn might sleep too, and that's fine, as long as the mempool_alloc function is not called from IRQ contexts. so like, IRQ context? not the moment, bestie 🙈

---

🌈 RETURN 🌈

a pointer to the created memory pool object — or NULL on error. so like, always check, fr fr 😭

---

💜 SEE ALSO 💜

• the kernel file ./mm/mempool.c — the source of truth 🍓
• mempool_exit(9)
• mempool_destroy(9)
• mempool_init(9)
• mempool_resize(9)
• mempool_alloc_bulk(9)
• mempool_alloc(9)
• mempool_alloc_preallocated(9)
• mempool_free_bulk(9)
• mempool_free(9)

---

and that's the whole page, bestie 🎀 this one lives in ./mm, dated October 2026, under the mempool_create_node(9) title — iconic, no notes 💖✨🦋