Digital

NAME

aio_error − return the error status of a specified asynchronous I/O operation (P1003.4/D10)

SYNOPSIS

#include <aio.h>

int aio_error (
aio_handle_t handle) ;

PARAMETERS

handle The handle used to identify the asynchronous operation whose status is being queried. 

DESCRIPTION

The aio_error function returns the error status associated with the handle passed in. The error status is the errno value that is set by the corresponding read or write operation. If the operation is in progress, the return value is equal to EINPROG. 

The handle is a unique identifier, that is set when the asynchronous I/O operation is first submitted. Each separate asynchronous I/O operation, whether submitted as an aio_read, aio_write, or as a single item in a list using the lio_listio function, has a unique handle associated with the I/O request. When you call an asynchronous I/O function, the handle field in the aiocb structure is set.  The type, aio_handle_t, is defined in <aio.h>. 

RETURN VALUES

If the aio_error function returns successfully, a value of 0 is returned. 

On an unsuccessful call, a value of −1 is returned and errno is set to indicate that an error occurred. The error status corresponds to those described for aio_read or aio_write. 

RELATED INFORMATION

aio_cancel(3), aio_read(3), aio_return(3), aio_write(3), lio_listio(3)