OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man3 / aio_cancel.3
index add8196..dacd00e 100644 (file)
 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
 .\" USA.
 .\"
-.\" Japanese Version Copyright (c) 2004 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated Thu Jul 01 02:44:30 JST 2004
-.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
+.\"*******************************************************************
 .\"
-.TH AIO_CANCEL 3 2003-11-14  "" "Linux Programmer's Manual"
-.SH Ì¾Á°
-aio_cancel \- ´°Î»¤·¤Æ¤¤¤Ê¤¤ÈóƱ´ü I/O ¥ê¥¯¥¨¥¹¥È¤ò¥­¥ã¥ó¥»¥ë¤¹¤ë
-.SH ½ñ¼°
-.B "#include <aio.h>"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH AIO_CANCEL 3 2011\-10\-04 "" "Linux Programmer's Manual"
+.SH 名前
+aio_cancel \- 完了していない非同期 I/O リクエストをキャンセルする
+.SH 書式
+\fB#include <aio.h>\fP
 .sp
-.BI "int aio_cancel(int " fd ", struct aiocb *" aiocbp );
+\fBint aio_cancel(int \fP\fIfd\fP\fB, struct aiocb *\fP\fIaiocbp\fP\fB);\fP
 .sp
-\fI\-lrt\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.SH ÀâÌÀ
-.BR aio_cancel ()
-´Ø¿ô¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤Ë¤Ä¤¤¤Æ¤Î´°Î»¤·¤Æ¤¤¤Ê¤¤ÈóƱ´ü I/O ¥ê¥¯¥¨¥¹¥È¤ò¥­¥ã¥ó¥»¥ë¤·¤è¤¦¤È¤¹¤ë¡£
-.I aiocbp
-¤¬ NULL ¤Î¾ì¹ç¡¢¤½¤Î¤è¤¦¤ÊÁ´¤Æ¤Î¥ê¥¯¥¨¥¹¥È¤¬¥­¥ã¥ó¥»¥ë¤µ¤ì¤ë¡£
-.I aiocbp
-¤¬ NULL ¤Ç¤Ê¤¤¾ì¹ç¡¢
-.I aiocbp
-¤Ç»Ø¤µ¤ì¤¿À©¸æ¥Ö¥í¥Ã¥¯¤Çµ­½Ò¤µ¤ì¤¿¥ê¥¯¥¨¥¹¥È¤Î¤ß¤¬¥­¥ã¥ó¥»¥ë¤µ¤ì¤ë¡£
+\fI\-lrt\fP でリンクする。
+.SH 説明
+\fBaio_cancel\fP() 関数は、ファイルディスクリプタ \fIfd\fP についての完了していない
+非同期 I/O リクエストをキャンセルしようとする。 \fIaiocbp\fP が NULL の場合、そ
+のような全てのリクエストがキャンセルされる。 \fIaiocbp\fP が NULL でない場合、
+\fIaiocbp\fP で指された制御ブロックで記述されたリクエストのみがキャンセルされる。
+(\fIaiocb\fP 構造体の説明は \fBaio\fP(7) を参照)
 .LP
-¥­¥ã¥ó¥»¥ë¤µ¤ì¤¿¥ê¥¯¥¨¥¹¥È¤ËÂФ·¤Æ¡¢Ä̾ï¤ÎÈóƱ´üÄÌÃΤ¬µ¯¤³¤ë¡£
-¥ê¥¯¥¨¥¹¥È¤ÎÊÖ¤êÃͤϠ\-1 ¤ËÀßÄꤵ¤ì¡¢
-¥ê¥¯¥¨¥¹¥È¤Î¥¨¥é¡¼¾õÂÖ¤Ï
-.B ECANCELED
-¤ËÀßÄꤵ¤ì¤ë¡£
-¥­¥ã¥ó¥»¥ë¤Ç¤­¤Ê¤«¤Ã¤¿¥ê¥¯¥¨¥¹¥È¤ÎÀ©¸æ¥Ö¥í¥Ã¥¯¤ÏÊѹ¹¤µ¤ì¤Ê¤¤¡£
+キャンセルされたリクエストに対して、通常の非同期通知が起こる。
+リクエストの返り値 (\fBaio_return\fP(3)) は \-1 に設定され、
+リクエストのエラー状態 (\fBaio_error\fP(3)) は \fBECANCELED\fP に設定される。
+キャンセルできないリクエストの制御ブロックは変更されない。
 .LP
-.I aiocbp
-¤¬ NULL ¤Ç¤Ê¤¯¡¢¤«¤Ä
-.I fd
-¤¬ÈóƱ´üÁàºî¤¬³«»Ï¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤È°Û¤Ê¤ë¾ì¹ç¡¢
-À¸¤¸¤ë·ë²Ì¤ÏÉÔÄê¤Ç¤¢¤ë¡£
+\fIaiocbp\fP が NULL でなく、かつ \fIfd\fP が非同期操作が開始されたファイルディスクリプタと異なる場合、 生じる結果は不定である。
 .LP
-¤É¤ÎÁàºî¤ò¥­¥ã¥ó¥»¥ë¤Ç¤­¤ë¤«¤Ï¡¢¼ÂÁõÄêµÁ¤Ç¤¢¤ë¡£
-.\" FreeBSD: raw ¥Ç¥£¥¹¥¯¥Ç¥Ð¥¤¥¹¤Ø¤Î¥ê¥¯¥¨¥¹¥È¤Ï¥­¥ã¥ó¥»¥ë¤Ç¤­¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-Á´¤Æ¤Î¥ê¥¯¥¨¥¹¥È¤Î¥­¥ã¥ó¥»¥ë¤¬À®¸ù¤·¤¿¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï
-.B AIO_CANCELED
-¤òÊÖ¤¹¡£
-»ØÄꤵ¤ì¤¿¥ê¥¯¥¨¥¹¥È¤Î¤¦¤Á¾¯¤Ê¤¯¤È¤â 1 ¤Ä¤¬¿Ê¹ÔÃæ¤Ç¤¢¤ë¤¿¤á¤Ë
-¥­¥ã¥ó¥»¥ë¤Ç¤­¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï¡¢
-.B AIO_NOTCANCELED
-¤¬ÊÖ¤µ¤ì¤ë¡£
-¤³¤Î¾ì¹ç¤Ï¡¢
-.BR aio_error (3)
-¤ò»È¤Ã¤Æ¸Ä¡¹¤Î¥ê¥¯¥¨¥¹¥È¤Î¾õÂÖ¤ò¥Á¥§¥Ã¥¯¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-¸Æ¤Ó½Ð¤µ¤ì¤ëÁ°¤ËÁ´¤Æ¤Î¥ê¥¯¥¨¥¹¥È¤¬´°Î»¤·¤Æ¤¤¤¿¾ì¹ç¡¢
-¤³¤Î´Ø¿ô¤Ï
-.B AIO_ALLDONE
-¤òÊÖ¤¹¡£
-²¿¤é¤«¤Î¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ï¡¢\-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢
-.I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EBADF
-.I fd
-¤¬Í­¸ú¤Ê¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
-.SH ½àµò
-POSIX.1-2001.
-.SH ´ØÏ¢¹àÌÜ
-.BR aio_error (3),
-.BR aio_fsync (3),
-.BR aio_read (3),
-.BR aio_return (3),
-.BR aio_suspend (3),
-.BR aio_write (3)
+.\" FreeBSD: not those on raw disk devices.
+どの操作をキャンセルできるかは、実装定義である。
+.SH 返り値
+全てのリクエストのキャンセルが成功した場合、この関数は \fBAIO_CANCELED\fP を返す。 指定されたリクエストのうち少なくとも 1
+つが進行中であるために キャンセルできなかった場合は、 \fBAIO_NOTCANCELED\fP が返される。 この場合は、 \fBaio_error\fP(3)
+を使って個々のリクエストの状態をチェックすることができる。 呼び出される前に全てのリクエストが完了していた場合、 この関数は
+\fBAIO_ALLDONE\fP を返す。 何らかのエラーが起こった場合は、\-1 が返されて、 \fIerrno\fP が適切に設定される。
+.SH エラー
+.TP 
+\fBEBADF\fP
+\fIfd\fP が有効なファイルディスクリプタでない。
+.SH バージョン
+\fBaio_cancel\fP() 関数は glibc 2.1 以降で利用できる。
+.SH 準拠
+POSIX.1\-2001, POSIX.1\-2008.
+.SH 例
+\fBaio\fP(7) を参照。
+.SH 関連項目
+\fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3),
+\fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\fP(7)