aio_error — retrieve error status of asynchronous I/O operation (REALTIME)
Contents
Description
The aio_error() system call returns the error status of the asynchronous I/O request associated with the
structure pointed to by iocb.
Errors
The aio_error() system call will fail if:
[EINVAL] The iocb argument does not reference an outstanding asynchronous I/O request.
History
The aio_error() system call first appeared in FreeBSD 3.0.
Library
Standard C Library (libc, -lc)
Name
aio_error — retrieve error status of asynchronous I/O operation (REALTIME)
Return Values
If the asynchronous I/O request has completed successfully, aio_error() returns 0. If the request has
not yet completed, EINPROGRESS is returned. If the request has completed unsuccessfully the error status
is returned as described in read(2), write(2), or fsync(2). On failure, aio_error() returns -1 and sets
errno to indicate the error condition.
See Also
aio_cancel(2), aio_read(2), aio_return(2), aio_suspend(2), aio_write(2), fsync(2), read(2), write(2),
aio(4)
Standards
The aio_error() system call is expected to conform to the IEEE Std 1003.1 (“POSIX.1”) standard.
Synopsis
#include<aio.h>intaio_error(conststructaiocb*iocb);
