aio_return(3) [netbsd man page]

AIO_RETURN(3)						   BSD Library Functions Manual 					     AIO_RETURN(3)

NAME

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

LIBRARY

     POSIX Real-time Library (librt, -lrt)

SYNOPSIS

     #include <aio.h>

     ssize_t
     aio_return(struct aiocb *aiocbp);

DESCRIPTION

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

     The 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_error(3) 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).  Otherwise,
     aio_return() returns -1 and sets errno to indicate the error condition.

ERRORS

     The aio_return() system call will fail if:

     [EINVAL]		The aiocbp argument does not reference a completed asynchronous I/O request.

SEE ALSO

     fsync(2), read(2), write(2), aio(3)

STANDARDS

     The aio_return() system call is expected to conform to the IEEE Std 1003.1-2001 (``POSIX.1'') standard.

HISTORY

     The aio_return() system call first appeared in NetBSD 5.0.

BSD
								  August 13, 2011							       BSD

AIO_RETURN(3)						     Linux Programmer's Manual						     AIO_RETURN(3)

NAME

       aio_return - get return status of asynchronous I/O operation

SYNOPSIS

       #include <aio.h>

       ssize_t aio_return(struct aiocb *aiocbp);

       Link with -lrt.

DESCRIPTION

       The  aio_return()  function returns the final return status for the asynchronous I/O request with control block pointed to by aiocbp.  (See
       aio(7) for a description of the aiocb structure.)

       This function should be called only once for any given request, after aio_error(3) returns something other than EINPROGRESS.

RETURN VALUE

       If the asynchronous I/O operation has completed, this function returns the value that would have been returned in  case	of  a  synchronous
       read(2), write(2), fsync(2) or fdatasync(2), call.

       If the asynchronous I/O operation has not yet completed, the return value and effect of aio_return() are undefined.

ERRORS

       EINVAL aiocbp does not point at a control block for an asynchronous I/O request of which the return status has not been retrieved yet.

       ENOSYS aio_return() is not implemented.

VERSIONS

       The aio_return() function is available since glibc 2.1.

CONFORMING TO

       POSIX.1-2001, POSIX.1-2008.

EXAMPLE

       See aio(7).

SEE ALSO

       aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7)

COLOPHON

       This  page is part of release 3.44 of the Linux man-pages project.  A description of the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

								    2012-05-08							     AIO_RETURN(3)