mincore

Section: System Calls (2)
Updated: 2026-02-16
Index JM Home Page roff page
 

名前

mincore - ページがメモリー内にあるかどうかを判定する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <sys/mman.h>

int mincore(size_t length;
            void addr[length], size_t length, unsigned char *vec);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

mincore():

    Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _BSD_SOURCE || _SVID_SOURCE
 

説明

mincore() は、呼び出し元プロセスの仮想メモリーのページがコア (RAM) 内に存在し、 ページ参照時にディスクアクセス (ページフォールト) を起こさないか どうかを示すベクトルを返す。カーネルは、アドレス addr から始まる length バイトの範囲のページに関する存在情報を返す。

addr 引数はシステムのページサイズの倍数でなければならない。 length 引数はページサイズの倍数である必要はないが、 ページ全体に関する存在情報が返されるので、事実上 length はページサイズの倍数に切り上げられることになる。 ページサイズ (PAGE_SIZE) は sysconf(_SC_PAGESIZE) を使って入手できる。

vec 引数は、少なくとも (length+PAGE_SIZE-1) / PAGE_SIZE バイトが格納できる配列を指していなければならない。 この呼び出しが返るとき、 各バイトの最下位ビットは、対応するページがメモリー内にそのとき存在すれば セットされ、そうでない場合はクリアされる (各バイトのその他のビットは未定義であり、これらのビットは将来の使用に そなえて予約されている)。 もちろん、 vec で返された情報はスナップショットでしかない。 メモリー内にロックされていないページは、任意の時点でメモリー内に 入ったり出たりでき、この呼び出しが返るときには vec の内容はすでに古くなっているかもしれない。  

返り値

On success, mincore() returns zero. On error, -1 is returned, and errno is set to indicate the error.  

エラー

EAGAIN カーネルが一時的にリソースを使い果たしている。
EFAULT
vec が無効なアドレスを指している。
EINVAL
addr がページサイズの倍数でない。
ENOMEM
length が (TASK_SIZE - addr) より大きい。 (length に負の値が指定された場合、 その値が大きな符号なし整数として解釈されるために起こることがある。) Linux 2.6.11 以前では、この条件の場合はエラー EINVAL が返されていた。
ENOMEM
addr から addr + length の間にマップされていないメモリーがあった。
 

標準規格

なし。  

歴史

SunOS 4.1, 4.4BSD, FreeBSD 2.2, Solaris 8, Linux 2.3.99pre1, glibc 2.2, NetBSD 1.5, OpenBSD 2.9, AIX 5.1.  

バグ

Before Linux 2.6.21, mincore() did not return correct information for MAP_PRIVATE mappings, or for nonlinear mappings (established using remap_file_pages(2)).  

関連項目


 fincore(1), madvise(2), mlock(2), mmap(2), posix_fadvise(2), posix_madvise(3)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
標準規格
歴史
バグ
関連項目

This document was created by man2html, using the manual pages.