Mac Developer Library Developer
Search

 

This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




AIO_RETURN(2)               BSD System Calls Manual              AIO_RETURN(2)

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

LIBRARY
     Standard C Library (libc, -lc)

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 aio_error(2) returns something other than EINPROGRESS) and to clean up system
     resources. However, if aio_return() is not called at all, aio(4) will leak resources.

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, aio_return() returns -1 and sets errno to indicate the error condi-tion. condition.
     tion.

ERRORS
     The aio_return() system call will fail if:

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

     [EINPROGRESS]      The asynchronous I/O request is still in progress.

LEGACY SYNOPSIS
     #include <aio.h>

     int
     aio_return(struct aiocb *aiocbp);

     The type of the return value has changed.

SEE ALSO
     aio_cancel(2), aio_error(2), aio_suspend(2), aio_write(2), fsync(2), read(2), write(2), aio(4),
     compat(5)

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

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

AUTHORS
     This manual page was written by Wes Peters <wes@softweyr.com>.

BSD                           September 26, 2008                           BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback