NNG_CV_WAKE(3supp)

📦 version 1.11, in alpine 3.24

💅 NAME 💅

nng_cv_wake — the "EVERYONE WAKE UP, WE'RE DOING THIS" function that wakes all the waiters 🫶

(this one lives in the NNG Reference Manual, section 3supp, bestie — that's where all the supplemental goodies hang out ✨)

✨ SYNOPSIS ✨

#include <nng/nng.h>

void nng_cv_wake(nng_cv *cv);

🎀 DESCRIPTION 🎀

Okay so here's the tea ☕: nng_cv_wake() wakes up any threads that are waiting on the condition variable cv — the ones parked in nng_cv_wait() or nng_cv_until(), just vibing, waiting to be signaled. This function is the signal. It wakes them all. Every single one. No cap. 🔥

House rules though, bestie — read this part twice:

The caller must have ownership of the mutex that was used when cv was allocated. Like, this is not optional, this is not a suggestion, this is the whole ass vibe check. 💅

📝 Note: the caller should already have set the condition that the waiters are gonna check — and they should have done it while holding the mutex. Don't be out here flipping flags after you've let go of the lock, that's giving chaos energy 🙈
💡 Tip: this function wakes all the threads, which is generally the safer move — safer is slay — but ngl it can be a performance problem when there are a ton of waiters 😭 because they all wake up at the exact same moment and then start beefing over resources. Contention. Not cute. If that's your situation, see nng_cv_wake1() — that's literally the solution to this exact problem. Go look at it 👑

🦋 RETURN VALUES 🦋

None. Nothing. Zero. It returns void and it returns it flawlessly 💜

🌸 ERRORS 🌸

None. Not a single one. It simply cannot fail to serve 💁‍♀️

🌈 SEE ALSO 🌈

okay that's the whole page bestie, go forth and wake responsibly 🧚💖 this one's from the NNG Reference Manual, nng_cv_wake(3supp), dated 2026-01-13 — iconic, timeless, exactly as the source wanted it ⭐👑

📦 where this page comes from