Manual Pages  — AIO_WAITCOMPLETE

aio_waitcomplete – wait for the next completion of an aio request

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO STANDARDS HISTORY AUTHORS

Standard C Library (libc, -lc)

#include <aio.h>

ssize_t
aio_waitcomplete(struct aiocb **iocbp, struct timespec *timeout);

The 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.

The aio_waitcomplete() system call also serves the function of aio_return(), thus aio_return() should not be called for the control block returned in iocbp.

The aio_waitcomplete() system call fails if:

[EINVAL]
	The specified time limit is invalid.
[EAGAIN]
	The process has not yet called aio_read() or aio_write().
[EINTR]
	A signal was delivered before the timeout expired and before any asynchronous I/O requests completed.
[EWOULDBLOCK] [EINPROGRESS]
	The specified time limit expired before any asynchronous I/O requests completed.

The aio_waitcomplete() system call is a FreeBSD Ns -specific extension.

The aio_waitcomplete() system call first appeared in FreeBSD 4.0 .

The aio_waitcomplete() system call and this manual page were written by Christopher M Sedore <Mt cmsedore@maxwell.syr.edu>.