AIO_HOLD(3)AIO_HOLD(3)NAME
aio_hold, aio_hold64 - Defer or resume reception of asynchronous I/O
callbacks
C SYNOPSIS
#include <aio.h>
void aio_hold(int should_ hold);
void aio_hold64(int should_hold);
DESCRIPTION
The aio_hold() function allows the calling process to defer or resume the
reception of callback notification invocations. If the should_hold
parameter is AIO_HOLD_CALLBACK, callbacks will be deferred. If the
should_hold parameter is AIO_RELEASE_CALLBACKS then callbacks will be
released. If the value is AIO_ISHELD_CALLBACKS then nothing is done and
the current state is returned. Callbacks are the MIPS ABI preferred
method for notifications for completions of asynchronous I/O operations.
SEE ALSOaio_write(3), lio_listio(3), aio_error(3), aio_return(3), aio_cancel(3),
mpadmin(1), realtime(5).
DIAGNOSTICS
Upon successful completion the prior state is returned. A return value of
1 indicates that callbacks were being held at the time of the call and a
return value of 0 indicates they were not. Otherwise a value of -1 is
returned and is set to indicate the error.
[EINVAL] The value of should_hold is not one of
AIO_ISHELD_CALLBACK, AIO_HOLD_CALLBACK or
AIO_RELEASE_CALLBACK.
[EIO] It was not possible to perform this operation due to an
error.
Page 1
