www.LinuxHowtos.org
io_queue_init
Section: Linux AIO (2)Updated: 2002-09-03
Index Return to Main Contents
NAME
io_queue_init - Initialize asynchronous io state machineSYNOPSIS
#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 locattion.
- 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)