io_queue_init

Section: Linux AIO (2)
Updated: 2002-09-03
Index Return to Main Contents

---

 

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)

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUES

ERRORS

SEE ALSO