manページ  — AIO_READ

aio_read – ファイルからの非同期読取り (REALTIME)

ライブラリ 書式 解説 制限 戻り値 診断 エラー 関連項目 規格 歴史 作者 バグ

Standard C Library (libc, -lc)

#include <aio.h>

int
aio_read(struct aiocb *iocb);

aio_read() システムコールは、呼び出しプロセスに 記述子 iocb->aio_fildes のオフセット iocb->aio_offset で始まる iocb->aio_nbytes を、 iocb->aio_buf が指すバッファに 読み取れるようにします。 呼び出しは、読取り要求が記述子に待ち行列として入れられ るとただちに戻ります。 呼び出しが戻った時点で読取りは完了していることもありますし、 完了していないこともあります。

_POSIX_PRIORITIZED_IO が定義されており、 しかも記述子がこれをサポートしている場合に 待ち行列に入れられている操作は、呼び出しプロセスの優先順位から iocb->aio_reqprio を減じたものに等しい優先順位で発行されます。

iocb->aio_lio_opcode 引数は aio_read() システムコールによって無視されます。

iocb ポインタは、進行中に待ち行列に入れられた戻り状態または エラー状態を判定するために、 aio_return() と aio_error() の引数として後に使用される可能性があります。

要求が待ち行列に入れられない場合 (一般には無効な引数のために)、 呼び出しは要求を待ち行列に入れずに戻ります。

要求が正常に待ち行列に入れられると、コンテキストとして要求の間に iocb->aio_offset の値が修正される可能性があるので、 この値は要求が待ち行列に入れられた後は参照してはなりません。

iocb が指す非同期入出力制御ブロック構造体、およびその構造体の iocb->aio_buf メンバが参照するバッファは、操作が完了するまで有効である必要があります。 このため、これらのオブジェクトについての自動 (スタック) 変数の 使用は推奨されません。

カーネルへの正しくないコンテキスト情報の引き渡しを回避するために、 非同期入出力制御バッファ iocb は aio_read() 呼び出しの前に 0 にする必要があります。

要求が待ち行列に入れられた後、要求が完了するまでは 非同期入出力制御ブロック構造体またはバッファ内容の修正は許されていません。

iocb->aio_offset 内のファイルオフセットが、 iocb->aio_fildes の最大オフセットを越えている場合は入出力は行われません。

The aio_read function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

なし。

aio_read() システムコールは IEEE Std 1003.1 ("POSIX.1") に適合しています。

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

このマニュアルページは Terry Lambert <terry@whistle.com> が作成しました。

iocb->_aiocb_private 内の無効な情報はカーネルを混乱させる可能性があります。