Ubuntu Feisty 7.04 manual page repository

Ubuntu is a free computer operating system based on the Linux kernel. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

Provided by: freebsd-manpages_6.0-5_all

NAME

      aio_waitcomplete - wait for the next completion of an aio request
 

LIBRARY

      Standard C Library (libc, -lc)
 

SYNOPSIS

      #include <aio.h>
 
      int
      aio_waitcomplete(struct aiocb **iocbp, struct timespec *timeout);
 

DESCRIPTION

      The aio_waitcomplete() system call waits for completion of an asyn‐
      chronous I/O request.  Upon completion, aio_waitcomplete() returns the
      result of the function and sets iocbp to point to the structure associ‐
      ated with the original request.  If an asynchronous I/O request is com‐
      pleted 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.
      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
fsync(2).  On failure,
      aio_waitcomplete() returns -1, sets iocbp to NULL and sets errno to indi‐
      cate the error condition.
 

ERRORS

      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 asyn‐
                         chronous I/O requests completed.
aio_suspend(2),
aio(4)
 

STANDARDS

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

HISTORY

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

AUTHORS

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