lstopo-クラウドでのオンライン

プログラム：

NAME

lstopo、lstopo-no-graphics、hwloc-ls-システムのトポロジーを表示します

SYNOPSIS

イストポ [ オプション ] ... [ ファイル名 ]

lstopo-グラフィックなし [ オプション ] ... [ ファイル名 ]

hwloc-ls [ オプション ] ... [ ファイル名 ]

注意してください ヒューロック（7）hwlocシステムの詳細な説明を提供します。 読む必要があります
このマニュアルページを読む前に

OPTIONS

- の 、 - 出力フォーマット
指定された形式で出力を適用します。 以下の「出力フォーマット」セクションを参照してください。

-i 、 - 入力
XMLファイルからトポロジを読み取ります（上のトポロジを検出する代わりに
ローカルマシン）。 もしも「-」の場合、標準入力が使用されます。 XMLサポートは
このオプションを使用できるように、hwlocにコンパイルされています。

-i 、 - 入力
で指定されたchrootからトポロジを読み取ります（発見する代わりに
ローカルマシン上のトポロジ）。 このオプションは通常、Linuxでのみ使用できます。
chrootは通常、hwloc-を使用して別のマシントポロジを収集することによって作成されました。
収集トポロジ。

-i 、 - 入力
ローカルでトポロジを検出する代わりに、偽の階層をシミュレートします
マシーン）。 もしも「node：2pu：3」の場合、トポロジにはXNUMXつのNUMAが含まれます
それぞれに3つの処理ユニットがあるノード。 NS 文字列は終了する必要があります
PUの数で。

- もしも 、 --入力フォーマット
指定された形式で入力を強制します。 XML, fsroot & 合成.

--エクスポート合成フラグ
合成形式にエクスポートするときにフラグを適用します。 これらのフラグはに渡されます
hwloc_topology_export_synthetic（）。 値2は、hwlocの形式に戻ります
v1.9。 値3は、元の最小形式（v1.9より前）に戻ります。

-v -詳細
追加の詳細を含めます。 hwloc-infoツールを使用して、さらに多くの情報を表示できます
特定のオブジェクトに関する情報。

-s - 静けさ
表示する詳細の量を減らします。

-f - 力
宛先ファイルがすでに存在する場合は、上書きします。

-l -論理的
物理/ OSインデックスの代わりにhwloc論理インデックスを表示します（コンソールのデフォルト）
出力）。 これらのインデックスには「L＃」というプレフィックスが付いています。 一部の物理インデックス
オブジェクト（デフォルトではPUとノード、冗長な場合はすべてのオブジェクト）がオブジェクトとして表示されます
属性「P＃...」。

-p - 物理的
hwloc論理インデックスの代わりにOS /物理インデックスを表示します（グラフィカルのデフォルト）
出力）。 これらのインデックスには、コンソールで「L＃」ではなく「P＃」がプレフィックスとして付けられます
出力。

-c --cpuset
各オブジェクトのcpusetを表示します。

-C --cpuset-のみ
各オブジェクトのcpusetのみを表示します。 について他に何も表示しないでください
オブジェクト。

-タスクセット
タスクセットコマンドラインプログラムで認識される形式でCPUセット文字列を表示する
hwloc固有のCPUセット文字列形式の代わりに。 このオプションを組み合わせる必要があります
　 --cpuset or --cpuset-のみ、そうでない場合は、 --cpuset.

- それだけ
テキスト出力には、指定されたタイプのオブジェクトのみを表示します。

- 無視
タイプのすべてのオブジェクトを無視しますトポロジ内。 hwlocは無視をサポートします
PUおよびI / Oデバイスを除くタイプ。 ただし、lstopoは、非表示にすることでPUを無視します。
グラフィックおよびテキスト出力のPUオブジェクト。 PUは無視できないことに注意してください
XML出力で。 トップレベルのオブジェクトタイプは無視できないことにも注意してください
（通常はマシンまたはシステム）。

-キャッシュなし
キャッシュを表示しません。

--無駄なキャッシュはありません
階層的な影響を与えないキャッシュを表示しないでください。 これは
キャッシュオブジェクトの場合はhwloc_topology_ignore_type_keep_structure（）。

-ノーイカッシュ
命令キャッシュは表示せず、データキャッシュと統合キャッシュのみが表示されます。

-システム全体
管理上の制限を考慮しないでください。

