AIO_READ

名前

書式

int aio_read(struct aiocb *aiocbp);

-lrt でリンクする。  

説明

    read(fd, buf, count)

の各引数は aiocb が指す構造体の aio_fildes, aio_buf, aio_nbytes に (この順序で) 対応する (aiocb 構造体の説明は aio(7) を参照)。

データの読み込みは、ファイルオフセットに関係なく、絶対位置 aiocbp->aio_offset を開始点として行われる。呼び出しの後のファイルオフセットは規定されていない。

「非同期」とは「リクエストがキューに入れられたら、この呼び出しはすぐに返る」 ということである。 呼び出しから戻った時に、読み込みは完了しているかも知れないし、 完了していないかも知れない。 aio_error(3) を使うことで完了したかをテストできる。 完了した I/O 操作の返り値は aio_return(3) で取得できる。 aiocbp->aio_sigevent を適切に設定することで、 I/O 完了の非同期通知は受けることもできる。詳細は sigevent(7) を参照。

_POSIX_PRIORITIZED_IO が定義されていて、 かつファイルがこれをサポートしている場合、 非同期操作は呼び出したプロセスの優先度から aiocbp->aio_reqprio を引いた優先度で登録 (submit) される。

フィールド aiocbp->aio_lio_opcode は無視される。

最大オフセットを超えた通常のファイルからは、何もデータが読み込まれない。  

返り値

エラー

EAGAIN

リソースが足りない。

EBADF

aio_fildes は読み込みのためにオープンされた有効なファイルディスクリプターでない。

EINVAL

aio_offset, aio_reqprio, aio_nbytes のうち 1 つ以上が無効である。

ENOSYS

aio_read() は実装されていない。

EOVERFLOW

ファイルが通常のファイルであり、 ファイルの終端の前から読み込みを開始して、 少なくとも 1 バイトを読み込もうとした。 しかし開始位置がこのファイルの最大オフセットを超えていた。

バージョン

属性

準拠

注意

同じ aiocb 構造体を指定して同時に複数の I/O 操作を行った場合、 どのような結果になるかは不定である。  

例

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー

バージョン

属性

準拠

注意

例

関連項目

この文書について