GSP
Quick Navigator

Search Site

Linux VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  - AIO_SUSPEND (2)

NAME

aio_suspend - suspend until asynchronous I/O operations or timeout complete (REALTIME)

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
Standards
History
Authors

LIBRARY


.Lb libc

SYNOPSIS


.In 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 suspend. If timeout is a null pointer, the suspend blocks indefinitely. To effect a poll, the timeout should point to a zero-value timespec structure.

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 indicate 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 -p1003.1 standard.

HISTORY

The aio_suspend system call first appeared in
.Fx 3.0 .

AUTHORS

This manual page was written by
.An Wes Peters Aq wes@softweyr.com .
Search for    or go to Top of page |  Section 2 |  Main Index


June 2, 1999 AIO_SUSPEND (2)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.