- マージ
階層的な影響を与えないレベルを表示しないでください。 これは
hwloc_topology_ignore_all_keep_structure（）。

-崩壊なし
同一のPCIデバイスを折りたたまないでください。 デフォルトでは、同一の兄弟PCIデバイス
（単一の物理デバイス内の多くの仮想機能など）は折りたたまれています。

- 制限
トポロジーを指定されたcpusetに制限します。

- 制限 拘束
トポロジを現在のプロセスバインディングに制限します。 このオプションを使用する必要があります
実際の現在のマシントポロジ（またはその他のトポロジ -このシステム or
環境内でHWLOC_THISSYSTEMを1に設定します）。

--制限フラグ
トポロジを制限するときにフラグを適用します。 デフォルトは 0。 これらのフラグは
に渡された hwloc_topology_restrict（）.

--no-io
I / Oデバイスまたはブリッジを表示しないでください。 デフォルトでは、一般的なデバイス（GPU、NIC、
ブロックデバイス、...）と興味深いブリッジが表示されます。

-ブリッジなし
ホストブリッジ以外のI / Oブリッジは表示しないでください。 デフォルトでは、一般的なデバイス（GPU、
NIC、ブロックデバイス、...）および興味深いブリッジが表示されます。

--全体-io
すべてのI / Oデバイスとブリッジを表示します。 デフォルトでは、一般的なデバイス（GPU、NIC、
ブロックデバイス、...）と興味深いブリッジが表示されます。

-このシステム
選択したバックエンドが、システムのトポロジを提供するとします。
走っている。 これは、使用するときに便利です - 制限 カスタムのバインドとロード
XMLファイルなどのトポロジ。

--pid
プロセスから見たトポロジを検出する、つまりプロセスのようにしました
発見そのもの。 これにより、たとえば許可されたセットを変更できることに注意してください
プロセッサ。 また、マークを付けて、このプロセスの現在のCPUバインディングを示します
対応するPU（グラフィック出力では緑色で表示されます。以下の「色」セクションを参照してください。
または追加することによって （拘束力） 詳細なテキスト出力に）。 pidとして0が指定されている場合、
lstopoプロセスの現在のバインディングが表示されます。

--ps - 上
既存のプロセスをその他のオブジェクトとして出力に表示します。 無駄に避けるために
出力が乱雑になり、一部に制限されているプロセスのみ
マシンが表示されます。 Linuxでは、カーネルスレッドは表示されません。 多くのプロセスがある場合
とにかく出力が読みにくくなり、hwloc-psプログラムがより多くなる可能性があります
実用的。

- フォントサイズ
テキストフォントのサイズを設定します。

-グリッドサイズ
要素間のマージンのサイズを設定します。

--水平線, --水平線=
ほぼ4/3の比率ではなく、水平方向のグラフィックレイアウト。 カンマ区切りのリストの場合
タイプが指定されている場合、レイアウトは対応するコンテナにのみ適用されます。

--vert, --vert=
ほぼ4/3の比率ではなく、垂直方向のグラフィックレイアウト。 カンマ区切りのリストの場合
タイプが指定されている場合、レイアウトは対応するコンテナにのみ適用されます。

--rect, --rect=
NUMAを配置する場合を含め、比率がほぼ4/3の長方形のグラフィックレイアウト
ノード。 タイプのコンマ区切りリストが指定されている場合、レイアウトは
対応するコンテナ。

-凡例なし
下部にあるテキストの凡例を削除します。

-追加-凡例
グラフィカルモードで凡例の下部にテキスト行を追加します。 ラインの場合
長すぎると、出力で切り捨てられます。 複数の行を追加する場合は、それぞれ
このオプションを複数回渡すことにより、行を個別に指定する必要があります。

- バージョン
バージョンを報告して終了します。

DESCRIPTION

lstopoおよびlstopo-no-graphicsは、システムのトポロジーマップを表示することができます。
さまざまな異なる出力形式。 lstopoとlstopo-no-の唯一の違い
グラフィックスは、グラフィックス出力がlstopoでのみサポートされ、依存関係を減らすことです。
外部ライブラリ。 hwloc-lsはlstopo-no-graphicsと同じです。

指定されたファイル名は、使用される出力形式を直接意味します。 を参照してください
以下の「出力フォーマット」セクション。 色をサポートする出力形式は、特定のものを示します
色による個々のCPUの特性。 以下の「色」セクションを参照してください。

