SIMPLE SOLUTIONS

AIO_SUSPEND(3) - Linux manual

非同期 I/O 操作またはタイムアウトを待つ.

2012-05-08
AIO_SUSPEND(3) Linux Programmer's Manual AIO_SUSPEND(3)

aio_suspend - 非同期 I/O 操作またはタイムアウトを待つ

#include <aio.h> int aio_suspend(const struct aiocb * const aiocb_list[], int nitems, const struct timespec *timeout); -lrt でリンクする。

aio_suspend() 関数は、以下のいずれかが発生するまで 呼び出したスレッドの実行を停止 (sus‐ pend) する。 * aiocb_list リスト内の非同期 I/O リクエストのうち、少なくとも一つが完了した。 * シグナルが配送された。 * timeout が NULL でない場合に、指定した時間が経過した (timespec 構造体の詳細は nanosleep(2) を参照)。 nitems 引き数は aiocb_list の要素数を指定する。 aiocb_list が指すリストの各要素は、NULL (これは無視される) か、 aio_read(3), aio_write(3), lio_listio(3) を使って I/O が開始された 制御ブロックへのポインターでなければならない。 (aiocb 構造体の説明は aio(7) を参照) CLOCK_MONOTONIC がサポートされる場合、 このクロックを使ってタイムアウトの 間隔が計測される (clock_gettime(3) を参照)。

aiocb_list で指定された I/O リクエストの 1 つが完了した後に この関数が返った場合は、0 が返される。 それ以外の場合は、 -1 が返り、 errno にエラーを示す値に設定される。

EAGAIN 指示された操作のどれも完了しないうちに、呼び出しがタイムアウトした。 EINTR この呼び出しがシグナルによって終了させられた (このシグナルは、完了を待っていた 操作のいずれかの完了シグナルの可能性もある)。signal(7) 参照。 ENOSYS aio_suspend() は実装されていない。

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

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

時間間隔が 0 であることを指定する NULL ではない timeout を使って、ポーリングを行うこともできる。 aiocb_list リストで指定した非同期 I/O 操作のうち、 aio_suspend() を呼び出した時点ですでに完了したものがある場合、 aio_suspend() はすぐに返る。 aio_suspend() が成功で返った後でどの I/O 操作が完了したかを特定するには、 aio_error(3) を使って aiocb_list が指す aiocb 構造体のリストを スキャンする。

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

この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。
2012-05-08 AIO_SUSPEND(3)
aio_suspend(3).txt (日本語 / Japanese)
Index English version of aio_suspend(3)
Go top