Retrieves the error status of an asynchronous I/O request.
#include <aio.h>
int
aio_error( handle)
aio_handle_t handle;
int aio_error64( handle)
aio_handle_t handle;
The aio_error subroutine retrieves the error status of the asynchronous request associated with the handle parameter. The error status is the errno value that would be set by the corresponding I/O operation. The error status is EINPROG if the I/O operation is still in progress.
The aio_error64 subroutine is similar to the aio_error subroutine except that it retrieves the error status associated with an aiocb64 control block.
The aio_error and aio_error64 subroutines can be called from the process environment only.
0 | Indicates that the operation completed successfully. |
ECANCELED | Indicates that the I/O request was canceled due to an aio_cancel subroutine call. |
EINPROG | Indicates that the I/O request has not completed.
An errno value described in
the aio_read (aio_read or aio_read64 Subroutine), aio_write (aio_write or aio_write64 Subroutine), and lio_listio (lio_listio or lio_listio64 Subroutine) subroutines:
An errno value of the
corresponding I/O operation:
|
The aio_error and aio_error64 subroutines are part of Base Operating System (BOS) Runtime.
The aio_cancel or aio_cancel64 (aio_cancel or aio_cancel64 Subroutine) subroutine, aio_read or aio_read64 (aio_read or aio_read64 Subroutine) subroutine, aio_return or aio_return64 (aio_return or aio_return64 Subroutine) subroutine, aio_suspend or aio_suspend64 (aio_suspend or aio_suspend64 Subroutine) subroutine, aio_write or aio_write64 (aio_write or aio_write64 Subroutine) subroutine, lio_listio (lio_listio or lio_listio64 Subroutine) or lio_listio64 (lio_listio or lio_listio64 Subroutine) subroutine.
The Asynchronous I/O Overview and the Communications I/O Subsystem: Programming Introduction in AIX 5L Version 5.1 Kernel Extensions and Device Support Programming Concepts.
The Input and Output Handling Programmer's Overview in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs describes the files, commands, and subroutines used for low-level, stream, terminal, and asynchronous I/O interfaces.