AIORETURN(2) BSD System Calls Manual AIORETURN(2)

NAME
     aaiioorreettuurrnn - retrieve return status of asynchronous I/O operation (REAL-
     TIME)

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     ssizet
     aaiioorreettuurrnn(struct aiocb *aiocbp);

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

     The aaiioorreettuurrnn() system call should only be called once, to obtain the
     final status of an asynchronous I/O operation once aioerror(2) returns
     something other than 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).  On failure, aaiioorreettuurrnn()
     returns -1 and sets errno to indicate the error condition.

EERRRROORRSS
     The aaiioorreettuurrnn() system call will fail if:

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

LEGACY SYNOPSIS
     ##iinncclluuddee <>

     int
     aaiioorreettuurrnn(struct aiocb *aiocbp);

     The type of the return value has changed.

SEE ALSO
     aiocancel(2), aioerror(2), aiosuspend(2), aiowrite(2), fsync(2),
     read(2), write(2), aio(4), compat(5)

STANDARDS     The aaiioorreettuurrnn() system call is expected to conform to the IEEE Std
     1003.1 (``POSIX.1'') standard.

HISTORY     The aaiioorreettuurrnn() system call first appeared in FreeBSD 3.0.

AUTHORS     This manual page was written by Wes Peters .

BSD                              June 2, 1999                              BSD