io_cancel - システムコールの説明 - Linux コマンド集 一覧表

io_cancel - 未処理の非同期 I/O 操作の取り消し

#include <libaio.h>
intio_cancel (io_context_tctx , structiocb*iocb , structio_event*evt );

io_cancel () は、以前に io_submit システム・コールを使って登録された 非同期 I/O (AIO) 操作の取り消しを行おうとする。 ctx は、取り消しを行う 操作の AIO コンテキストの ID である。指定した AIO コンテキストが見つかると、 対象のイベントの取り消しが行われ、その後 evt で指されたメモリに コピーされる (このとき、完了キューへの移動は行われない)。

成功した場合、io_cancel () は 0 を返す。 そうでない場合、「エラー」の節にリストアップされているエラーのいずれか 一つが返される。

EINVAL

ctx で指定された AIO コンテキストが無効である。

EFAULT

データ構造の中に無効なデータを指しているものがある。

EAGAIN

指定された iocb の取り消しが行われなかった。

ENOSYS

io_cancel () はこのアーキテクチャでは実装されていない。

非同期 I/O システム・コールは 2002年8月に Linux 2.5 で初めて登場した。

io_cancel () は Linux 固有であり、移植を想定したプログラムで 使用すべきではない。

io_setup (2), io_destroy (2), io_getevents (2), io_submit (2).

非同期 I/O システム・コールは Benjamin LaHaise が書いた。

Kent Yoder.