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_WAITCOMPLETE (2)

NAME

aio_waitcomplete - wait for the next completion of an aio request

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
Standards
History
Authors

LIBRARY


.Lb libc

SYNOPSIS


.In aio.h int aio_waitcomplete struct aiocb **iocbp struct timespec *timeout

DESCRIPTION

The aio_waitcomplete system call waits for completion of an asynchronous I/O request. Upon completion, aio_waitcomplete returns the result of the function and sets iocbp to point to the structure associated with the original request. If an asynchronous I/O request is completed 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.

RETURN VALUES

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 returned as described in read(2), write(2), or fsync(2). On failure, aio_waitcomplete returns -1, sets iocbp to NULL and sets errno to indicate 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 asynchronous I/O requests completed.

SEE ALSO

aio_cancel(2), aio_error(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), fsync(2), read(2), write(2), aio(4)

STANDARDS

The aio_waitcomplete system call is a
.Fx Ns -specific extension.

HISTORY

The aio_waitcomplete system call first appeared in
.Fx 4.0 .

AUTHORS

The aio_waitcomplete system call and this manual page were written by
.An Christopher M Sedore Aq cmsedore@maxwell.syr.edu .
Search for    or go to Top of page |  Section 2 |  Main Index


January 19, 2000 AIO_WAITCOMPLETE (2)

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