日本語 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.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
POSIX_FADVISE(2) FreeBSD システムコールマニュアル POSIX_FADVISE(2)
名称
posix_fadvise -- ファイルデータの使用に関するアドバイスを与える
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <fcntl.h>
int
posix_fadvise(int fd, off_t offset, off_t len, int advice);
解説
posix_fadvise() システムコールによって、プロセスは、オープンファイル記述
子 fd のためのシステムのデータアクセスの振る舞いを記述することができま
す。アドバイスは、オフセット offset から始まり、len バイトの継続するデー
タをカバーします。len が 0 であるなら、offset からファイルの終りまでのす
べてのデータがカバーされます。
振る舞いは、advice パラメータによって指定され、次のうちの 1 つです:
POSIX_FADV_NORMAL デフォルトのデータアクセスの振る舞いに戻るようにシ
ステムに伝えます。
POSIX_FADV_RANDOM ファイルデータがランダムにアクセスされるヒントで、
プロフェッチは、恐らく有利ではありません。
POSIX_FADV_SEQUENTIAL ファイルデータがシーケンシャルにアクセスされること
をシステムに伝えます。デフォルトの振る舞いがシーケ
ンシャルな振る舞いを検出するために発見的に使用する
ように、これは、現在何も行いません。
POSIX_FADV_WILLNEED 指定されたデータが近いうちにアクセスされることをシ
ステムに伝えます。システムは、それがメモリにまだな
いなら、データの非同期な読み込みを始めます。
POSIX_FADV_DONTNEED 指定されたデータが近いうちにアクセスされないことを
システムに伝えます。システムは、指定された範囲内の
クリーンなデータのメモリ中の優先順位を減少させ、こ
のデータへの将来のアクセスは、読み込み操作を要求す
るかもしれません。
POSIX_FADV_NOREUSE 指定されたデータが一度だけアクセスされ、次に、再使
用されないことをシステムに伝えます。システムは、
いったん読み込まれるか、または書き込まれるなら、
データのメモリ内の優先度を減少させます。将来、この
データへのアクセスは、読み込まれた操作を要求されま
す。
戻り値
成功するなら、posix_fadvise() 0 を返します。errno を設定せずに失敗でエ
ラーを返します。
エラー
あり得る失敗の条件は、次の通りです:
[EBADF] fd 引数が有効なファイル記述子ではありません。
[EINVAL] advice 引数が有効ではありません。
[EINVAL] offset または len 引数が負か、または offset + len が最
大のファイルサイズより大きくなっています。
[ENODEV] fd 引数が通常ファイルを参照していません。
[ESPIPE] fd 引数がパイプまたは FIFO に関連しています。
関連項目
madvise(2)
規格
posix_fadvise() インタフェースは、IEEE Std 1003.1-2001 (``POSIX.1'') に適
合しています。
歴史
posix_fadvise() システムコールは、FreeBSD 9.1 ではじめて登場しました。
FreeBSD 11.2 October 3, 2015 FreeBSD 11.2