aio_error(3)aio_error(3)NAMEaio_error - Returns the error status of a specified asynchronous I/O
operation (P1003.1b)
SYNOPSIS
#include <aio.h>
int aio_error (const struct aiocb *aiocbp);
LIBRARY
Asynchronous I/O Library (libaio, libaio_raw)
PARAMETERS
A pointer to the address of the aiocb structure.
DESCRIPTION
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
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
The aio_error function fails under the following conditions: The aiocbp
argument does not refer to an asynchronous operation whose return sta‐
tus has not yet been retrieved.
SEE ALSO
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)