AIO_RETURN(3)							 AIO_RETURN(3)

NAME    [Toc]    [Back]

     aio_return, aio_return64 -	return error status of an asynchronous I/O
     operation

C SYNOPSIS    [Toc]    [Back]

     #include <aio.h>

     ssize_t aio_return(aiocb_t	*aiocbp);

     ssize_t aio_return64(aiocb64_t *aiocbp);

DESCRIPTION    [Toc]    [Back]

     The aio_return() function returns the return status associated with the
     aiocbp passed in. The return status for an	asynchronous I/O operation is
     the value that would be returned by the corresponding read(2) or write(2)
     or	fsync(2) operation.  If	the error status for the operation is equal to
     EINPROGRESS, then the return status for the operation is undefined.

     The aio_return() function may be called exactly once to retrieve the
     return status of a	given asynchronous operation; thereafter, if the same
     aiocb structure is	used in	a call to aio_return() or aio_error(), an
     error may be returned.

     The aio_return64()	function is identical to aio_return() except that it
     takes an aiocb64_t	* (see <aio.h>).  This structure allows	for the
     specification of a	file offset greater than 2 Gigabytes.

SEE ALSO    [Toc]    [Back]

     aio_read(3), aio_write(3),	lio_listio(3), aio_error(3), aio_cancel(3),
     aio_sgi_init(3), read(2), lseek(2), close(2),_exit(2), exec(2), fork(2).

DIAGNOSTICS    [Toc]    [Back]

     If	the asynchronous I/O operation has completed, then the return status,
     as	described for read(2), write(2), and fsync(2) shall be returned. If
     the asynchronous operation	has not	yet completed, then the	results	of
     aio_return() are undefined.

     If	any of the conditions below occur, the aio_return() function shall
     return -1 and set errno to	the corresponding value.

     [EINVAL]	    The	aiocbp argument	refers to an asynchronous operation
		    whose return status	has already been retrieved.


									PPPPaaaaggggeeee 1111