FreeBSD 7.0 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‐

 

NAME

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

LIBRARY

      Standard C Library (libc, -lc)
 

SYNOPSIS

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

DESCRIPTION

      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
      ignored.
 
      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‐
      ture.
      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.
 

ERRORS

      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)
 

STANDARDS

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

HISTORY

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

AUTHORS

      This manual page was written by Wes Peters 〈wes@softweyr.com〉.
 

Sections

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.