NAME [Toc]

 aio_error - Returns the error status of a specified asynchronous
 I/O operation (P1003.1b)

SYNOPSIS [Toc]

 #include <aio.h>
 int aio_error (const struct aiocb *aiocbp);

LIBRARY [Toc]

 Asynchronous I/O Library (libaio, libaio_raw)

PARAMETERS [Toc]

 A pointer to the address of the aiocb structure.

DESCRIPTION [Toc]

 The aio_error function returns the error status associated
 with the aiocb structure referenced by the aiocbp argument.
 The error status is the errno value that is set by
 the corresponding asynchronous I/O read, write, or fsync
 operation.
 The aio_error function returns EINPROGRESS until the asynchronous
 I/O operation is complete. When the operation is
 complete, call the aio_return function to determine if the
 operation was successful.

RETURN VALUES [Toc]

 If the asynchronous I/O operation was successful, a value
 of 0 is returned.
 If the asynchronous I/O operation has not yet completed,
 [EINPROGRESS] is returned.
 If the aio_error operation was canceled, [ECANCELED] is
 returned.
 On an unsuccessful call, the value returned corresponds to
 those error values returned for a failed read, write, or
 fsync operation.

ERRORS [Toc]

 The aio_error function fails under the following conditions:
 The aiocbp argument does not refer to an asynchronous
 operation whose return status has not yet been
 retrieved.

SEE ALSO [Toc]

 Functions: close(2), exec(2), _exit(2), fork(2), lseek(2),
 read(2), write(2), aio_cancel(3), aio_group_completion_np(3), aio_read(3), aio_results_np(3), aio_return(3),
 aio_suspend(3), aio_write(3), lio_listio(3)
 Guide to Realtime Programming
 aio_error(3)