manページ  — AIO_WRITE

aio_write – ファイルへの非同期書込み (REALTIME)

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

Standard C Library (libc, -lc)

#include <aio.h>

int
aio_write(struct aiocb *iocb);

aio_write() システムコールによって、呼び出し元プロセスは iocb->aio_buf が指すバッファから記述子 iocb->aio_fildes に iocb->aio_nbytes を書き込めます。 書込み要求が記述子への待ち行列に入れられてしまうと、 ただちに呼び出しは戻ります。 呼び出しが戻った時点で書込みは完了している可能性も完了していない 可能性もあります。 無効な引数のためなどにより要求を待ち行列に入れられない場合は、 呼び出しは要求を待ち行列に入れずに戻ります。

iocb->aio_fildes 用に O_APPEND が設定されている場合、 aio_write() 操作は呼び出しが行われたのと同じ順序で ファイルの末尾に追加されます。 O_APPEND がファイル記述子用に設定されていない場合、書込み操作はファイルの先頭に iocb->aio_offset を加えた絶対位置で行われます。

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

iocb ポインタは待ち行列に入れられた操作の戻り値、またはエラー状態を 判定するために、 aio_return() および aio_error() への引数として使用できます。

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

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

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

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

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

The aio_write 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_write() システムコールは IEEE Std 1003.1 ("POSIX.1") 標準に適合しています。

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

このマニュアルページは Wes Peters <wes@softweyr.com> が作成しました。

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