io_queue_wait(2)

io_queue_wait2

Wait for io requests to complete

Usage

#include <errno.h>

#include <libaio.h>

int io_queue_wait(io_context_t ctx_id, const struct timespec *timeout);

Overview

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_id refers to an uninitialized aio context, the iocb pointed to by iocbs contains an improperly initialized iocb.

ENOSYS

Not implemented.

Releases

6 releases since Debian 4.0 (Etch); the text changed 2 times.

  1. 4.0–5.0
  2. 6.0–8
  3. 9

From libaio-dev 0.3.110-3 in Debian 9 (Stretch). Parsed by carta from the page's man source.