sem_unlink(3)

✨ NAME ✨

okay so bestie, meet sem_unlink — the function that removes a named semaphore. that's it, that's the whole job description 💅

📚 LIBRARY 📚

she lives in the POSIX threads library — that's libpthread, and when you're compiling you link her in with -lpthread. no cap.

🌸 SYNOPSIS 🌸

#include <semaphore.h>

int sem_unlink(const char *name);

---

💖 DESCRIPTION 💖

so like, sem_unlink() removes the named semaphore that name is pointing at. and the way she does it? the semaphore name gets removed immediately — instantly, no waiting around, main character energy fr fr.

but here's the part that's giving ✨actual OS behavior✨: the semaphore itself isn't fully gone just because the name dipped. the semaphore gets destroyed only once all the other processes that have it open have closed it. so it's like, she leaves the group chat but the chat history stays until everybody else leaves too 😭 iconic tbh.

💅 RETURN VALUE 💅

• all good? she returns 0. slay.
• something went wrong? she returns -1, and errno gets set to tell you exactly what the drama was.

😭 ERRORS 😭

• EACCES — bestie you don't have permission to unlink this semaphore. not your house, not your rules 🙈
• ENAMETOOLONG — name was too long. girl, that name was doing the most, she could not fit.
• ENOENT — there is no semaphore with the given name. you're looking for something that literally does not exist 💀

🎀 ATTRIBUTES 🎀

the whole rundown of what these terms even mean lives in attributes(7) — go peek if you're curious 🦋

so for this one:

• Interface: sem_unlink()
• Attribute: Thread safety
• Value: MT-Safe

translation: MT-Safe means she's multithread-safe, and yes that's a flex 💪

👑 STANDARDS 👑

POSIX.1-2008. periodt.

🦋 HISTORY 🦋

she's been around since POSIX.1-2001. a true veteran, an OG, we stan a legacy queen ⭐

🌈 SEE ALSO 🌈

• sem_getvalue(3)
• sem_open(3)
• sem_post(3)
• sem_wait(3)
• sem_overview(7)

---

💌 and that's the whole page bestie! go forth and unlink responsibly 🫶

Linux man-pages 6.20 · 2026-02-08 — mwah, ty for reading, ily, bye 💖✨🎀