aio_suspend man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

AIO_SUSPEND(2)		    BSD System Calls Manual		AIO_SUSPEND(2)

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.

RETURN VALUES
     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.

SEE ALSO
     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⟩.

BSD				 June 2, 1999				   BSD
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net