FreeBSD 6.2 manual page repository

FreeBSD is a free computer operating system based on BSD UNIX originally. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

aio_suspend - suspend until asynchronous I/O operations or timeout com‐



      aio_suspend - suspend until asynchronous I/O operations or timeout com‐
      plete (REALTIME)


      Standard C Library (libc, -lc)


      #include <aio.h>
      aio_suspend(const struct aiocb * const iocbs[], int niocb,
              const struct timespec * timeout);


      The aio_suspend() system call suspends the calling process until at least
      one of the specified asynchronous I/O requests have completed, a signal
      is delivered, or the timeout has passed.
      The iocbs argument is an array of niocb pointers to asynchronous I/O
      requests.  Array members containing null pointers will be silently
      If timeout is not a null pointer, it specifies a maximum interval to sus‐
      pend.  If timeout is a null pointer, the suspend blocks indefinitely.  To
      effect a poll, the timeout should point to a zero-value timespec struc‐
      If one or more of the specified asynchronous I/O requests have completed,
      aio_suspend() returns 0.  Otherwise it returns -1 and sets errno to indi‐
      cate the error, as enumerated below.


      The aio_suspend() system call will fail if:
      [EAGAIN]           the timeout expired before any I/O requests completed.
      [EINVAL]           The iocbs argument contains more than AIO_LISTIO_MAX
                         asynchronous I/O requests, or at least one of the
                         requests is not valid.
      [EINTR]            the suspend was interrupted by a signal.
      aio_cancel(2), aio_error(2), aio_return(2), aio_waitcomplete(2),
      aio_write(2), aio(4)


      The aio_suspend() system call is expected to conform to the IEEE Std
      1003.1 (“POSIX.1”) standard.


      The aio_suspend() system call first appeared in FreeBSD 3.0.


      This manual page was written by Wes Peters 〈〉.


Based on BSD UNIX
FreeBSD is an advanced operating system for x86 compatible (including Pentium and Athlon), amd64 compatible (including Opteron, Athlon64, and EM64T), UltraSPARC, IA-64, PC-98 and ARM architectures. It is derived from BSD, the version of UNIX developed at the University of California, Berkeley. It is developed and maintained by a large team of individuals. Additional platforms are in various stages of development.