release/man5/slabinfo.5

   1 .\" Copyright (c) 2001 Andreas Dilger (adilger@turbolinux.com)
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\" FIXME Over time, the slabinfo format has gone through
  26 .\" version changes. These should be documented:
  27 .\"
  28 .\"     slabinfo 1.0 - Linux 2.2 (precisely: 2.1.23)
  29 .\"     slabinfo 1.1 - Linux 2.4 (precisely: 2.4.0-test3)
  30 .\"     slabinfo 1.2 - Linux 2.5.45
  31 .\"     slabinfo 2.0 - Linux 2.6 (precisely: 2.5.71)
  32 .\"     slabinfo 2.1 - Linux 2.6.10
  33 .\"
  34 .\"*******************************************************************
  35 .\"
  36 .\" This file was generated with po4a. Translate the source file.
  37 .\"
  38 .\"*******************************************************************
  39 .TH SLABINFO 5 2007\-09\-30 "" "Linux Programmer's Manual"
  40 .SH 名前
  41 /proc/slabinfo \- カーネル slab アロケータの統計
  42 .SH 書式
  43 \fBcat /proc/slabinfo\fP
  44 .SH 説明
  45 Linux カーネルの内部で良く利用されるオブジェクト (バッファヘッド、i\-ノード、ディレクトリ・エントリなど)
  46 は、それぞれ自分用のキャッシュを備えている。ファイル \fI/proc/slabinfo\fP はこれらの統計を与える。例を示す。
  47 .LP
  48 .in +4n
  49 .nf
  50 % cat /proc/slabinfo
  51 slabinfo \- version: 1.1
  52 kmem_cache            60     78    100    2    2    1
  53 blkdev_requests     5120   5120     96  128  128    1
  54 mnt_cache             20     40     96    1    1    1
  55 inode_cache         7005  14792    480 1598 1849    1
  56 dentry_cache        5469   5880    128  183  196    1
  57 filp                 726    760     96   19   19    1
  58 buffer_head        67131  71240     96 1776 1781    1
  59 vm_area_struct      1204   1652     64   23   28    1
  60 \&...
  61 size\-8192              1     17   8192    1   17    2
  62 size\-4096             41     73   4096   41   73    1
  63 \&...
  64 .fi
  65 .in
  66 .LP
  67 それぞれの slab キャッシュごとに、キャッシュの名前、 現在アクティブなオブジェクトの数、利用可能なオブジェクトの総数、 各オブジェクトのサイズ
  68 (バイト単位)、少なくとも一つのアクティブな オブジェクトを有するページの数、アロケートされたページの総数、 slab
  69 あたりのページ数、が与えられている。
  70
  71 なお、 オブジェクトのアラインメントと slab キャッシュのオーバーヘッドとにより、 オブジェクトは通常ページの内部にきっちりとは収められていない。
  72 利用中のオブジェクトをひとつでも保持しているページは、 利用中であるとみなされ、解放できない。
  73
  74 slab キャッシュ統計の機能を有効にしてコンパイルされたカーネルでは、 出力の最初の行に "(statistics)" と表示され、 5
  75 つのカラムが追加される。 それぞれ、アクティブなオブジェクトの瞬間最大値、 オブジェクトがアロケートされた回数、 キャッシュの大きさが拡張された
  76 (新しいページがこのキャッシュに追加された) 回数、 キャッシュの大きさが縮小された (使っていないページがこのキャッシュから削除された) 回数、
  77 新たなページをこのキャッシュにアロケートする際に起きたエラーの回数、である。 slab
  78 キャッシュ統計が使えないカーネルでは、これらのカラムは表示されない。
  79
  80 SMP システムでは、出力の最初の行に "(SMP)" と表示され、 各 slab ごとに 2 つのカラムが追加される。 これらは各 CPU
  81 が持つローカルなキャッシュ (per\-CPU キャッシュ) の slab アロケーションポリシーを表示する (per\-CPU キャッシュは、
  82 オブジェクトをキャッシュからアロケートする際に CPU 間での同期を減少させるために設けられている)。 最初のカラムは per\-CPU 制限、
  83 すなわち各 CPU ごとにキャッシュできるオブジェクトの最大数である。 二番目のカラムはバッチカウント、 すなわち per\-CPU
  84 キャッシュが空だったり一杯だったりした場合に、 グローバルなキャッシュと受け渡しできるフリーなオブジェクトの最大数である。
  85
  86 slab キャッシュ統計と SMP が両方有効になっている場合は、 per\-CPU キャッシュの統計を表示する 4 つのカラムがさらに追加される。
  87 最初の 2 つは per\-CPU キャッシュの アロケーションヒットカウントとアロケーションミスカウントである。
  88 すなわち、あるオブジェクトをアロケートしたときに、 それが per\-CPU キャッシュの内部に あった/なかった 回数である。 続く 2
  89 つは、per\-CPU キャッシュのフリーヒットカウントとミスカウントである。
  90 すなわち解放されたオブジェクトをグローバルなキャッシュにフラッシュする前に、 per\-CPU キャッシュの制限の範囲に 収まった/収まらなかった
  91 回数である。
  92
  93 SMP において per\-CPU slab キャッシュの制限値や バッチカウントを変更するには、以下のようにすればよい:
  94
  95 .in +4n
  96 .nf
  97 echo "\fIcache_name limit batchcount\fP" > /proc/slabinfo
  98 .fi
  99 .in
 100 .SH ファイル
 101 \fI<linux/slab.h>\fP
 102 .SH バージョン
 103 \fI/proc/slabinfo\fP は Linux 2.1.23 以降に存在する。 SMP における CPU ごとのキャッシュは Linux
 104 2.4.0\-test3 以降に存在する。
 105 .SH 注意
 106 Linux 2.6.16 以降では、 \fI/proc/slabinfo\fP ファイルは、カーネル設定オプション \fBCONFIG_SLAB\fP
 107 を有効にした場合のみ存在する。
 108 .SH この文書について
 109 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 110 である。プロジェクトの説明とバグ報告に関する情報は
 111 http://www.kernel.org/doc/man\-pages/ に書かれている。