Skip to content

Latest commit

 

History

History
60 lines (44 loc) · 1.61 KB

nng_aio_stop.3.adoc

File metadata and controls

60 lines (44 loc) · 1.61 KB

nng_aio_stop(3)

NAME

nng_aio_stop - stop asynchronous I/O operation

SYNOPSIS

#include <nng/nng.h>

void nng_aio_stop(nng_aio *aio);

DESCRIPTION

The nng_aio_stop() function stops the asynchronous I/O operation associated with aio by aborting with NNG_ECANCELED, and then waits for it to complete or to be completely aborted, and for the callback associated with the aio to have completed executing.

Further calls to nng_aio_begin() using this aio will return false.

It is safe to call this for an aio, even when no operation is currently pending for it.

Tip
When multiple asynchronous I/O handles are in use and need to be shut down, it is safest to stop all of them, before deallocating any of them with nng_aio_free(), particularly if the callbacks might attempt to reschedule additional operations.

RETURN VALUES

None.

ERRORS

None.