PTHREAD_SUSPEND_NP(3)

✨ PTHREAD_SUSPEND_NP ✨

okay so this is a page from the Library Functions Manual, and bestie, we're talking about pthread_suspend_np today — the little function that puts a thread to sleep on purpose 💤 like it's taking a nap mid-group-chat.

---

💖 NAME 💖

pthread_suspend_np — suspend a thread 🫶

---

🎀 LIBRARY 🎀

POSIX Threads Library (libpthread, -lpthread) — that's where she lives, no cap.

---

🌸 SYNOPSIS 🌸

#include <pthread_np.h>

int
pthread_suspend_np(pthread_t tid);

---

🦋 DESCRIPTION 🦋

so like, pthread_suspend_np() is called on an active thread and it literally causes that thread to suspend. like, "girl, take a break" ✋ periodt.

⚠️ okay this part is important so pay attention bestie: it is not safe for the caller of pthread_suspend_np() to use any non-async signal safe functions — except pthread_resume_np(3) — until the suspended thread is resumed. unless, of course, measures are taken to ensure the thread is suspended at a safe point. no cap, this is the scary part 😭 don't just go calling random stuff after suspending a thread, it's giving undefined vibes.

---

🌈 RETURN VALUES 🌈

if it works, pthread_suspend_np() returns 0 — slay 💅 otherwise, an error number comes back at you to indicate the error. rude but okay.

---

🔥 ERRORS 🔥

pthread_suspend_np() will fail if:

• [EDEADLK] — an attempt was made to suspend the current thread 💀 like girl you can't suspend yourself, that's not the vibe, main character energy gone wrong.
• [EINVAL] — the value specified by the tid argument is invalid 🙈 not a real one bestie.
• [ESRCH] — no thread could be found corresponding to the thread ID specified by the tid argument 😭 she's not here, she's gone, the thread ID matched nobody.

---

💜 SEE ALSO 💜

pthread_np(3), pthread_resume_all_np(3), pthread_resume_np(3), pthread_suspend_all_np(3) — the whole friend group, go read them too 🧚

---

👑 AUTHORS 👑

this manual page was written by Alexey Zelkin <phantom@FreeBSD.org> — king behaviour, we stan 🫶⭐

---

okay that's the whole page, ily, go suspend some threads responsibly 💖

Debian · October 12, 2021 · PTHREAD_SUSPEND_NP(3) — bye bestie, see you in the man pages 💅🎀