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 ALSO
     aio_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.