aio_error(2)

aio_error2

Retrieve error status of asynchronous i/o operation (realtime)

Usage

#include <aio.h>

int

aio_error(const struct aiocb *aiocbp);

Library

Standard C Library (libc, -lc)

Overview

The aio_error() system call returns the error status of the asynchronous I/O request associated with the structure pointed to by aiocbp.

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) is returned. On failure, aio_error() returns -1 and sets errno to indicate the error condition.

Errors

The aio_error() system call will fail if:

[EINVAL]

The aiocbp argument does not reference an outstanding asynchronous I/O request.

Releases

128 releases since Mac OS X 10.4; the text changed 1 time.

  1. 10.4–10.4.11
  2. 10.5–26.5

Standards

The aio_error() system call is expected to conform to the IEEE Std 1003.1 (“POSIX.1”) standard.

History

The aio_error() system call first appeared in FreeBSD 3.0.

Authors

This manual page was written by Wes Peters ⟨[email protected]⟩.

From xnu 12377.121.6 in macOS 26.5. Parsed by carta from the page's mdoc source.