READAHEAD

Section: Linux Programmer's Manual (2)
Updated: 2019-03-06
Index JM Home Page

名前

readahead - 前もってファイルをページキャッシュに読み込む

書式

#define _GNU_SOURCE             /* feature_test_macros(7) 参照 */
#include <fcntl.h>

ssize_t readahead(int fd, off64_t offset, size_t count);

説明

readahead() はファイルの先読みを行い、そのファイルに対する後の読み込みがキャッシュから行われ、ディスク I/O で停止しないようにする (この条件を満たせるのは、先読みは十分早く行われ、システムの他の動作によりその後にキャッシュからページがフラッシュされない場合である)。

fd 引数は読み込みを行うファイルを識別するファイルディスクリプターである。 offset 引数はデータの読み込み開始位置を指定し、 count は読み込むデータのバイト数を指定する。ディスク I/O はページ単位で実行されるので、実際には offset はページ境界に切り下げられ、読み込みバイト数は (offset+count) より小さくない次のページ境界まで切り上げられる。 readahead() はファイルの末尾を越えた範囲まで読み出しを行うことはない。ファイルディスクリプター fd で参照されたオープン済のファイル記述のファイルオフセットは変更されない。

返り値

readahead() は成功すると 0 を返す。失敗した場合 -1 を返し、 errno にエラーの原因を示す値を設定する。

エラー

EBADF: fd が有効なファイルディスクリプターでない、または読み込み用にオープンされていない。
EINVAL: fd が参照しているファイルが、 readahead() を行うことができないタイプのファイルであった。

バージョン

readahead() システムコールは Linux 2.4.13 で登場した。 glibc でのサポートは glibc バージョン 2.3 以降で行われている。

準拠

readahead() システムコールは Linux 固有であり、移植を考慮したプログラムでは使用を避けるべきである。

注意

いくつかの 32 ビットアーキテクチャーでは、このシステムコールの呼び出しシグネチャーが違っている。理由は syscall(2) で説明されている。

バグ

readahead() は読み込みをバックグラウンドで行うようにスケジューリングを行い、すぐに返る。しかしながら、要求されたブロックの位置を知るために必要なファイルシステムのメタデータを読み込む間は readahead() は停止することがある。これは ext[234] で大きなファイルをエクステントではなく間接ブロックを使う場合にしばしば発生し、要求したデータが読み込まれるまで呼び出しが停止しているように見える。

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

Linux マニュアル一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

This document was created by man2html, using the manual pages.
Time: 12:08:49 GMT, June 11, 2022

READAHEAD

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

バグ

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

Index

Linux マニュアル一覧