(split) LDP: Update original to LDP v3.65

[linuxjm/LDP_man-pages.git] / original / man3 / aio_return.3

diff --git a/original/man3/aio_return.3 b/original/man3/aio_return.3
index 076798a..c2b6c8c 100644 (file)
--- a/original/man3/aio_return.3
+++ b/original/man3/aio_return.3
@@ -1,5 +1,6 @@
 .\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
@@ -16,11 +17,11 @@
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
-.TH AIO_RETURN 3 2003-11-14  "" "Linux Programmer's Manual"
+.TH AIO_RETURN 3 2013-07-04  "" "Linux Programmer's Manual"
 .SH NAME
 aio_return \- get return status of asynchronous I/O operation
 .SH SYNOPSIS
@@ -35,33 +36,68 @@ The
 function returns the final return status for the asynchronous I/O request
 with control block pointed to by
 .IR aiocbp .
+(See
+.BR aio (7)
+for a description of the
+.I aiocb
+structure.)
 .LP
 This function should be called only once for any given request, after
 .BR aio_error (3)
 returns something other than
 .BR EINPROGRESS .
-.SH "RETURN VALUE"
+.SH 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
-.IR read ,
-.IR write ,
+.BR read (2),
+.BR write (2),
+.BR fsync (2)
 or
-.I fsync
-request.
-Otherwise the return value is undefined.
-On error, the error value is returned.
+.BR fdatasync (2),
+call.
+
+If the asynchronous I/O operation has not yet completed,
+the return value and effect of
+.BR aio_return ()
+are undefined.
 .SH ERRORS
 .TP
 .B EINVAL
 .I aiocbp
 does not point at a control block for an asynchronous I/O request
 of which the return status has not been retrieved yet.
-.SH "CONFORMING TO"
-POSIX.1-2001.
-.SH "SEE ALSO"
+.TP
+.B ENOSYS
+.BR aio_return ()
+is not implemented.
+.SH VERSIONS
+The
+.BR aio_return ()
+function is available since glibc 2.1.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR aio_return ()
+function is thread-safe.
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008.
+.SH EXAMPLE
+See
+.BR aio (7).
+.SH SEE ALSO
 .BR aio_cancel (3),
 .BR aio_error (3),
 .BR aio_fsync (3),
 .BR aio_read (3),
 .BR aio_suspend (3),
-.BR aio_write (3)
+.BR aio_write (3),
+.BR lio_listio (3),
+.BR aio (7)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.