Index Index for
Section 3
Index Alphabetical
listing for A
Bottom of page Bottom of
page		 

aio_error(3)


NAME

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


SYNOPSIS

  #include <aio.h>

  int aio_error (const struct
  aiocb *aiocbp);


LIBRARY

  Asynchronous I/O Library (libaio, libaio_raw)


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


RETURN VALUES

  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

  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.


SEE ALSO

  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

Index Index for
Section 3
Index Alphabetical
listing for A
Top of page Top of
page