aio_error(3)

NAME
     aio_error, aio_error64 - return error status of an asynchronous I/O
     operation

C SYNOPSIS
     #include <aio.h>

     int aio_error(const aiocb_t *aiocbp);

     int aio_error64(const aiocb64_t *aiocbp);

DESCRIPTION
     The aio_error() function returns the error status associated with the
     aiocbp passed in. The error status for an asynchronous I/O operation is
     the errno value that would be set by the corresponding read(2) or
     write(2) or fsync(2) operation.  If the operation has not yet completed,
     then the error status shall be equal to EINPROGRESS.

     The aio_error64() function is identical to aio_error() except that it
     takes an aiocb64_t * (see <aio.h>).  This structure allows for the
     specification of a file offset greater than 2 Gigabytes.  The user must
     define _ABI_SOURCE and include -labi to access the aio64 routines.

SEE ALSO
     aio_read(3), aio_write(3), lio_listio(3), aio_error(3), aio_return(3),
     aio_cancel(3), aio_sgi_init(3), read(2), lseek(2), close(2),_exit(2),
     exec(2), fork(2).

DIAGNOSTICS
     If the asynchronous I/O operation has completed successfully, then 0
     shall be returned. If the asynchronous operation has completed
     unsuccessfully, then the error status, as described for read(2),
     write(2), and fsync(2) shall be returned. If the asynchronous I/O has not
     yet completed, then EINPROGRESS shall be returned.

     If any of the conditions below occur, the aio_error() function shall
     return -1 and set errno to the corresponding value.

     [EINVAL]       The aiocbp argument does not yet refer to an asynchronous
                    operation whose return status has not yet been retrieved.