man3/aio_return.3

   1 .\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" The GNU General Public License's references to "object code"
   9 .\" and "executables" are to be interpreted as the output of any
  10 .\" document formatting or typesetting system, including
  11 .\" intermediate and printed output.
  12 .\"
  13 .\" This manual is distributed in the hope that it will be useful,
  14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 .\" GNU General Public License for more details.
  17 .\"
  18 .\" You should have received a copy of the GNU General Public
  19 .\" License along with this manual; if not, write to the Free
  20 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  21 .\" USA.
  22 .\"
  23 .TH AIO_RETURN 3 2003-11-14  "" "Linux Programmer's Manual"
  24 .SH NAME
  25 aio_return \- get return status of asynchronous I/O operation
  26 .SH SYNOPSIS
  27 .sp
  28 .B "#include <aio.h>"
  29 .sp
  30 .BI "ssize_t aio_return(struct aiocb *" aiocbp );
  31 .sp
  32 .SH DESCRIPTION
  33 The
  34 .B aio_return
  35 function returns the final return status for the asynchronous I/O request
  36 with control block pointed to by
  37 .IR aiocbp .
  38 .LP
  39 This function should be called only once for any given request, after
  40 .BR aio_error (3)
  41 returns something other than EINPROGRESS.
  42 .SH "RETURN VALUE"
  43 If the asynchronous I/O operation has completed, this function returns
  44 the value that would have been returned in case of a synchronous
  45 .IR read ,
  46 .IR write ,
  47 or
  48 .IR fsync
  49 request.
  50 Otherwise the return value is undefined.
  51 On error, the error value is returned.
  52 .SH ERRORS
  53 .TP
  54 .B EINVAL
  55 .I aiocbp
  56 does not point at a control block for an asynchronous I/O request
  57 of which the return status has not been retrieved yet.
  58 .SH "CONFORMING TO"
  59 POSIX 1003.1-2003
  60 .SH "SEE ALSO"
  61 .BR aio_cancel (3),
  62 .BR aio_error (3),
  63 .BR aio_fsync (3),
  64 .BR aio_read (3),
  65 .BR aio_suspend (3),
  66 .BR aio_write (3)