*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> aio_waitcomplete (2)              



NAME    [Toc]    [Back]

     aio_waitcomplete -- wait for the next completion of an aio request

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <aio.h>

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

DESCRIPTION    [Toc]    [Back]

     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

     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

     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.

RETURN VALUES    [Toc]    [Back]

     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,
     aio_waitcomplete() returns -1, sets iocbp to NULL and sets errno to indicate
 the error condition.

ERRORS    [Toc]    [Back]

     The aio_waitcomplete() system call fails if:

     [EINVAL]		The specified time limit is invalid.

     [EAGAIN]		The process has not yet called aio_read() or

     [EINTR]		A signal was delivered before the timeout expired and
			before any asynchronous I/O requests completed.


     [EINPROGRESS]	The specified time limit expired before any asynchronous
 I/O requests completed.

SEE ALSO    [Toc]    [Back]

     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)

STANDARDS    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

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

AUTHORS    [Toc]    [Back]

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

FreeBSD 5.2.1		       January 19, 2000 		 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
glfinishasyncsgix IRIX wait for completion of an asynchronous command
aio_suspend IRIX wait for an asynchronous I/O request
wait IRIX await completion of process
wait Tru64 Awaits process completion
wait OpenBSD await process completion
wait HP-UX await process completion
Term::Complete IRIX Perl word completion module
glpollasyncsgix IRIX poll for completion of an asynchronous command
VkCompletionField IRIX A text input field that supports automatic name completion
tcsh IRIX shell with file name completion and command line editing
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service