]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/aio_return.3
Removed trailing white space at end of lines
[thirdparty/man-pages.git] / man3 / aio_return.3
index 5a0d581caa811aea696770b11caea8de6e5a566a..237e569e814c26e0991013eae98b817b13020337 100644 (file)
@@ -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
 .\" 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 2010-10-03  "" "Linux Programmer's Manual"
+.TH AIO_RETURN 3 2017-09-15  "" "Linux Programmer's Manual"
 .SH NAME
 aio_return \- get return status of asynchronous I/O operation
 .SH SYNOPSIS
 .B "#include <aio.h>"
-.sp
+.PP
 .BI "ssize_t aio_return(struct aiocb *" aiocbp );
-.sp
+.PP
 Link with \fI\-lrt\fP.
 .SH DESCRIPTION
 The
@@ -40,12 +41,12 @@ with control block pointed to by
 for a description of the
 .I aiocb
 structure.)
-.LP
+.PP
 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
 .BR read (2),
@@ -54,7 +55,8 @@ the value that would have been returned in case of a synchronous
 or
 .BR fdatasync (2),
 call.
-
+On error, \-1 is returned, and \fIerrno\fP is set appropriately.
+.PP
 If the asynchronous I/O operation has not yet completed,
 the return value and effect of
 .BR aio_return ()
@@ -65,16 +67,32 @@ are undefined.
 .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.
+.TP
+.B ENOSYS
+.BR aio_return ()
+is not implemented.
 .SH VERSIONS
 The
 .BR aio_return ()
 function is available since glibc 2.1.
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR aio_return ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
 .SH EXAMPLE
 See
 .BR aio (7).
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR aio_cancel (3),
 .BR aio_error (3),
 .BR aio_fsync (3),