POSIX_FADVISE

名前

書式

#define _XOPEN_SOURCE 600
#include <fcntl.h>

int posix_fadvise(int fd, off_t offset, off_t len, int advice);

説明

advice は fd が参照しているファイルの offset から始まる len バイトの範囲内 (len が 0 の場合はファイルの終りまで) の (必ずしも存在しない) 領域に適用される。 アドバイスは義務づけではない。 アドバイスは単にアプリケーションのために可能性を構成するだけである。

advice に許される値には、以下のものが含まれる:

POSIX_FADV_NORMAL

指定されたデータのアクセスパターンを指示するアドバイスを アプリケーションが何も持っていないことを示す。 オープンされたファイルにアドバイスが指定されない場合、 これがデフォルトで仮定される。

POSIX_FADV_SEQUENTIAL

アプリケーションは指定されたデータがシーケンシャルに (大きなオフセットの前に小さなオフセットのデータを読むように) アクセスされることを期待する。

POSIX_FADV_RANDOM

指定されたデータがランダムな順番でアクセスされる。

POSIX_FADV_NOREUSE

指定されたデータは 1 度しかアクセスされない。

POSIX_FADV_WILLNEED

指定されたデータは近い将来アクセスされる。

POSIX_FADV_DONTNEED

指定されたデータは近い将来アクセスされない。

返り値

エラー

EBADF

fd 引き数が有効なファイルディスクリプタでない。

EINVAL

無効な値が advice に指定された。

ESPIPE

指定されたファイルディスクリプタがパイプまたは FIFO を参照している (この場合、Linux は実際には EINVAL を返す)。

バージョン

準拠

注意

POSIX_FADV_WILLNEED は、 ページキャッシュに指定領域のブロックされない読み込みを開始する。 読み込まれるデータの総量は、 仮想メモリの負荷に依ってカーネルが減らすかもしれない (数メガバイトであれば通常は全く十分であり、 それより多くてもめったに役に立たない)。

2.6.18 より前のカーネルでは、POSIX_FADV_NOREUSE は POSIX_FADV_WILLNEED と同じ意味であった。 これは多分バグであった。 カーネル 2.6.18 以降では、このフラグは何も行わない。

POSIX_FADV_DONTNEED は指定された領域に関連付けられた キャッシュページを解放しようとする。 例えば、これは大きなファイルをストリーミングするときに役立つ。 プログラムは、使用済みのキャッシュされたデータを解放するように、 定期的にカーネルに要求するかもしれない。 そうすることにより、さらに有効なキャッシュされたページが、 代わりに破棄されることはない。

まだ書き出されていないページは影響を受けないので、 そのページの解放が保証されることをアプリケーションが望んでいるなら、 最初に fsync(2) または fdatasync(2) を呼ぶべきである。  

バグ

関連項目

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

バグ

関連項目