*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> aio_return (3)              



NAME    [Toc]    [Back]

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

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
[ Back ]
 Similar pages
Name OS Title
aio_return HP-UX return status of an asynchronous I/O operation
aio_error Tru64 Returns the error status of a specified asynchronous I/O operation (P1003.1b)
aio_error FreeBSD retrieve error status of asynchronous I/O operation (REALTIME)
aio_return FreeBSD retrieve return status of asynchronous I/O operation (REALTIME)
aio_return Tru64 Returns the status of an asynchronous I/O operation (P1003.1b)
tt_int_error HP-UX return the status of an error object
aio_cancel HP-UX cancel an asynchronous I/O operation
aio_suspend HP-UX wait for an asynchronous I/O operation to complete
aio_read HP-UX start an asynchronous read operation
aio_write HP-UX start asynchronous write operation
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service