aio_error(3aio)

aio_error, aio_error64 -- retrieve asynchronous I/O error status

Synopsis

   
   cc [options] -Kthread file
   

   #include <aio.h>
   

   int aio_error(const struct aiocb *aiocbp);
   

   int aio_error64(const struct aiocb64 *aiocbp);

Description

aio_error 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 that would be set by the corresponding read, write, or fsync operation. If the operation is not completed, the error status equals EINPROGRESS. ENOMEM is returned if there were no internal kernal aio control blocks available to service the request (number of kernel aio control blocks is tunable via the NUMAIO kernel parameter; see ``Miscellaneous parameters'' in Monitoring and tuning the system).

Return values

If the asynchronous I/O operation completes successfully, 0 is returned. If it fails, the corresponding read, write, or fsync error status is returned. EINPROGRESS is returned if the operation is still in progress.

References

aio_cancel(3aio), aiocb(5), aio_read(3aio), aio_return(3aio), aio_write(3aio), fsync(2), intro(2), read(2), write(2)

Notices

Considerations for large file support

aio_error64 supports large files, but is otherwise identical to aio_error. For details on programming for large file capable applications, see ``Large File Support'' on intro(2).