lgrpinfo

- 近傍性グループに関する情報の表示

形式

lgrpinfo [-aceGlLmrt] [-u unit] [-C | -P] lgrp ...

lgrpinfo -h

lgrpinfo -I [-c] [-G] [-C | -P] lgrp ...

lgrpinfo [-T] [-aceGlLmr] [-u unit]

機能説明

lgrpinfo は、近傍性グループ (lgroup) の階層とその内容に関する情報を出力します。

lgroup は、お互いに少し距離 (応答時間) がある CPU とメモリーのようなハードウェアデバイスのセットを表します。システム内の lgroup はすべて、lgroup ID という一意の整数によって識別されます。

lgroup は、もっとも近いリソースを見つけやすくするために階層にまとめられます。葉 lgroup には、それぞれ互いにもっとも近い (ローカルの) リソースのセットが含まれます。階層のそれぞれの親 lgroup には、子 lgroup のリソースとその次にもっとも近いリソースが含まれます。最後の「ルート」lgroup には、最大応答時間内のドメインにあるすべてのリソースが含まれます。

ユニフォームメモリーアクセス (UMA) マシンは、ルート lgroup によって簡潔に表されます。非ユニフォームメモリーアクセス (NUMA) マシンは、対応する近傍性レベルを示す lgroup の階層によって表されます。たとえば、2 つの応答時間 (ローカルとリモート) がある NUMA マシンは、葉とルートの 2 つのレベルからなる lgroup 階層を持ちます。

すべてのアプリケーションスレッドは、「ホーム」lgroup を割り当てられます。CPU リソースまたはメモリーリソースをスレッドに割り当てる必要があるとき、システムは、スレッドのホームにもっとも近い位置にある使用可能なリソースを探すために、スレッドのホーム lgroup から順番に lgroup 階層を検索します。詳細は、plgrp(1)を参照してください。

引数がない場合、lgrpinfo はシステム内のすべての lgroup に関する一般的な情報を出力します。コマンド行で lgroup ID が指定された場合、コマンドは指定された lgroup に関する情報のみを出力します。表示される lgroup の種類や各 lgroup に対して出力される正確な情報は、さまざまなオプションで制御します。

lgroup は、コマンド行上で、lgroup ID として指定したり、特定のキーワードを使用して指定したりすることができます。オペランド を参照してください。

オプション

オプションは組み合わせることができ、オプションを指定する順序は重要ではありません。小文字のオプションで、lgroup に関してどの情報が出力されるかを選択します。

引数なしで lgrpinfo を呼び出すことは、次の記述と同等です。

lgrpinfo -c -e -l -m -r -t all

次のオプションがサポートされています。

-a

トポロジ、メモリー、読み込み、および応答時間情報を出力します。

このオプションは次の短縮形です。

lgrpinfo -t -c -e -m -r -l -L

(ただし、-T も指定した場合を除く。)-T が指定されている場合、-t オプションは含まれません。

-c

CPU 情報を出力します。

これはデフォルトです。

-C

一覧内の各 lgroup をその子で置き換えます。

このオプションは、-P および -T オプションとともに使用することはできません。引数が指定されていない場合、このオプションはデフォルトで表示される lgroup に適用されます。

-e

lgroup の読み込み平均時間を出力します。lgroup の読み込み平均時間は、葉 lgroup に対してのみ表示されます。

これはデフォルトです。

-G

lgroup 階層の OS 表示を出力します。

デフォルトでは、lgroup 階層の呼び出し側表示では、呼び出し側が使用できるものを含むもののみが表示されます。たとえば、呼び出し側のプロセッサセットの CPU のみが表示されます。オペレーティングシステムおよび呼び出し側の表示については、lgrp_init(3LGRP)を参照してください。

-h

短いヘルプメッセージを出力して終了します。

-I

一致する ID のみを出力します。

このオプションはスクリプト用で、-c、-G および -C、または -P とともに使用できます。-c が指定されている場合、一致するすべての lgroup に含まれる CPU の一覧を出力します。指定されていない場合は、一致する lgroup の ID が表示されます。「使用例」を参照してください。

引数が指定されない場合、このオプションは表示される lgroup (デフォルトではすべての lgroup) に適用されます。

-l

lgroup の応答時間に関する情報を出力します。

各 lgroup について指定された応答時間値は、オペレーティングシステムによって定義されたもので、プラットフォーム固有の数値です。実行中のシステムで lgroup を相対的に比較する目的にのみ使用できます。この値は、ハードウェアデバイス間の実際の応答時間を表しているとは限らず、異なるプラットフォーム間では当てはまらない場合もあります。

-L

lgroup の応答時間テーブルを出力します。lgroup の応答時間テーブルでは、各 lgroup からそれ自体を含むほかの各 lgroup への相対応答時間が表示されます。

-m

メモリー情報を出力します。

-u オプションも指定されている場合を除き、メモリーサイズは測定単位が調整され、0 から 1023 までの整数で生成されます。この数値の小数部分は 10 未満の値に対してのみ表示されます。この動作は、ls(1) または df(1M) の -h オプションを使用して読みやすい形式で表示する場合と同様です。

これはデフォルトです。

-P

一覧内の各 lgroup をその親で置き換えます。

このオプションは、-C および -T オプションとともに使用することはできません。引数が指定されない場合、このオプションは表示される lgroup (デフォルトではすべての lgroup) に適用されます。

-r

lgroup のリソースに関する情報を出力します。

