AIO_HOLD(3)							   AIO_HOLD(3)

NAME    [Toc]    [Back]

     aio_hold, aio_hold64 - Defer or resume reception of asynchronous I/O
     callbacks

C SYNOPSIS    [Toc]    [Back]

     #include <aio.h>

     void aio_hold(int should_ hold);

     void aio_hold64(int should_hold);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     aio_write(3), lio_listio(3), aio_error(3),	aio_return(3), aio_cancel(3),
     mpadmin(1), realtime(5).

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111