— wait for the next
completion of an aio request
Standard C Library (libc, -lc)
() system call waits for completion of an
asynchronous I/O request. Upon completion,
() returns the result of the function and
to point to the structure associated with the
original request. If an asynchronous I/O request is completed before
() is called, it returns immediately with
the completed request.
is a non-NULL pointer, it specifies a maximum
interval to wait for a asynchronous I/O request to complete. If
is a NULL pointer,
() waits indefinitely. To effect a poll, the
argument should be non-NULL, pointing to a
zero-valued timeval structure.
() system call also serves the function of
(), thus aio_return
() should not
be called for the control block returned in iocbp
If an asynchronous I/O request has completed, iocbp
to point to the control block passed with the original request, and the status
is returned as described in read(2)
, or fsync(2)
. On failure,
and sets errno
indicate the error condition.
() system call fails if:
- The specified time limit is invalid.
- The process has not yet called aio_read()
- A signal was delivered before the timeout expired and
before any asynchronous I/O requests completed.
- The specified time limit expired before any asynchronous
I/O requests completed.
() system call is a
() system call first appeared in
() system call and this manual page were
written by Christopher M Sedore