PMEMPOOL_RM(3)

✨ NAME ✨

pmempool_rm() — bestie, this is the one that removes a persistent memory pool 💅 like it literally deletes the whole thing, no takebacks

---

🌸 SYNOPSIS 🌸

#include <libpmempool.h>

int pmempool_rm(const char *path, int flags);

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — pmempool_rm() removes the pool that path is pointing at. and path is flexible like that, it can point to a:

• regular file
• device dax
• pool set file

and if path happens to be a pool set file?? 👀 then pmempool_rm() goes full main character and removes all the part files from replicas using unlink(2) first, and only then removes the pool set file itself. order matters, she's organized like that ✨

the flags argument is what decides how pmempool_rm() behaves, and it's either 0 or the bitwise OR of one or more of these:

• PMEMPOOL_RM_FORCE — ignore literally all errors when removing part files from replicas. no thoughts, head empty, just vibes 🫶
• PMEMPOOL_RM_POOLSET_LOCAL — also remove the local pool set file

---

💖 RETURN VALUE 💖

on success, pmempool_rm() returns 0 — we love a clean win 👑

on error, it returns -1 and sets errno accordingly 😭 so like, check that.

---

🎀 SEE ALSO 🎀

unlink(3), libpmemobj(7) and <https://pmem.io>

---

ngl this is a delete function, bestie. it removes stuff. for real for real. read twice, run once 💀

this lil page came from the PMDK Programmer's Manual, dated 2025-07-24 — mwah, sending it off with a kiss 🧚💜