NAME
aio_error —
retrieve errors status for an asynchronous I/O operation
(REALTIME)
SYNOPSIS
#include <aio.h> int aio_error(const struct aiocb *aiocbp);
DESCRIPTION
The aio_error() function returns the error status associated with the aiocb structure referenced by the aiocbp argument. The error status for an asynchronous I/O operation is the errno value that would be set by the corresponding read(3) , write(3) , or fsync(3) operation. If the operation has not yet completed, then the error status will be equal to EINPROGRESS.
RETURN VALUE
If the asynchronous I/O operation has completed successfully, then 0 is returned. If the asynchronous operation has completed unsuccessfully, then the error status, as described for read(3) , write(3) , and fsync(3) , is returned. If the asynchronous I/O operation has not yet completed, then EINPROGRESS is returned.
ERRORS
The aio_error() function will fail if:
- [ENOSYS]
- The aio_error() function is not supported by this implementation.
The aio_error() function may fail if:
- [EINVAL]
- The aiocbp argument does not refer to an asynchronous operation whose return status has not yet been retrieved.
EXAMPLES
None.
APPLICATION USAGE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
aio_read(3) , aio_write(3) , aio_fsync(3) , lio_listio(3) , aio_return(3) , aio_cancel(3) , read(3) , lseek(3) , close(3) , _exit(3) , exec(3) , fork(3) .
DERIVATION
Derived from the POSIX Realtime Extension (1003.1b-1993/1003.1i-1995)