MLOCK

Section: System Calls (2)
索引 jman

BSD mandoc

索引

名称

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

索引

ライブラリ

Lb libc

索引

書式

In sys/mman.h Ft int Fn mlock const void *addr size_t len Ft int Fn munlock const void *addr size_t len

索引

解説

Fn mlock システムコールは、 Fa addr から開始する Fa len バイトの仮想アドレス範囲に対応する物理ページをメモリにロックします。 Fn munlock システムコールは、1 つ以上の Fn mlock 呼び出しによってロックされていたページをアンロックします。これらの両方において、 Fa addr 引数はページサイズの整数倍でなければいけません。 Fa len 引数がページサイズの整数倍でない場合、切り上げられます。範囲全体が確保されている必要があります。

Fn mlock システムコールの後、指示されたページは、アンロックされるまで非常駐ページフォルトもアドレス変換フォルトも起こしません。しかし、TLB の管理をソフトウェアで実装しているアーキテクチャでは、保護違反フォルト、または TLB ミスフォルトを起こす可能性はあります。ページに関するすべてのロックされたマッピングが削除されるまで物理ページはメモリに留まります。複数のプロセスが、それぞれの仮想アドレスマッピングから同じ物理ページをロックする可能性があります。同様に、1 つのプロセスが同じページに対する異なる複数の仮想マッピングによって、または同じアドレス範囲へのネストした Fn mlock 呼び出しによって、ページを多重にロックする可能性があります。アンロックは、 Fn munlock によって明示的に、または Fn munmap によって暗黙的に行われます。 Fn munmap はマップされていないアドレス範囲の割り当てを解除します。ロックされたマッピングは fork(2) による子プロセスには継承されません。

物理メモリは潜在的に乏しいリソースなので、プロセスはどのくらいロックできるかの制限を受けます。 1 つのプロセスは、システム全体に共通の ``固定されたページ'' 限界、またはプロセスごとの RLIMIT_MEMLOCK リソース限界のいずれか小さい方の値まで Fn mlock できます。

これらの呼び出しが利用できるのはスーパユーザだけです。

索引

戻り値

Rv -std

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

索引

エラー

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

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

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

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

索引

バグ

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

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

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

索引