AIO_ERROR(3)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 ALSOaio_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.
Page 1
