日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
AIO_WRITE(2) FreeBSD システムコールマニュアル AIO_WRITE(2)
名称
aio_write -- ファイルへの非同期書み込み (REALTIME)
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <aio.h>
int
aio_write(struct aiocb *iocb);
解説
aio_write() システムコールによって、呼び出しているプロセスは、
iocb->aio_buf によって指されたバッファから記述子 iocb->aio_fildes に
iocb->aio_nbytes を書き込むことができます。呼び出しは、書き込み要求が記述
子へのキューに入れられた直後に、返ります。書き込みは、呼び出しが返った時
点で、完了したかどうか分かりません。要求がキューに入れられないなら、一般
的に、無効の引数のために、要求をキューに入れられずに呼び出しは、返りま
す。
O_APPEND が iocb->aio_fildes のために設定されるなら、aio_write() 操作は、
呼び出しが行われたのと同じ順序でファイルに付け加えます。O_APPEND がファイ
ル記述子のために設定されないなら、書き込み操作は、ファイルの始め + (プラ
ス) iocb->aio_offset からの絶対的な位置で起こります。
_POSIX_PRIORITIZED_IO が定義され、記述子がそれをサポートするなら、キュー
に入れる操作は、呼び出しプロセス - (マイナス) iocb->aio_reqprio の優先度
と等しい優先度とされます。
iocb ポインタは、それが進行中の間に、キューに入れる操作のための返り状態ま
たはエラー状態を決定するために、aio_return() と aio_error() への引数とし
て続いて使用されます。
要求が成功してキューに入れられるなら、コンテキストとして要求の間に
iocb->aio_offset の値を修正することができるので、この値は、要求がキューに
入れられる後に、参照されてはなりません。
aio(4) で説明されるように操作の完了の通知を要求するために
iocb->aio_sigevent 構造体を使用することができます。
制限
iocb によって指された非同期 I/O 制御ブロック (Asynchronous I/O Control
Block) 構造とその構造体の iocb->aio_buf メンバが参照するバッファは、操作
が完了するまで、有効のままでなければなりません。
非同期 I/O 制御バッファ iocb は、偽のコンテキスト情報をカーネルに渡すこと
を避けるために、aio_write() システムコールの前に 0 クリアされるべきです。
要求がキューに入れられる間、Asynchronous I/O Control Block (非同期 I/O 制
御ブロック) 構造またはバッファの内容は、許可されません。
iocb->aio_offset のファイルオフセットが iocb->aio_fildes ためのオフセット
の最大を越えているなら、I/O は、起こりません。
戻り値
関数 aio_write() は、処理が成功すると値 0 を返します。そうでない場合、値
-1 が返され、グローバル変数 errno にエラーを示す値が設定されます。
エラー
aio_write() システムコールは、次の場合に失敗します:
[EAGAIN] システムのリソース制限のために、要求が、キューに入れら
れませんでした。
[EINVAL] iocb->aio_sigevent.sigev_notify の非同期の通知方法が、
無効であるか、またはサポートしていません。
[EOPNOTSUPP] ファイル記述子 iocb->aio_fildes の非同期の書き込み操作
が、安全でなく、安全でない非同期の I/O 操作は、無効に
されます。
次の条件は、aio_write() システムコールが行われたとき、同期的に検出される
か、またはその後いつでも、非同期的に検出されます。それらが呼び出し時に検
出されるなら、aio_write() は、-1 を返し、適切に errno を設定します。そう
でなければ、aio_return() システムコールが、呼び出されなければならず、-1
を返し、aio_error() は、errno で返された実際の値を決定するために呼び出さ
れなければなりません。
[EBADF] iocb->aio_fildes 引数が、無効か、または書き込みのため
にオープンされていません。
[EINVAL] オフセット iocb->aio_offset が、有効ではなく、
iocb->aio_reqprio によって指定された優先度が、有効な優
先度ではないか、または iocb->aio_nbytes によって指定さ
れたバイト数が、有効ではありません。
要求が成功してキューに入れられますが、その後にキャンセルされるか、または
エラーが起こるなら、aio_return() システムコールによって返された値が、
write(2) システムコールごとであり、aio_error() システムコールによって返さ
れた値が、write(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), sigevent(3), siginfo(3), aio(4)
規格
aio_write() システムコールは、IEEE Std 1003.1 (``POSIX.1'') 規格に適合す
るはずです。
歴史
aio_write() システムコールは、FreeBSD 3.0 ではじめて登場しました。
作者
このマニュアルページは、Wes Peters <wes@softweyr.com> によって書かれまし
た。
バグ
iocb->_aiocb_private の無効の情報は、カーネルを混乱させるかもしれません。
FreeBSD 11.2 August 19, 2016 FreeBSD 11.2