出力 書式

デフォルトでは、出力ファイル名が特定されていない場合、出力は次の場合にグラフィカルウィンドウに送信されます。
現在の環境で可能です（Unixで設定されたDISPLAY環境変数など）。
それ以外の場合は、テキストの要約がコンソールに表示されます。

コマンドラインのファイル名は通常、出力の形式を決定します。 あります
特定の出力形式とデバイスを示すいくつかのファイル名（たとえば、「-」のファイル名）
テキストの要約をstdoutに出力します）が、ほとんどのファイル名は目的の出力を示します
接尾辞でフォーマットします（たとえば、「topo.png」loading = "lazy"はPNG形式のファイルを出力します）。

出力の形式も「--of」で変更できます。 たとえば、「-ofpdf」は
標準出力でPDF形式のファイルを生成し、「-offigtoto」は
「toto」という名前のXfig形式のファイル。

現在サポートされているフォーマットのリストを以下に示します。 それらのいずれかを使用できます
「--of」またはファイル名のサフィックスとして。

デフォルト
環境に応じて、出力をウィンドウまたはコンソールに送信します。

コンソール
テキストの要約をstdoutに送信します。 バインド、許可されていない、またはオフラインのプロセッサのみ
冗長な場合は、このモードで注釈が付けられます。 以下の「色」セクションを参照してください。

アスキー マップのASCIIアート表現を出力します（以前は呼ばれていました） TXT）。 出力する場合
stdoutに、端末で色がサポートされている場合、出力は次のようになります。
色付き。

イチジク Xfigにロードできるマップの表現を出力します。

PDFファイル lstopoが適切なサポートでコンパイルされた場合、lstopoはPDF表現を出力します
地図の。

ps lstopoが適切なサポートでコンパイルされた場合、lstopoはPostscriptを出力します
マップの表現。

PNG lstopoが適切なサポートでコンパイルされた場合、lstopoはPNG表現を出力します
地図の。

SVG lstopoが適切なサポートでコンパイルされた場合、lstopoはSVGを出力します
マップの表現。

合成
トポロジが対称である場合（ルートオブジェクトに
symmetric_subtreeフィールドセット）、lstopoは合成記述文字列を出力します。 この
出力は、後で入力合成トポロジー記述として再利用できます。 ご了承ください
I / Oデバイスは、多くの場合、トポロジの非対称性を引き起こします。 --no-ioを追加すると、次の場合に役立つことがあります。
合成エクスポートは失敗します。 の「合成トポロジ」セクションも参照してください。
のドキュメントで詳しく説明されています）。

XML lstopoが適切なサポートでコンパイルされた場合、lstopoはXMLを出力します
マップの表現。 別のマシンでも、後で再利用できます。
lstopo --input、HWLOC_XMLFILE環境変数、または
hwloc_topology_set_xml（）関数。

次の特別な名前を使用できます。

- テキストの要約をstdoutに送信します。

/ dev / stdout
テキストの要約をstdoutに送信します。 事実上、「-」を指定するのと同じです。

-。
ファイル名全体が「-」の場合。 "、lstopoは次のように動作します" --of -" だった
与えられた、これは与えられたフォーマットのファイルが標準出力に送られることを意味します。

グラフィック出力形式の具体的なリストについては、「lstopo--help」の出力を参照してください。
hwlocインストールでサポートされています。

COLORS

個々のCPUは、グラフィック出力形式で色分けされ、異なることを示します
特徴：

緑トポロジは、特定のプロセスから見たものとして報告されます（を参照）。 --pid）、および与えられた
CPUはこのプロセスのCPUバインディングマスクにあります。

白CPUは許可されたセットにあります（以下を参照）。 トポロジが次のように報告されている場合
特定のプロセス（を参照） --pid）、指定されたCPUもこのプロセスCPUにはありません
バインディングマスク。

赤CPUが許可されたセットにありません（以下を参照）。

黒CPUがオフラインです（すべてのOSがオフラインCPUの表示をサポートしているわけではありません）。

「許可されたセット」は、現在のプロセスがバインドできるCPUのセットです。 NS
許可されたセットは通常、親プロセスから継承されるか、管理者によって設定されます
システム上のqpolicies。 Linux cpusetsは、許可されたセットを制限するXNUMXつの例です。
プロセスとその子は、システム上のCPUのフルセットよりも少なくなります。

