manページ  — MLOCK

mlock, munlock – 物理ページをメモリ内でロック (アンロック) する

ライブラリ 書式 解説 戻り値 エラー 関連項目 バグ 歴史

Standard C Library (libc, -lc)

#include <sys/mman.h>

int
mlock(const void *addr, size_t len);

int
munlock(const void *addr, size_t len);

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

呼び出しが成功すると、範囲内のすべてのページがロック (アンロック) されます。 失敗した場合は、範囲内のすべてのページのロック状態は変更されません。

mlock() システムコールは次の場合に処理を失敗します:

[EPERM]
	呼び出し側がスーパユーザではありません。
[EINVAL]
	指定されたアドレスがページ境界に整列されていないか、または長さが負です。
[EAGAIN]
	指示された範囲のロックによって、ロックされたメモリについての システム限界またはプロセスごとの限界を超過してしまいます。
[ENOMEM]
	指示されたアドレス範囲の一部が割り当てられていません。 ページのフォルト / マッピングでエラーがありました。

munlock() システムコールは次の場合に失敗します:

[EPERM]
	呼び出し側がスーパユーザではありません。
[EINVAL]
	指定されたアドレスがページ境界に整列していないか、または長さが負です。
[ENOMEM]
	指示されたアドレス範囲の一部が割り当てられていません。

固定されたメモリを多く割り当て過ぎることは、そこから回復するために リブートを要求するメモリ割り当てのデッドロックにつながる可能性があります。

プロセスごとのリソースの限界はロックされた仮想メモリの量への制限で、 システム全体に共通の制限はロックされた物理ページの数についてのものです。 このように、2 つの別々のマッピングから同じ物理ページを ロックするとプロセスごとの制限に対しては 2 ページとしてカウントされ、 システム制限では 1 ページだけとしてカウントされます。

プロセスごとのリソース制限は現時点ではサポートされていません。

mlock() システムコールと munlock() システムコールは BSD 4.4 ではじめて登場しました。