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)EN を参照。

準拠

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/ に書かれている。