.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
.\"
-.\" 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"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH AIO_CANCEL 3 2012\-05\-08 "" "Linux Programmer's Manual"
.SH 名前
aio_cancel \- 完了していない非同期 I/O リクエストをキャンセルする
.SH 書式
-.B "#include <aio.h>"
+\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
-で指された制御ブロックで記述されたリクエストのみがキャンセルされる。
+\fBaio_cancel\fP() 関数は、ファイルディスクリプタ \fIfd\fP についての完了して
+いない非同期 I/O リクエストをキャンセルしようとする。 \fIaiocbp\fP が
+NULL の場合、そのような全てのリクエストがキャンセルされる。 \fIaiocbp\fP
+が NULL でない場合、\fIaiocbp\fP で指された制御ブロックで記述されたリクエ
+ストのみがキャンセルされる。(\fIaiocb\fP 構造体の説明は \fBaio\fP(7) を参照)
+.LP
+キャンセルされたリクエストに対して、通常の非同期通知が起こる
+(\fBaio\fP(7) と \fBsigevent\fP(7) を参照)。
+リクエストの返り値 (\fBaio_return\fP(3)) は \-1 に設定され、
+リクエストのエラー状態 (\fBaio_error\fP(3)) は \fBECANCELED\fP に設定される。
+キャンセルできないリクエストの制御ブロックは変更されない。
.LP
-キャンセルされたリクエストに対して、通常の非同期通知が起こる。
-リクエストの返り値は \-1 に設定され、
-リクエストのエラー状態は
-.B ECANCELED
-に設定される。
-キャンセルできなかったリクエストの制御ブロックは変更されない。
+リクエストがキャンセルできない場合には、
+\fBaio_cancel\fP() は通常の I/O 操作の実行後と同じように終了する。
+(この場合、 \fBaio_error\fP(3) はステータス \fBEINPROGRESSS\fP を返す)。
.LP
-.I aiocbp
-が NULL でなく、かつ
-.I fd
-が非同期操作が開始されたファイルディスクリプタと異なる場合、
-生じる結果は不定である。
+\fIaiocbp\fP が NULL でなく、かつ \fIfd\fP が非同期操作が開始されたファイルディスクリプタと異なる場合、 生じる結果は不定である。
.LP
+.\" FreeBSD: not those on raw disk devices.
どの操作をキャンセルできるかは、実装定義である。
-.\" FreeBSD: raw ディスクデバイスへのリクエストはキャンセルできない。
.SH 返り値
-全てのリクエストのキャンセルが成功した場合、この関数は
-.B AIO_CANCELED
-を返す。
-指定されたリクエストのうち少なくとも 1 つが進行中であるために
-キャンセルできなかった場合は、
-.B AIO_NOTCANCELED
-が返される。
-この場合は、
-.BR aio_error (3)
-を使って個々のリクエストの状態をチェックすることができる。
-呼び出される前に全てのリクエストが完了していた場合、
-この関数は
-.B AIO_ALLDONE
-を返す。
-何らかのエラーが起こった場合は、\-1 が返されて、
-.I errno
-が適切に設定される。
+\fBaio_cancel\fP() 関数は以下のいずれかの値を返す。
+.TP
+\fBAIO_CANCELED\fP
+全てのリクエストが正常にキャンセルされた。
+.TP
+\fBAIO_NOTCANCELED\fP
+指定されたリクエストのうち少なくとも一つが、実行中のため
+キャンセルできなかった。この場合には、\fBaio_error\fP(3) を使って
+個々のリクエストの状態を確認できる。
+.TP
+\fBAIO_ALLDONE\fP
+呼び出しの前に全てのリクエストがすでに完了していた。
+.TP
+\-1
+エラーが発生した。
+\fIerrno\fP を確認することでエラーの原因を知ることができる。
.SH エラー
-.TP
-.B EBADF
-.I fd
-が有効なファイルディスクリプタでない。
+.TP
+\fBEBADF\fP
+\fIfd\fP が有効なファイルディスクリプタでない。
+.TP
+\fBENOSYS\fP
+\fBaio_cancel\fP() は実装されていない。
+.SH バージョン
+\fBaio_cancel\fP() 関数は glibc 2.1 以降で利用できる。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001, POSIX.1\-2008.
+.SH 例
+\fBaio\fP(7) を参照。
.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)
+\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)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
