Linux Certif

Toute la documentation sur la certification Linux LPI

aio_return.2freebsd

BSD mandoc

NAME

aio_return - 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.

SEE ALSO

aio_cancel2, aio_error2, aio_suspend2, aio_waitcomplete2, aio_write2, fsync(2), read(2), write(2), aio(4)

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 wes@softweyr.com .