NAME

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

SYNOPSIS

#include <aio.h>

int aio_error (const struct
aiocb ∗aiocbp);

PARAMETERS

∗aiocbp 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. Once the operation is complete, call the aio_return function to determine if the operation is successful. 

RETURN VALUES

If the asynchronous I/O operation is 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:

[EINVAL] The aiocbp argument does not refer to an asynchronous operation whose return status has not yet been retrieved. 

RELATED INFORMATION

Functions: close(2), exec(2), _exit(2), fork(2), lseek(2), read(2), write(2), aio_cancel(3), aio_read(3), aio_return(3), aio_write(3), lio_listio(3)