Index for Section 3

Alphabetical listing for A

Bottom of page

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

SYNOPSIS
  #include <aio.h>

  int aio_error (const struct
  aiocb *aiocbp);

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

RETURN VALUES
  If the asynchronous I/O operation is 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.

RELATED INFORMATION
  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).

Index for Section 3

Alphabetical listing for A

Top of page