.\" by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH AIO_CANCEL 3 2003-11-14 "" "Linux Programmer's Manual"
-.SH ̾Á°
-aio_cancel \- ´°Î»¤·¤Æ¤¤¤Ê¤¤ÈóƱ´ü I/O ¥ê¥¯¥¨¥¹¥È¤ò¥¥ã¥ó¥»¥ë¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+aio_cancel \- 完了していない非同期 I/O リクエストをキャンセルする
+.SH 書式
.B "#include <aio.h>"
.sp
.BI "int aio_cancel(int " fd ", struct aiocb *" aiocbp );
.sp
-\fI\-lrt\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.SH ÀâÌÀ
+\fI\-lrt\fP でリンクする。
+.SH 説明
.BR aio_cancel ()
-´Ø¿ô¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+é\96¢æ\95°ã\81¯ã\80\81ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.I fd
-¤Ë¤Ä¤¤¤Æ¤Î´°Î»¤·¤Æ¤¤¤Ê¤¤ÈóƱ´ü I/O ¥ê¥¯¥¨¥¹¥È¤ò¥¥ã¥ó¥»¥ë¤·¤è¤¦¤È¤¹¤ë¡£
+についての完了していない非同期 I/O リクエストをキャンセルしようとする。
.I aiocbp
-¤¬ NULL ¤Î¾ì¹ç¡¢¤½¤Î¤è¤¦¤ÊÁ´¤Æ¤Î¥ê¥¯¥¨¥¹¥È¤¬¥¥ã¥ó¥»¥ë¤µ¤ì¤ë¡£
+が NULL の場合、そのような全てのリクエストがキャンセルされる。
.I aiocbp
-¤¬ NULL ¤Ç¤Ê¤¤¾ì¹ç¡¢
+が NULL でない場合、
.I aiocbp
-¤Ç»Ø¤µ¤ì¤¿À©¸æ¥Ö¥í¥Ã¥¯¤Çµ½Ò¤µ¤ì¤¿¥ê¥¯¥¨¥¹¥È¤Î¤ß¤¬¥¥ã¥ó¥»¥ë¤µ¤ì¤ë¡£
+で指された制御ブロックで記述されたリクエストのみがキャンセルされる。
.LP
-¥¥ã¥ó¥»¥ë¤µ¤ì¤¿¥ê¥¯¥¨¥¹¥È¤ËÂФ·¤Æ¡¢Ä̾ï¤ÎÈóƱ´üÄÌÃΤ¬µ¯¤³¤ë¡£
-¥ê¥¯¥¨¥¹¥È¤ÎÊÖ¤êÃÍ¤Ï \-1 ¤ËÀßÄꤵ¤ì¡¢
-¥ê¥¯¥¨¥¹¥È¤Î¥¨¥é¡¼¾õÂÖ¤Ï
+キャンセルされたリクエストに対して、通常の非同期通知が起こる。
+リクエストの返り値は \-1 に設定され、
+リクエストのエラー状態は
.B ECANCELED
-¤ËÀßÄꤵ¤ì¤ë¡£
-¥¥ã¥ó¥»¥ë¤Ç¤¤Ê¤«¤Ã¤¿¥ê¥¯¥¨¥¹¥È¤ÎÀ©¸æ¥Ö¥í¥Ã¥¯¤ÏÊѹ¹¤µ¤ì¤Ê¤¤¡£
+に設定される。
+キャンセルできなかったリクエストの制御ブロックは変更されない。
.LP
.I aiocbp
-¤¬ NULL ¤Ç¤Ê¤¯¡¢¤«¤Ä
+が NULL でなく、かつ
.I fd
-¤¬ÈóƱ´üÁàºî¤¬³«»Ï¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤È°Û¤Ê¤ë¾ì¹ç¡¢
-À¸¤¸¤ë·ë²Ì¤ÏÉÔÄê¤Ç¤¢¤ë¡£
+が非同期操作が開始されたファイルディスクリプタと異なる場合、
+生じる結果は不定である。
.LP
-¤É¤ÎÁàºî¤ò¥¥ã¥ó¥»¥ë¤Ç¤¤ë¤«¤Ï¡¢¼ÂÁõÄêµÁ¤Ç¤¢¤ë¡£
-.\" FreeBSD: raw ¥Ç¥£¥¹¥¯¥Ç¥Ð¥¤¥¹¤Ø¤Î¥ê¥¯¥¨¥¹¥È¤Ï¥¥ã¥ó¥»¥ë¤Ç¤¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-Á´¤Æ¤Î¥ê¥¯¥¨¥¹¥È¤Î¥¥ã¥ó¥»¥ë¤¬À®¸ù¤·¤¿¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï
+どの操作をキャンセルできるかは、実装定義である。
+.\" FreeBSD: raw ディスクデバイスへのリクエストはキャンセルできない。
+.SH 返り値
+全てのリクエストのキャンセルが成功した場合、この関数は
.B AIO_CANCELED
-¤òÊÖ¤¹¡£
-»ØÄꤵ¤ì¤¿¥ê¥¯¥¨¥¹¥È¤Î¤¦¤Á¾¯¤Ê¤¯¤È¤â 1 ¤Ä¤¬¿Ê¹ÔÃæ¤Ç¤¢¤ë¤¿¤á¤Ë
-¥¥ã¥ó¥»¥ë¤Ç¤¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï¡¢
+を返す。
+指定されたリクエストのうち少なくとも 1 つが進行中であるために
+キャンセルできなかった場合は、
.B AIO_NOTCANCELED
-¤¬ÊÖ¤µ¤ì¤ë¡£
-¤³¤Î¾ì¹ç¤Ï¡¢
+が返される。
+この場合は、
.BR aio_error (3)
-¤ò»È¤Ã¤Æ¸Ä¡¹¤Î¥ê¥¯¥¨¥¹¥È¤Î¾õÂÖ¤ò¥Á¥§¥Ã¥¯¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
-¸Æ¤Ó½Ð¤µ¤ì¤ëÁ°¤ËÁ´¤Æ¤Î¥ê¥¯¥¨¥¹¥È¤¬´°Î»¤·¤Æ¤¤¤¿¾ì¹ç¡¢
-¤³¤Î´Ø¿ô¤Ï
+を使って個々のリクエストの状態をチェックすることができる。
+呼び出される前に全てのリクエストが完了していた場合、
+この関数は
.B AIO_ALLDONE
-¤òÊÖ¤¹¡£
-²¿¤é¤«¤Î¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ï¡¢\-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢
+を返す。
+何らかのエラーが起こった場合は、\-1 が返されて、
.I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
+が適切に設定される。
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EBADF
.I fd
-¤¬Í¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
-.SH ½àµò
+が有効なファイルディスクリプタでない。
+.SH 準拠
POSIX.1-2001.
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR aio_error (3),
.BR aio_fsync (3),
.BR aio_read (3),
OSDN Git Service