リソースは lgroup のセットによって表され、セット内の各 lgroup には CPU やメモリーリソースが直接含まれます。-T も指定されている場合、中間 lgroup のリソースに関する情報のみが表示されます。

-t

lgroup のトポロジに関する情報が出力されます。

これはデフォルトです。

-T

システムの lgroup トポロジをツリー形式でグラフィカルに表示します。このオプションは、-a、-c、-e、-G、-l、-L、-m、-r、および -u オプションとともにのみ使用できます。-r とともに使用されると、中間 lgroup の lgroup リソースのみを出力します。-T が -a とともに使用されると、-t オプションは省略されます。「ルート」lgroup が唯一の lgroup である場合を除き、ルート lgroup の情報は出力されません。

-uunits

メモリー単位を指定します。単位は、b、k、m、g、t、p、または e (それぞれ、バイト、キロバイト、メガバイト、ギガバイト、テラバイト、ペタバイト、またはエクサバイトを表す) にしてください。この数値の小数部分は 10 未満の値に対してのみ表示されます。この動作は、ls(1) または df(1M) の -h オプションを使用して読みやすい形式で表示する場合と同様です。

オペランド

次のオペランドがサポートされています。

lgrp

lgroup は、次のいずれかのキーワードを使用すると、コマンド行で lgroup ID として指定できます。

all

すべての lgroup。

これはデフォルトです。

intermediate

すべての中間 lgroup。中間 lgroup とは、親と子を持っている lgroup のことです。

leaves

すべての葉 lgroup。葉 lgroup とは、lgroup 階層内で子を持っていない lgroup のことです。

root

ルート lgroup。ルート lgroup は最大応答時間内のドメインにあるすべてのリソースを含み、親 lgroup を持ちません。

指定された lgroup が無効である場合、lgrpinfo コマンドは無効な ID を表示するメッセージを標準エラー出力にメッセージを出力し、コマンド行で指定されたほかの lgroup を引き続き処理します。指定された lgroup が 1 つも有効でない場合、lgrpinfo は終了ステータス 2 で終了します。

使用例

例 1 lgroup に関する情報の出力

次の例では、システム内の lgroup に関する一般情報を出力します。

この例では、システムは AMD Opteron CPU を 2 つ搭載したマシンで、1 つの CPU と 2G バイトのメモリーを持つノードが 2 つあります。これらのノードはそれぞれ、1 つの葉 lgroup によって表されます。ルート lgroup は、マシン内のすべてのリソースを含みます。

$ lgrpinfo
  lgroup 0 (root):
          Children: 1 2
          CPUs: 0 1
          Memory: installed 4.0G, allocated 2.2G, free 1.8G
          Lgroup resources: 1 2 (CPU); 1 2 (memory)
          Latency: 83
  lgroup 1 (leaf):
          Children: none, Parent: 0
          CPU: 0
          Memory: installed 2.0G, allocated 1.2G, free 788M
          Lgroup resources: 1 (CPU); 1 (memory)
          Load: 0.793
          Latency: 56
  lgroup 2 (leaf):
          Children: none, Parent: 0
          CPU: 1
          Memory: installed 2.0G, allocated 1017M, free 1.0G
          Lgroup resources: 2 (CPU); 2 (memory)
          Load: 0.817
          Latency: 56

例 2 lgroup のトポロジの出力

次の例では、AMD Opteron CPU を 4 つ備えたマシンの lgroup トポロジツリーを出力します。

$ lgrpinfo -T
  0
  |-- 5
  |   `-- 1
  |-- 6
  |   `-- 2
  |-- 7
  |   `-- 3
  `-- 8
      `-- 4

例 3 lgroup トポロジの出力

次の例では、AMD Opteron CPU を 2 つ備えたマシンの lgroup トポロジツリー、リソース、メモリー、および CPU 情報を出力します。

$ lgrpinfo -Ta
  0
  |-- 1
  |   CPU: 0
  |   Memory: installed 2.0G, allocated 1.2G, free 790M
  |   Load: 0.274
  |   Latency: 56
  `-- 2
      CPU: 1
      Memory: installed 2.0G, allocated 1019M, free 1.0G
      Load: 0.937
      Latency: 56

Lgroup latencies:

------------
    |  0  1  2
  ------------
  0 | 83 83 83
  1 | 83 56 83
  2 | 83 83 56
  ------------

例 4 lgroup ID の出力

次の例では、ルート lgroup の子の lgroup ID を出力します。

$ lgrpinfo -I -C root
  1 2

例 5 CPU ID の出力

次の例では、lgroup 1 内のすべての CPU の CPU ID を出力します。

$ lgrpinfo -c -I 1
  0

例 6 lgroup の応答時間に関する情報の出力

次の例では、lgroup の応答時間に関する情報を出力します。

 $ lgrpinfo -l
  lgroup 0 (root):
          Latency: 83
  lgroup 1 (leaf):
          Latency: 56
  lgroup 2 (leaf):
          Latency: 5

終了ステータス

次の終了値が返されます。

0

正常終了。

1

システムから lgroup 情報を入手できません。

2

指定された lgroup がすべて無効です。

3

構文が正しくありません。

属性

属性についての詳細は、attributes(5) を参照してください。

人間が読める形式の出力は「不確実」です。

関連項目

ls(1), plgrp(1), pmap(1), proc(1), ps(1), df(1M), prstat(1M), lgrp_init(3LGRP), liblgrp(3LIB), proc(4), attributes(5)