したがって、プロセスが異なれば、許可されたセットのCPUも異なる可能性があります。 したがって、呼び出す
さまざまなコンテキストで、および/またはさまざまなユーザーがさまざまな色を表示する可能性があるため、lstopo
同じ個々のCPU（たとえば、あるコンテキストでlstopoを実行すると、特定のCPUが次のように表示される場合があります）
赤ですが、別のコンテキストでlstopoを実行すると、白と同じCPUが表示される場合があります）。

一部のlstopo出力モード（コンソールモード（デフォルトの非グラフィック出力）など）は、
まったく色をサポートします。 コンソールモードでは、上記の特性を追加して表示します
詳細メッセージが有効になっている場合は、各PU行にテキストを送信します。

CUSTOM COLORS

グラフィック出力の各オブジェクトの色は、
そのオブジェクトの「lstopoStyle」情報属性。 その値はセミコロンで区切る必要があります
「のリスト=＃rrggbb "ここで、rr、gg、およびbbは、それぞれ色のRGBコンポーネントです。
0〜255、00進数（XNUMX〜ff）。 多分

経歴
メインオブジェクトボックスの背景色を設定します。

Background2
オブジェクトの追加ボックスの背景色を設定します。たとえば、
NUMAノードボックス内のメモリボックス。

テキスト オブジェクト名、タイプ、インデックスなどを示すテキストの色を設定します。

Text2 リンク速度など、オブジェクトの近くの追加テキストの色を設定します
PCIブリッジの背後。

「lstopoStyle」情報は、hwloc-を使用して一時的に保存されたXMLトポロジに追加できます。
注釈を付けるか、hwloc_obj_add_info（）を使用します。 たとえば、すべてのコアオブジェクトを青色で表示するには
（白い名前で）：

lstopo 保存.xml
hwloc-annotate save.xml save.xml core：all info lstopoStyle
"背景=＃0000ff;テキスト=＃ffffff"
lstopo -i save.xml

レイアウト

そのグラフィカル出力では、lstopoは単純な長方形のヒューリスティックを使用して4/3を達成しようとします
幅と高さの比率。 ただし、NUMAノードの特定のケースでは、レイアウト
特定のNUMAトポロジをユーザーに信じ込ませないように、は常にフラットな長方形です。
（lstopoはまだそれをレンダリングできません）。 レベルのレイアウトは次のように変更できます
--vert、-horiz、および--rect。

例

マシントポロジをテキストモードで表示するには：

lstopo-グラフィックなし

アスキーアートモードでマシントポロジを表示するには：

lstopo-no-graphics -.ascii

グラフィカルモードで表示するには（DISPLAY環境変数が
関連する値）：

イストポ

トポロジをPNGファイルにエクスポートするには：

lstopo ファイル.png

マシン上でXMLファイルをエクスポートし、後で対応するグラフィック出力をに表示するには
別のマシン：

machine1 $ lstopo file.xml

machine2 $ lstopo --input file.xml

現在のマシントポロジをXMLに保存し、後でそれを高速にリロードするには
それを現在のマシンと見なす：

$ lstopo ファイル.xml
<...>
$ lstopo --input file.xml --thissystem

XMLトポロジを物理プロセッサ0、1、4、および5のみに制限するには：

lstopo --input file.xml --restrict 0x33 newfile.xml

XMLトポロジを論理インデックスが1のnumaノードのみに制限するには

lstopo --input file.xml --restrict $（hwloc-calc --input file.xml node：1）newfile.xml

トポロジーの要約を表示するには：

lstopo -s

トポロジの詳細を取得するには：

lstopo -v

コアのみを表示するには：

lstopo-コアのみ

cpusetsを表示するには：

lstopo --cpuset

パッケージのcpusetsのみを表示するには：

lstopo --only package--cpuset-only

偽の階層をシミュレートします。 この例は、2つのプロセッサユニットの2つのNUMAノードを示しています。

lstopo --input "n：2 2"

システム内の論理プロセッサの数をカウントするには

lstopo --pu のみ | トイレ -l

カーネルのリリースとバージョンをグラフィカルな凡例に追加するには：

lstopo --append-legend "カーネルリリース：$（uname -r）" --append-legend "カーネルバージョン：
$（uname -v） "

onworks.netサービスを使用してオンラインでlstopoを使用する