NAME

       io_queue_init - Initialize asynchronous io state machine

SYNOPSIS

       #include <errno.h>

       #include <libaio.h>

       int io_queue_init(int maxevents, io_context_t *ctx);

DESCRIPTION

       io_queue_init  Attempts  to  create an aio context capable of receiving at least maxevents
       events.  ctx must point to an aio context that already exists and must be initialized to 0
       before  the  call.   If  the  operation  is successful, *cxtp is filled with the resulting
       handle.

RETURN VALUES

       On success, io_queue_init returns 0.  Otherwise, -error is return, where error is  one  of
       the Exxx values defined in the Errors section.

ERRORS

       EFAULT iocbs referenced data outside of the program's accessible address space.

       EINVAL maxevents is <= 0 or ctx is an invalid memory location.

       ENOSYS Not implemented.

       EAGAIN maxevents > max_aio_reqs where max_aio_reqs is a tunable value.

SEE ALSO

       io(3),  io_cancel(3),  io_fsync(3),  io_getevents(3),  io_prep_fsync(3), io_prep_pread(3),
       io_prep_pwrite(3),      io_queue_release(3),      io_queue_run(3),       io_queue_wait(3),
       io_set_callback(3), io_submit(3), errno(3).