NNG_AIO_SET_TIMEOUT(3)

📦
version 1.12.0 · 4 versions
, in ubuntu stonking

OMG hi bestie 💖 welcome to the NNG Reference Manual page for NNG_AIO_SET_TIMEOUT(3) — this is where we set asynchronous I/O timeouts, and yes it’s giving main character energy. ✨

🌸 NAME 🌸

nng_aio_set_timeout — set asynchronous I/O timeout

🦋 SYNOPSIS 🦋

#include <nng/nng.h>

typedef int nng_duration;
void nng_aio_set_timeout(nng_aio *aio, nng_duration timeout);

typedef uint64_t nng_time;
void nng_aio_set_expire(nng_aio *aio, nng_time expiration);

✨ DESCRIPTION ✨

Okay so listen: nng_aio_set_timeout() sets a timeout for the asynchronous operation that’s associated with aio. Once the operation is actually started, that’s when the timer starts. If the timer expires before the operation is completed, the operation is aborted with an error of NNG_ETIMEDOUT. The timeout is specified as a relative number of milliseconds.

If the timeout is NNG_DURATION_INFINITE, then no timeout is used. If the timeout is NNG_DURATION_DEFAULT, then a "default" or socket-specific timeout is used. (This is frequently the same as NNG_DURATION_INFINITE.) 💅

The nng_aio_set_expire() function is similar to nng_aio_set_timeout(), but it sets an absolute expiration time based on the system clock. The expiration is expressed as a number of milliseconds since some point in the past. The nng_clock() function can be used to determine the current value of the clock. 🕰️

🫶 Tip: As most operations involve some context switching, it is usually a good idea to allow at least a few tens of milliseconds before timing them out — a too small timeout might not allow the operation to properly begin before giving up!

The value of timeout set for the aio is persistent, so if the handle is reused for multiple operations, they will have the same relative timeout. It’s not a one-time vibe — it sticks around. 💖

🎀 RETURN VALUES 🎀

None.

💀 ERRORS 💀

None.

🌈 SEE ALSO 🌈

That’s the page, bestie! 💖 From the NNG Reference Manual, dated 2026-06-30, and it’s for NNG_AIO_SET_TIMEOUT(3) — slay, bye! 👑✨

📦 where this page comes from