NNG_MTX_LOCK(3supp)

📦 version 1.11, in alpine 3.24

✨ NAME ✨

nng_mtx_lock — lock a mutex, bestie 💅 (this is from the NNG Reference Manual, section 3supp, and yes she's iconic)

🌸 SYNOPSIS 🌸

#include <nng/nng.h>

void nng_mtx_lock(nng_mtx *mtx);

🎀 DESCRIPTION 🎀

Okay so nng_mtx_lock() grabs exclusive ownership of the mutex mtx. Like, it's yours now, nobody else gets in 💖.

If the lock is already owned by someone else, this function will simply wait until the current owner releases it with nng_mtx_unlock(). Patient queen behavior honestly 🧚

If multiple threads are all waiting for the lock? The order of acquisition is not specified — so it's giving chaos, not a queue, and you literally cannot predict who gets it next 🙈

Note 🫶 A mutex can only be unlocked by the thread that locked it. No proxy unlocking, no handing it off, periodt.
Important 🔥 Mutex locks are not recursive. Attempts to reacquire the same mutex may result in deadlock or aborting the current program 💀 It is a programming error for the owner of a mutex to attempt to reacquire it. Do not do this, I'm begging you 😭

⭐ RETURN VALUES ⭐

None. She returns nothing, she just does her job 💅

🦋 ERRORS 🦋

None. Zero errors, zero drama, we love a low-maintenance function ✨

👑 SEE ALSO 👑

mwah 💋 that's the whole page, written by the NNG crew (NNG Reference Manual, dated 2026-01-13) — go lock something responsibly, bestie 🎀

📦 where this page comes from