NNG_AIO_STOP(3)

✨ NAME ✨

nng_aio_stop — stoppp that asynchronous I/O operation bestie, we're done here 💅

It's from the NNG Reference Manual, section 3, and honestly? It's giving "clean shutdown" and I'm obsessed 🫶

---

🌸 SYNOPSIS 🌸

#include <nng/nng.h>

void nng_aio_stop(nng_aio *aio);

---

🎀 DESCRIPTION 🎀

Okay so nng_aio_stop() is the girl who ends things properly. She takes the asynchronous I/O operation hanging out with aio and stops it by aborting it with NNG_ECANCELED 😭 — and then she doesn't just walk away. No ma'am. She waits for it to fully complete or to be completely aborted, and she also waits for the callback that's attached to the aio to finish executing. Full closure. Main character behaviour fr fr 👑

And after all that? Any further calls to nng_aio_begin() using this aio will return false. Like, it's over over. The door is closed, the lights are off, the vibe is sealed ✨

The iconic part: it is safe to call this for an aio even when literally no operation is currently pending for it. Zero drama, zero judgement. She just handles it 💖

Tip 🧚 When you've got multiple asynchronous I/O handles in use and they all need to be shut down, it is safest to stop all of them before deallocating any of them with nng_aio_free(). Especially if the callbacks might try to reschedule additional operations — like, do NOT free first, that's a jump scare. Stop everything, then free. Periodt 💀

---

🌈 RETURN VALUES 🌈

None. She gives you nothing back because she already gave you everything 🫶

---

💜 ERRORS 💜

None. No errors, no notes, we love a flawless queen 💅

---

🦋 SEE ALSO 🦋

• nng_aio_alloc(3)
• nng_aio_cancel(3)
• nng_aio_free(3)
• nng_aio_begin(3)
• nng_aio_wait(3)
• nng_aio(5)
• nng(7)

---

okay that's the whole page, go stop your async ops responsibly bestie 🎀✨

This lil drop is from the NNG Reference Manual, dated 2026-06-30. Drink water, close your handles, bye 🦋💖