名前

aio_error - 非同期 I/O 操作のエラー状態を取得する

書式

#include <aio.h>
int aio_error(const struct aiocb *aiocbp);
-lrt でリンクする。

説明

aio_error() 関数は aiocbp で指された制御ブロックでの非同期 I/O リクエス トのエラー状態を返す。( aiocb 構造体の説明は aio(7) を参照)

返り値

この関数の返り値は以下のいずれかである。
*
EINPROGRESS (リクエストがまだ完了していない場合)
*
ECANCELED (リクエストがキャンセルされた場合)
*
0 (リクエストが正常に完了した場合)
*
正のエラー番号 (非同期 I/O 命令が失敗した場合)。 同期の read(2), write(2), fsync(2), fdatasync(2) の呼び出しの場合で errno 変数に格納されるのと同じ値になる。

エラー

EINVAL
aiocbp が、まだ返り値 (return status) ( aio_return(3) を参照) が取得されていない非同期 I/O リクエストの制御ブロックを指していない。
ENOSYS
aio_error() は実装されていない。

バージョン

aio_error() 関数は glibc 2.1 以降で利用できる。

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース 属性 値
aio_error() Thread safety MT-Safe

準拠

POSIX.1-2001, POSIX.1-2008.

例

aio(7) を参照。

関連項目

aio_cancel(3), aio_fsync(3), aio_read(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7)

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。