Content-type: text/html Man page of aio_error

aio_error

Section: C Library Functions (3)
Index Return to Main Contents
 

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_group_completion_np(3), aio_read(3), aio_results_np(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3). delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:15 GMT, October 02, 2010