release/man2/io_cancel.2

   1 .\" Copyright (C) 2003 Free Software Foundation, Inc.
   2 .\" This file is distributed according to the GNU General Public License.
   3 .\" See the file COPYING in the top level source directory for details.
   4 .\"
   5 .\" Japanese Version Copyright (c) 2003 Akihiro MOTOKI, all rights reserved.
   6 .\" Translated Mon Mar  8 2003 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   7 .\"
   8 .\"WORD:        operation       Áàºî
   9 .\"WORD:        completion queue        ´°Î»¥¥å¡¼
  10 .\"
  11 .\" .de Sh \" Subsection
  12 .\" .br
  13 .\" .if t .Sp
  14 .\" .ne 5
  15 .\" .PP
  16 .\" \fB\\$1\fP
  17 .\" .PP
  18 .\" ..
  19 .\" .de Sp \" Vertical space (when we can't use .PP)
  20 .\" .if t .sp .5v
  21 .\" .if n .sp
  22 .\" ..
  23 .\" .de Ip \" List item
  24 .\" .br
  25 .\" .ie \\n(.$>=3 .ne \\$3
  26 .\" .el .ne 3
  27 .\" .IP "\\$1" \\$2
  28 .\" ..
  29 .TH IO_CANCEL 2 2008-06-18 "Linux" "Linux Programmer's Manual"
  30 .SH Ì¾Á°
  31 io_cancel \- Ì¤½èÍý¤ÎÈóÆ±´ü I/O Áàºî¤Î¼è¤ê¾Ã¤·
  32 .SH ½ñ¼°
  33 .nf
  34 .\" .ad l
  35 .\" .hy 0
  36 .\"
  37 .B #include <libaio.h>
  38 .\"#include <linux/aio.h>
  39 .sp
  40 .\" .HP 16
  41 .BI "int io_cancel(aio_context_t " ctx_id ", struct iocb *" iocb ,
  42 .BI "              struct io_event *" result );
  43 .\" .ad
  44 .\" .hy
  45 .sp
  46 \fI\-laio\fP ¤È¥ê¥ó¥¯¤¹¤ë¡£
  47 .fi
  48 .SH ÀâÌÀ
  49 .PP
  50 .BR io_cancel ()
  51 ¤Ï¡¢²áµî¤Ë
  52 .BR io_submit (2)
  53 ¤ò»È¤Ã¤ÆÅÐÏ¿¤µ¤ì¤¿ÈóÆ±´ü I/O (AIO) Áàºî¤Î¼è¤ê¾Ã¤·¤ò¹Ô¤ª¤¦¤È¤¹¤ë¡£
  54 \fIctx_id\fP ¤Ï¡¢¼è¤ê¾Ã¤·¤ò¹Ô¤¦Áàºî¤Î AIO ¥³¥ó¥Æ¥¥¹¥È¤Î ID ¤Ç¤¢¤ë¡£
  55 »ØÄê¤·¤¿ AIO ¥³¥ó¥Æ¥¥¹¥È¤¬¸«¤Ä¤«¤ë¤È¡¢
  56 ÂÐ¾Ý¤Î¥¤¥Ù¥ó¥È¤Î¼è¤ê¾Ã¤·¤¬¹Ô¤ï¤ì¡¢¤½¤Î¸å \fIresult\fP ¤Ç»Ø¤µ¤ì¤¿¥á¥â¥ê¤Ë
  57 ¥³¥Ô¡¼¤µ¤ì¤ë (¤³¤Î¤È¤¡¢´°Î»¥¥å¡¼¤Ø¤Î°ÜÆ°¤Ï¹Ô¤ï¤ì¤Ê¤¤)¡£
  58 .SH ÊÖ¤êÃÍ
  59 À®¸ù¤·¤¿¾ì¹ç¡¢
  60 .BR io_cancel ()
  61 ¤Ï 0 ¤òÊÖ¤¹¡£
  62 ¼ºÇÔ»þ¤ÎÊÖ¤êÃÍ¤Ë¤Ä¤¤¤Æ¤Ï¡¢¡ÖÃí°Õ¡×¤ÎÀá¤ò»²¾È¤¹¤ë¤³¤È¡£
  63 .SH ¥¨¥é¡¼
  64 .TP
  65 .B EAGAIN
  66 »ØÄê¤µ¤ì¤¿ \fIiocb\fP ¤Î¼è¤ê¾Ã¤·¤¬¹Ô¤ï¤ì¤Ê¤«¤Ã¤¿¡£
  67 .TP
  68 .B EFAULT
  69 ¥Ç¡¼¥¿¹½Â¤¤ÎÃæ¤ËÌµ¸ú¤Ê¥Ç¡¼¥¿¤ò»Ø¤·¤Æ¤¤¤ë¤â¤Î¤¬¤¢¤ë¡£
  70 .TP
  71 .B EINVAL
  72 \fIctx_id\fP ¤Ç»ØÄê¤µ¤ì¤¿ AIO ¥³¥ó¥Æ¥¥¹¥È¤¬Ìµ¸ú¤Ç¤¢¤ë¡£
  73 .TP
  74 .B ENOSYS
  75 .BR io_cancel ()
  76 ¤Ï¤³¤Î¥¢¡¼¥¥Æ¥¯¥Á¥ã¤Ç¤Ï¼ÂÁõ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
  77 .SH ¥Ð¡¼¥¸¥ç¥ó
  78 .PP
  79 ÈóÆ±´ü I/O ¥·¥¹¥Æ¥à¡¦¥³¡¼¥ë¤Ï 2002Ç¯8·î¤Ë Linux 2.5 ¤Ç½é¤á¤ÆÅÐ¾ì¤·¤¿¡£
  80 .SH ½àµò
  81 .PP
  82 .BR io_cancel ()
  83 ¤Ï Linux ¸ÇÍ¤Ç¤¢¤ê¡¢°Ü¿¢¤òÁÛÄê¤·¤¿¥×¥í¥°¥é¥à¤Ç»ÈÍÑ¤¹¤Ù¤¤Ç¤Ï¤Ê¤¤¡£
  84 .SH Ãí°Õ
  85 glibc ¤Ï¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ëÍÑ¤Î¥é¥Ã¥Ñ¡¼´Ø¿ô¤òÄó¶¡¤·¤Æ¤¤¤Ê¤¤¡£
  86
  87 .I libaio
  88 ¤Ç
  89 .BR io_cancel ()
  90 ÍÑ¤ËÄó¶¡¤µ¤ì¤Æ¤¤¤ë¥é¥Ã¥Ñ¡¼´Ø¿ô¤Ï¡¢¥¨¥é¡¼¤ÎÄÌÃÎ¤¬ÄÌ¾ï¤Î C ¥é¥¤¥Ö¥é¥ê¤Î
  91 ´·½¬¤Ë¤·¤¿¤¬¤Ã¤Æ¤ª¤é¤º¡¢¥¨¥é¡¼¤Î¾ì¹ç¤Ë¤ÏÉé¤Î¥¨¥é¡¼ÈÖ¹æ
  92 (¥¨¥é¡¼¤ÎÀá¤ËÎóµó¤µ¤ì¤Æ¤¤¤ëÃÍ¤Î°ì¤Ä¤òÉé¤Ë¤·¤¿¤â¤Î) ¤¬ÊÖ¤êÃÍ¤È¤Ê¤ë¡£
  93 .BR syscall (2)
  94 ·ÐÍ³¤Ç¥·¥¹¥Æ¥à¥³¡¼¥ë¤òµ¯Æ°¤¹¤ë¤È¡¢ÊÖ¤êÃÍ¤ÏÄÌ¾ï¤Î¥¨¥é¡¼ÄÌÃÎ¤Î´·½¬¤Ë
  95 ¤·¤¿¤¬¤Ã¤Æ¤â¤Î¤È¤Ê¤ê¡¢¥¨¥é¡¼¤Î¾ì¹ç¤Ë¤Ï \-1 ¤¬ÊÖ¤ê¡¢
  96 .I errno
  97 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ (Àµ¤Î) ÃÍ¤¬ÀßÄê¤µ¤ì¤ë¡£
  98 .SH ´ØÏ¢¹àÌÜ
  99 .BR io_destroy (2),
 100 .BR io_getevents (2),
 101 .BR io_setup (2),
 102 .BR io_submit (2)
 103 .\" .SH Ãí
 104 .\" .PP
 105 .\" ÈóÆ±´ü I/O ¥·¥¹¥Æ¥à¡¦¥³¡¼¥ë¤Ï Benjamin LaHaise ¤¬½ñ¤¤¤¿¡£
 106 .\" .SH Ãø¼Ô
 107 .\" Kent Yoder.