manual/LDP_man-pages/draft/man3/aio_error.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 Sat Jul  3 05:28:09 JST 2004
  26 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  27 .\"
  28 .TH AIO_ERROR 3 2003-11-14  "" "Linux Programmer's Manual"
  29 .\"O .SH NAME
  30 .SH Ì¾Á°
  31 .\"O aio_error \- get error status of asynchronous I/O operation
  32 aio_error \- ÈóÆ±´ü I/O Áàºî¤Î¥¨¥é¡¼¾õÂÖ¤ò¼èÆÀ¤¹¤ë
  33 .\"O .SH SYNOPSIS
  34 .SH ½ñ¼°
  35 .B "#include <aio.h>"
  36 .sp
  37 .BI "int aio_error(const 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_error ()
  45 .\"O function returns the error status for the asynchronous I/O request
  46 .\"O with control block pointed to by
  47 .\"O .IR aiocbp .
  48 .BR aio_error ()
  49 ´Ø¿ô¤Ï
  50 .I aiocbp
  51 ¤Ç»Ø¤µ¤ì¤¿À©¸æ¥Ö¥í¥Ã¥¯¤Ç¤ÎÈóÆ±´ü I/O ¥ê¥¯¥¨¥¹¥È¤Î¥¨¥é¡¼¾õÂÖ¤òÊÖ¤¹¡£
  52 .\"O .SH "RETURN VALUE"
  53 .SH ÊÖ¤êÃÍ
  54 .\"O This function returns
  55 .\"O .B EINPROGRESS
  56 .\"O if the request has not been
  57 .\"O completed yet.
  58 .\"O It returns
  59 .\"O .B ECANCELED
  60 .\"O if the request was canceled.
  61 .\"O It returns 0 if the request completed successfully.
  62 ¥ê¥¯¥¨¥¹¥È¤¬¤Þ¤À´°Î»¤·¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï
  63 .B EINPROGRESS
  64 ¤òÊÖ¤¹¡£¥ê¥¯¥¨¥¹¥È¤¬¥¥ã¥ó¥»¥ë¤µ¤ì¤¿¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï
  65 .B ECANCELED
  66 ¤òÊÖ¤¹¡£¥ê¥¯¥¨¥¹¥È¤¬À®¸ù¤·¤Æ´°Î»¤·¤¿¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï 0 ¤òÊÖ¤¹¡£
  67 .\"O Otherwise an error value is returned, the same value that would have
  68 .\"O been stored in the
  69 .\"O .I errno
  70 .\"O variable in case of a synchronous
  71 .\"O .IR read ,
  72 .\"O .IR write ,
  73 .\"O .IR fsync ,
  74 .\"O or
  75 .\"O .I fdatasync
  76 .\"O request.
  77 ¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï¥¨¥é¡¼ÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
  78 ¤³¤Î¥¨¥é¡¼ÃÍ¤Ï¡¢Æ±´ü
  79 .IR read ,
  80 .IR write ,
  81 .IR fsync ,
  82 .I fdatasync
  83 ¥ê¥¯¥¨¥¹¥È¤Î¾ì¹ç¤Ë
  84 .I errno
  85 ¤Ë³ÊÇ¼¤µ¤ì¤ë¤Î¤ÈÆ±¤¸ÃÍ¤Ç¤¢¤ë¡£
  86 .\"O On error, the error value is returned.
  87 ¥¨¥é¡¼¤Î¾ì¹ç¤Ï¥¨¥é¡¼ÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
  88 .\"O .SH ERRORS
  89 .SH ¥¨¥é¡¼
  90 .TP
  91 .B EINVAL
  92 .\"O .I aiocbp
  93 .\"O does not point at a control block for an asynchronous I/O request
  94 .\"O of which the return status (see
  95 .\"O .BR aio_return (3))
  96 .\"O has not been retrieved yet.
  97 .I aiocbp
  98 ¤¬¡¢¤Þ¤ÀÊÖ¤êÃÍ (return status)
  99 .RB ( aio_return (3)
 100 ¤ò»²¾È) ¤¬¼èÆÀ¤µ¤ì¤Æ¤¤¤Ê¤¤ÈóÆ±´ü I/O ¥ê¥¯¥¨¥¹¥È¤ÎÀ©¸æ¥Ö¥í¥Ã¥¯¤ò»Ø¤·¤Æ¤¤¤Ê¤¤¡£
 101 .\"O .SH "CONFORMING TO"
 102 .SH ½àµò
 103 POSIX.1-2001.
 104 .\"O .SH "SEE ALSO"
 105 .SH ´ØÏ¢¹àÌÜ
 106 .BR aio_cancel (3),
 107 .BR aio_fsync (3),
 108 .BR aio_read (3),
 109 .BR aio_return (3),
 110 .BR aio_suspend (3),
 111 .BR aio_write (3)