draft/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 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
  24 .\"         all rights reserved.
  25 .\" Translated Fri Jul  9 05:07:19 JST 2004
  26 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  27 .\"
  28 .TH AIO_RETURN 3 2003-11-14  "" "Linux Programmer's Manual"
  29 .\"O .SH NAME
  30 .SH Ì¾Á°
  31 .\"O aio_return \- get return status of asynchronous I/O operation
  32 aio_return \- ÈóÆ±´ü I/O Áàºî¤ÎÊÖ¤êÃÍ (return status) ¤ò¼èÆÀ¤¹¤ë
  33 .\"O .SH SYNOPSIS
  34 .SH ½ñ¼°
  35 .B "#include <aio.h>"
  36 .sp
  37 .BI "ssize_t aio_return(struct aiocb *" aiocbp );
  38 .sp
  39 .\"O Link with \fI\-lrt\fP.
  40 \fI\-lrt\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
  41 .\"O .SH DESCRIPTION
  42 .SH ÀâÌÀ
  43 .\"O The
  44 .\"O .BR aio_return ()
  45 .\"O function returns the final return status for the asynchronous I/O request
  46 .\"O with control block pointed to by
  47 .\"O .IR aiocbp .
  48 .BR aio_return ()
  49 ´Ø¿ô¤Ï
  50 .I aiocbp
  51 ¤Ç»Ø¤µ¤ì¤¿À©¸æ¥Ö¥í¥Ã¥¯¤Ë¤ª¤±¤ëÈóÆ±´ü I/O ¥ê¥¯¥¨¥¹¥È¤ÎºÇ½ªÅª¤ÊÊÖ¤êÃÍ¤òÊÖ¤¹¡£
  52 .LP
  53 .\"O This function should be called only once for any given request, after
  54 .\"O .BR aio_error (3)
  55 .\"O returns something other than
  56 .\"O .B EINPROGRESS.
  57 ¤³¤Î´Ø¿ô¤Ï¡¢
  58 .BR aio_error (3)
  59 ¤¬
  60 .B EINPROGRESS
  61 °Ê³°¤òÊÖ¤·¤¿¸å¤Ç¡¢
  62 Í¿¤¨¤é¤ì¤¿¥ê¥¯¥¨¥¹¥È¤ËÂÐ¤·¤Æ 1 ²ó¤À¤±¸Æ¤Ð¤ì¤ë¤Ù¤¤Ç¤¢¤ë¡£
  63 .\"O .SH "RETURN VALUE"
  64 .SH ÊÖ¤êÃÍ
  65 .\"O If the asynchronous I/O operation has completed, this function returns
  66 .\"O the value that would have been returned in case of a synchronous
  67 .\"O .IR read ,
  68 .\"O .IR write ,
  69 .\"O or
  70 .\"O .I fsync
  71 .\"O request.
  72 ÈóÆ±´ü I/O Áàºî¤¬´°Î»¤·¤¿¾ì¹ç¡¢¤³¤Î´Ø¿ô¤ÏÆ±´ü
  73 .IR read ,
  74 .IR write ,
  75 .I fsync
  76 ¥ê¥¯¥¨¥¹¥È¤Î¤È¤¤ËÊÖ¤µ¤ì¤ë¤Î¤ÈÆ±¤¸ÃÍ¤òÊÖ¤¹¡£
  77 .\"O Otherwise the return value is undefined.
  78 ¤½¤ì°Ê³°¤Î¾ì¹ç¡¢ÊÖ¤êÃÍ¤ÏÌ¤ÄêµÁ¤Ç¤¢¤ë¡£
  79 .\"O On error, the error value is returned.
  80 ¥¨¥é¡¼¤Î¾ì¹ç¡¢¥¨¥é¡¼ÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
  81 .\"O .SH ERRORS
  82 .SH ¥¨¥é¡¼
  83 .TP
  84 .B EINVAL
  85 .\"O .I aiocbp
  86 .\"O does not point at a control block for an asynchronous I/O request
  87 .\"O of which the return status has not been retrieved yet.
  88 .I aiocbp
  89 ¤¬¡¢ÊÖ¤êÃÍ¤¬¤Þ¤À¼èÆÀ¤µ¤ì¤Æ¤¤¤Ê¤¤ÈóÆ±´ü I/O ¥ê¥¯¥¨¥¹¥È¤Î
  90 À©¸æ¥Ö¥í¥Ã¥¯¤ò»Ø¤·¤Æ¤¤¤Ê¤¤¡£
  91 .\"O .SH "CONFORMING TO"
  92 .SH ½àµò
  93 POSIX.1-2001.
  94 .\"O .SH "SEE ALSO"
  95 .SH ´ØÏ¢¹àÌÜ
  96 .BR aio_cancel (3),
  97 .BR aio_error (3),
  98 .BR aio_fsync (3),
  99 .BR aio_read (3),
 100 .BR aio_suspend (3),
 101 .BR aio_write (3)