AIOHOLD(3)                                                        AIOHOLD(3)



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

C SYNOPSIS
     #include <aio.h>

     void aiohold(int should hold);

     void aiohold64(int shouldhold);

DESCRIPTION
     The aiohold() function allows the calling process to defer or resume the
     reception of callback notification invocations. If the should_hold
     parameter is AIOHOLDCALLBACK, callbacks will be defered. If the
     should_hold parameter is AIORELEASECALLBACKS then callbacks will be
     released. If the value is AIOISHELDCALLBACKS 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.



















                                                                        Page 1