aio_return(2) retrieve return status of asynchronous I/O operation (REALTIME)

LIBRARY

Lb libc

SYNOPSIS

In aio.h Ft int Fn aio_return struct aiocb *iocb

DESCRIPTION

The Fn aio_return system call returns the final status of the asynchronous I/O request associated with the structure pointed to by Fa iocb .

The Fn aio_return system call should only be called once, to obtain the final status of an asynchronous I/O operation once it has completed (aio_error2 returns something other than Er EINPROGRESS ) .

RETURN VALUES

If the asynchronous I/O request has completed, the status is returned as described in read(2), write(2), or fsync(2). Otherwise, Fn aio_return returns -1 and sets errno to indicate the error condition.

ERRORS

The Fn aio_return system call will fail if:

Bq Er EINVAL
The Fa iocb argument does not reference a completed asynchronous I/O request.

STANDARDS

The Fn aio_return system call is expected to conform to the St -p1003.1 standard.

HISTORY

The Fn aio_return system call first appeared in Fx 3.0 .

AUTHORS

This manual page was written by An Wes Peters Aq [email protected] .