AIO_RETURN(3)

名前
aio_return - 非同期 I/O 操作の返り値 (return status) を取得する

書式
#include <aio.h>

ssize_t aio_return(struct aiocb *aiocbp);

-lrt でリンクする。

説明
aio_return() 関数は aiocbp で指された制御ブロックにおける非同期 I/O リクエストの最終的な返り値を返す。 (aiocb 構造体の説明は aio(7) を参照)

この関数は、 aio_error(3) が EINPROGRESS 以外を返した後で、 与えられたリクエストに対して 1 回だけ呼ばれるべきである。

返り値
非同期 I/O 操作が完了した場合、この関数は、同期呼び出し read(2), write(2), fsync(2), fdatasync(2) が返すのと同じ値を返す。エラーの場合、 -1 が返され、 errno が適切に設定される。

非同期 I/O 操作が完了していない場合、 aio_return() の返り値とその影響は不定である。

エラー

EINVAL
    aiocbp が、返り値がまだ取得されていない非同期 I/O リクエストの 制御ブロックを指していない。

ENOSYS
    aio_return() は実装されていない。

バージョン
The aio_return() 関数は glibc 2.1 以降で利用できる。

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

準拠
POSIX.1-2001, POSIX.1-2008.

例
aio(7) を参照。

関連項目
aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(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/ に書かれている。