NAME    [Toc]    [Back]

       aio_error  - Returns the error status of a specified asynchronous
 I/O operation (P1003.1b)

SYNOPSIS    [Toc]    [Back]

       #include <aio.h>

       int aio_error (const struct aiocb *aiocbp);

LIBRARY    [Toc]    [Back]

       Asynchronous I/O Library (libaio, libaio_raw)

PARAMETERS    [Toc]    [Back]

       A pointer to the address of the aiocb structure.

DESCRIPTION    [Toc]    [Back]

       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. When the operation is
       complete, call the aio_return function to determine if the
       operation was successful.

RETURN VALUES    [Toc]    [Back]

       If  the asynchronous I/O operation was 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    [Toc]    [Back]

       The aio_error function fails under  the  following  conditions:
  The  aiocbp  argument  does  not refer to an asynchronous
 operation whose return status has  not  yet  been
       retrieved.

SEE ALSO    [Toc]    [Back]

       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)

       Guide to Realtime Programming



                                                     aio_error(3)