AIO_CANCEL

名前

書式

int aio_cancel(int fd, struct aiocb *aiocbp);

-lrt でリンクする。  

説明

キャンセルされたリクエストに対して、通常の非同期通知が起こる (aio(7) と sigevent(7) を参照)。 リクエストの返り値 (aio_return(3)) は -1 に設定され、 リクエストのエラー状態 (aio_error(3)) は ECANCELED に設定される。 キャンセルできないリクエストの制御ブロックは変更されない。

リクエストがキャンセルできない場合には、 aio_cancel() は通常の I/O 操作の実行後と同じように終了する。 (この場合、 aio_error(3) はステータス EINPROGRESSS を返す)。

aiocbp が NULL でなく、かつ fd が非同期操作が開始されたファイルディスクリプターと異なる場合、 生じる結果は不定である。

どの操作をキャンセルできるかは、実装定義である。  

返り値

AIO_CANCELED

全てのリクエストが正常にキャンセルされた。

AIO_NOTCANCELED

指定されたリクエストのうち少なくとも一つが、実行中のため キャンセルできなかった。この場合には、aio_error(3) を使って 個々のリクエストの状態を確認できる。

AIO_ALLDONE

呼び出しの前に全てのリクエストがすでに完了していた。

-1

エラーが発生した。 errno を確認することでエラーの原因を知ることができる。

エラー

EBADF

fd が有効なファイルディスクリプターでない。

ENOSYS

aio_cancel() は実装されていない。

バージョン

属性

準拠

例

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

Index

名前

書式

説明

返り値

エラー

バージョン

属性

準拠

例

関連項目

この文書について