aio_return --
retrieve return status of asynchronous I/O operation
Syntax
cc . . . -lsuds
#include <aio.h>
ssize_t aio_return(struct aiocb *aiocbp);
Description
The
aio_return(S)
function returns the return status associated with the
aiocb structure referenced by the aiocbp
argument. The return status for an asynchronous I/O
operation is the value that would be returned by the corresponding
read(S),
write(S),
or
fsync(S)
function call.
The aio_return function may be called exactly once to
retrieve the return status of a given asynchronous operation;
thereafter, if the same aiocb structure is used in a call
to aio_return or
aio_error(S),
an error may be returned. When the aiocb structure
referred to by aiocbp is used to submit another
asynchronous operation, then aio_return may be
successfully used to retrieve the return status of that operation.
Return values
If the asynchronous I/O operation has completed, then the
return status, as described for read, write, and
fsync is returned.
Diagnostics
If the following condition occurs, the aio_return function
returns -1 and sets errno to the corresponding value:
[EINVAL]
The aiocbp argument does not refer to an asynchronous
operation whose return status has not yet been retrieved.