aio_return
- retrieve return status of asynchronous I/O operation (REALTIME)
LIBRARY
Lb libc
SYNOPSIS
#include <aio.h> int
aio_return (struct aiocb *iocb);
DESCRIPTION
The
aio_return ();
system call returns the final status of the asynchronous I/O request
associated with the structure pointed to by
Fa iocb .
The
aio_return ();
system call
should only be called once, to obtain the final status of an asynchronous
I/O operation once it has completed
(aio_error2
returns something other than
Er EINPROGRESS ) .
RETURN VALUES
If the asynchronous I/O request has completed, the status is returned
as described in
read(2),
write(2),
or
fsync(2).
Otherwise,
aio_return ();
returns -1 and sets
errno
to indicate the error condition.
ERRORS
The
aio_return ();
system call will fail if:
Bq Er EINVAL
The
Fa iocb
argument
does not reference a completed asynchronous I/O request.