|AIO_WAITCOMPLETE(2)||System Calls Manual||AIO_WAITCOMPLETE(2)|
LIBRARY¶Standard C Library (libc, -lc)
aiocb **iocbp, struct
aio_waitcomplete() system call waits for completion of an asynchronous I/O request. Upon completion,
aio_waitcomplete() returns the result of the function and sets iocbp to point to the structure associated with the original request. If an asynchronous I/O request is completed before
aio_waitcomplete() is called, it returns immediately with the completed request.
If timeout is a non-NULL pointer, it
specifies a maximum interval to wait for a asynchronous I/O request to
complete. If timeout is a NULL pointer,
aio_waitcomplete() waits indefinitely. To effect a
poll, the timeout argument should be non-NULL,
pointing to a zero-valued timeval structure.
aio_waitcomplete() system call also
serves the function of
aio_return() should not be called for the control
block returned in iocbp.
RETURN VALUES¶If an asynchronous I/O request has completed, iocbp is set to point to the control block passed with the original request, and the status is returned as described in read(2), write(2), or fsync(2). On failure,
-1, sets iocbp to
NULLand sets errno to indicate the error condition.
aio_waitcomplete() system call fails if:
- The specified time limit is invalid.
- The process has not yet called
- 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.
SEE ALSO¶aio_cancel(2), aio_error(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), fsync(2), read(2), write(2), aio(4)
aio_waitcomplete() system call is a FreeBSD-specific extension.
aio_waitcomplete() system call first appeared in FreeBSD 4.0.
aio_waitcomplete() system call and this manual page were written by Christopher M Sedore <email@example.com>.
|March 21, 2016||Linux 4.9.0-9-amd64|