www.LinuxHowtos.org





io_queue_wait

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

NAME

io_queue_wait - Wait for io requests to complete  

SYNOPSIS

#include <errno.h>

#include <libaio.h>
int io_queue_wait(io_context_t ctx, const struct timespec *timeout);
 

DESCRIPTION

Attempts to read an event from the completion queue for the aio_context specified by ctx_id.  

RETURN VALUES

May return 0 if no events are available and the timeout specified by when has elapsed, where when == NULL specifies an infinite timeout. Note that the timeout pointed to by when is relative and will be updated if not NULL and the operation blocks. Will fail with -ENOSYS if not implemented.  

RETURN VALUES

On success, io_queue_wait 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
ctx refers to an unitialized aio context, the iocb pointed to by iocbs contains an improperly initialized iocb,
ENOSYS
Not implemented
 

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_init(3), io_queue_release(3), io_queue_run(3), io_set_callback(3), io_submit(3), errno(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
RETURN VALUES
ERRORS
SEE ALSO