名称

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() システムコールは、次の場合に失敗します:

[ EAGAIN]

システムリソースの限界のために要求は、待ち行列に入れられませんでした。

[ ENOSYS]

aio_read() システムコールがサポートされていません。

以降の条件は、 aio_read() システムコールが行われたときに同期的に検出されることもありますし、その後いつでも非同期的に検出されることもあります。これらが呼び出し時に検出された場合、 aio_read() システムコールは、-1 を返し、 errno を適切に設定します。そうでない場合は、 aio_return() 関数を呼び出し、 -1 を返し、 errno に返されている実際の値を判定するために aio_error() を呼び出す必要があります。

[ EBADF]

iocb->aio_fildes 引数が無効です。

[ EINVAL]

オフセット iocb->aio_offset が有効でないか、 iocb->aio_reqprio によって指定される優先順位が有効な優先順位でないか、または iocb->aio_nbytes によって指定されるバイト数が有効でありません。

[ EOVERFLOW]

ファイルは、正規のファイルであり、 iocb->aio_nbytes は、0 より大きくて iocb->aio_offset 内の開始オフセットは、ファイルの末尾の前にあるものの、 iocb->aio_fildes オフセット最大にあるかまたはそれを越えています。

要求が正常に待ち行列に入れられたものの、後でキャンセルされるかエラーが発生した場合、 aio_return() システムコールによって返された値が read(2) システムコールごとによるものであり、 aio_error() システムコールによって返される値が read(2) システムコールから返されたエラーの 1 つであるか、または次の 1 つです。

[ EBADF]

iocb->aio_fildes 引数が読み込みについては、無効です。

[ ECANCELED]

要求は、 aio_cancel() の呼び出しによって明示的にキャンセルされました。

[ EINVAL]

オフセット iocb->aio_offset は、無効です。

関連項目

aio_cancel(2), aio_error(2), aio_return(2), aio_suspend(2), aio_waitcomplete(2), aio_write(2), siginfo(3), aio(4)

規格

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

歴史

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

作者

このマニュアルページは、 Terry Lambert <terry@whistle.com>によって書かれました。

バグ

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