io_queue_init
Section: Linux AIO (2)
Updated: 2002-09-03
Page Index
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 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)