DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

aio_error(S-osr5)

aio_error -- retrieve error status of asynchronous I/O operation

Syntax

cc . . . -lsuds 
#include <aio.h>


int aio_error(const struct aiocb *aiocbp);

Description

The aio_error(S-osr5) function returns the error status associated with the aiocb structure referenced by the aiocbp argument. The error status for an asynchronous I/O operation is the errno value set by the corresponding read(S-osr5) or write(S-osr5) or fsync(S-osr5) operation. If the operation has not yet completed, then the error status is equal to EINPROGRESS.

Return values

If the asynchronous I/O operation completes successfully, then 0 is returned. If the asynchronous operation completes unsuccessfully, then the error status, as described for read, write, and fsync is returned. If the asynchronous I/O operation has not yet completed, then EINPROGRESS is returned.

Diagnostics

For the following condition, the aio_error function returns -1 and sets errno to the corresponding value:

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

See also

aio(FP), aio_read(S-osr5), aio_return(S-osr5), aio_write(S-osr5), close(S-osr5), _exit(S-osr5), exec(S-osr5), fork(S-osr5), lio_listio(S-osr5), lseek(S-osr5), read(S-osr5)

Standards conformance

Text reprinted and/or adapted from IEEE Std 1003.1b-1993, IEEE Standard for Information Technology, POSIX Part 1: System Application Program Interface (API) Amendment 1: Realtime Extensions [C Language], copyright © 1993 by the Institute of Electrical and Electronics Engineers, Inc. The IEEE takes no responsibility for and will assume no liability for damages resulting from the reader's misinterpretation of said information resulting from the placement and context in this publication. Information is reproduced with the permission of the IEEE.
© 2005 System Services (S-osr5)
SCO OpenServer Release 6.0.0 -- 02 June 2005