manページ  — AIO_WAITCOMPLETE

aio_waitcomplete – 非同期入出力要求の完了までの待機

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格 歴史 作者

Standard C Library (libc, -lc)

#include <aio.h>

int
aio_waitcomplete(struct aiocb **iocbp, struct timespec *timeout);

aio_waitcomplete() システムコールは非同期入出力の完了まで待ちます。 完了次第、 aio_waitcomplete() はその関数の結果を返し、 元の要求に関連する構造体へのポインタを iocbp に設定します。 もし、 aio_waitcomplete() 関数が呼び出される前に非同期入出力要求が完了していた場合には、 完了した要求の結果を即座に返します。

timeout が NULL ポインタでない場合、それは非同期入出力要求が完了するまで 待機する最大時間を指定します。 timeout が NULL ポインタの場合は、 aio_waitcomplete() は無期限に待機します。 ポーリングする場合は、 引数 timeout は NULL ではなく、0 の値を持つ timeval 構造体を指すようにするべきです。

aio_waitcomplete() システムコールは aio_return() の役割もします。 従って、制御ブロックは iocbp で返されているので、 aio_return() を呼び出すべきではありません。

aio_waitcomplete() システムコールは次の場合に失敗します:

[EINVAL]
	指定された制限時間が無効です。
[EAGAIN]
	プロセスはまだ aio_read() や aio_write() を呼び出していません。
[EINTR]
	タイムアウトする前で、かつ 非同期入出力要求が完了する前にシグナルが届きました。
[EWOULDBLOCK] [EINPROGRESS]
	非同期入出力要求が完了する前に、指定された制限時間に達しました。

aio_waitcomplete() システムコールは FreeBSD 特有の拡張です。

aio_waitcomplete() システムコールは FreeBSD 4.0 ではじめて登場しました。

aio_waitcomplete() システムコールとこのマニュアルページは Christopher M Sedore <cmsedore@maxwell.syr.edu> が作成しました。