lstopo - 云端在线

程序：

您的姓名

lstopo, lstopo-no-graphics, hwloc-ls - 显示系统的拓扑

概要

停止 [ 选项 ]……[ 文件名 ]

lstopo 无图形 [ 选项 ]……[ 文件名 ]

hwloc-ls [ 选项 ]……[ 文件名 ]

需要注意的是 硬件(7)提供了hwloc系统的详细解释； 它应该被阅读
在阅读此手册页之前

配置

- 的 , - 输出格式
以给定的格式强制输出。 请参阅下面的输出格式部分。

-i , - 输入
从 XML 文件读取拓扑（而不是发现拓扑
本地机器）。 如果是“-”，使用标准输入。 XML 支持必须
已被编译到 hwloc 以便此选项可用。

-i , - 输入
从指定的 chroot 读取拓扑（而不是发现
本地机器上的拓扑）。 此选项通常仅在 Linux 上可用。
chroot 通常是通过使用 hwloc- 收集另一个机器拓扑来创建的
聚集拓扑。

-i , - 输入
模拟一个虚假的层次结构（而不​​是在本地发现拓扑
机器）。 如果是“node:2 pu:3”，拓扑将包含两个 NUMA
每个节点有 3 个处理单元。 这字符串必须结束
带有多个 PU。

- 如果 , --输入格式
以给定的格式强制输入，其中 XML, 根目录 和 合成的.

--导出合成标志
导出为合成格式时强制使用标志。 这些标志被传递给
hwloc_topology_export_synthetic(). 值为 2 将恢复为 hwloc 的格式
v1.9。 值为 3 将恢复为原始的简约格式（v1.9 之前）。

-v --详细
包括额外的细节。 hwloc-info 工具可用于显示更多
有关特定对象的信息。

-s - 沉默的
减少要显示的细节数量。

-f - 力量
如果目标文件已存在，请覆盖它。

-l --逻辑
显示 hwloc 逻辑索引而不是物理/操作系统索引（控制台的默认值）
输出）。 这些索引以“L#”为前缀。 部分物理指标
对象（默认为 PU 和 Node，所有对象如果详细）将显示为对象
属性“P#...”。

-p - 身体的
显示操作系统/物理索引而不是 hwloc 逻辑索引（图形的默认值）
输出）。 这些索引在控制台中以“P#”而不是“L#”为前缀
输出。

-c --CPU集
显示每个对象的cpuset。

-C --仅cpuset
只显示每个对象的cpuset； 不显示任何关于
目的。

--任务集
以任务集命令行程序识别的格式显示 CPU 集字符串
而不是特定于 hwloc 的 CPU 设置字符串格式。 这个选项应该结合
--CPU集 or --仅cpuset，否则就意味着 --CPU集.

- 只要
仅在文本输出中显示给定类型的对象。

- 忽略
忽略所有类型的对象在拓扑中。 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().

--无io
不要显示任何 I/O 设备或桥接器。 默认情况下，常用设备（GPU、NIC、
块设备，...) 和有趣的桥显示。

--无桥
除了主机桥之外，不要显示任何 I/O 桥。 默认情况下，常用设备（GPU、
显示了 NIC、块设备等）和有趣的网桥。

--整个io
显示所有 I/O 设备和网桥。 默认情况下，只有普通设备（GPU、NIC、
块设备，...) 和有趣的桥显示。

--本系统
假设选定的后端为我们在其上的系统提供拓扑
正在跑步。 这在使用时很有用 - 严格 绑定和加载自定义
拓扑，例如 XML 文件。

--pid
检测进程所见的拓扑, 即好像处理做了
发现本身。 请注意，这可以例如更改允许的集合
处理器。 还通过标记来显示此进程当前的 CPU 绑定
相应的 PU（图形输出中的绿色，请参阅下面的颜色部分，
或通过附加 （捆绑） 到详细的文本输出）。 如果 0 作为 pid 给出，则
将显示 lstopo 进程的当前绑定。

--ps - 最佳
在输出中将现有进程显示为 misc 对象。 避免无用
使输出混乱，只有仅限于某些部分的进程
机显示。 在 Linux 上，不显示内核线程。 如果多个进程
出现，无论如何输出可能变得难以阅读，使 hwloc-ps 程序更
实际的。

- 字体大小
设置文本字体的大小。

--网格大小
设置元素之间的边距大小。

--地平线, --地平线=
水平图形布局而不是接近 4/3 的比例。 如果一个逗号分隔的列表
类型给出，布局只适用于相应的容器。

--vert, --vert=
垂直图形布局而不是接近 4/3 的比例。 如果一个逗号分隔的列表
类型给出，布局只适用于相应的容器。

--矩形, --矩形=
比例接近 4/3 的矩形图形布局，包括放置 NUMA 时
节点。 如果给出了逗号分隔的类型列表，则布局仅适用于
对应的容器。

--无图例
删除底部的文本图例。

--追加图例
在图形模式下将文本行附加到图例的底部。 如果线
太长，它会在输出中被截断。 如果添加多行，则每行
应通过多次传递此选项来单独给出行。

- 版
报告版本并退出。

商品描述

lstopo 和 lstopo-no-graphics 能够显示系统的拓扑图
多种不同的输出格式。 lstopo 和 lstopo-no- 之间的唯一区别
图形是图形输出仅由 lstopo 支持，以减少对
外部库。 hwloc-ls 与 lstopo-no-graphics 相同。

指定的文件名直接暗示将使用的输出格式； 见
输出格式部分，如下。 支持颜色的输出格式将指示特定的
各个 CPU 的颜色特征； 请参阅下面的颜色部分。

OUTPUT FORMATS

默认情况下，如果没有特定的输出文件名，则输出将发送到图形窗口，如果
在当前环境中可能（在 Unix 等上设置的 DISPLAY 环境变量）。
否则，将在控制台中显示文本摘要。

命令行上的文件名通常决定输出的格式。 有一个
表示特定输出格式和设备的少数文件名（例如，文件名“-”
将输出一个文本摘要到标准输出），但大多数文件名表示所需的输出
格式（例如，“topo.png” loading="lazy" 将输出 PNG 格式的文件）。

输出的格式也可以用“--of”改变。 例如，“--of pdf”将
在标准输出上生成一个 PDF 格式的文件，而“--of fig toto”将输出一个
名为“toto”的 Xfig 格式文件。

下面给出了当前支持的格式列表。 它们中的任何一个都可以与
“--of”或作为文件名后缀。

默认
根据环境将输出发送到窗口或控制台。

领事
将文本摘要发送到标准输出。 绑定、不允许或离线的处理器只是
如果冗长，则在此模式下进行注释； 请参阅下面的颜色部分。

ASCII 输出地图的 ASCII 艺术表示（以前称为 TXT）。 如果输出
到标准输出，如果终端支持颜色，输出​​将是
着色。

图 输出可在 Xfig 中加载的地图表示。

PDF格式 如果 lstopo 是在适当的支持下编译的， lstopo 会输出一个 PDF 表示
地图的。

ps 如果 lstopo 是在适当的支持下编译的，lstopo 会输出一个 Postscript
地图的表示。

PNG 如果 lstopo 是在适当的支持下编译的，lstopo 将输出一个 PNG 表示
地图的。

SVG 如果 lstopo 是在适当的支持下编译的，lstopo 会输出一个 SVG
地图的表示。

合成的
如果拓扑是对称的（这要求根对象具有
symmetry_subtree 字段集），lstopo 输出合成描述字符串。 这个
输出可以在以后重新用作输入合成拓扑描述。 注意
I/O 设备经常导致拓扑不对称。 添加 --no-io 可能会在以下情况下有用
合成导出失败。 另见综合拓扑部分
文档。

XML 如果 lstopo 是在适当的支持下编译的， lstopo 会输出一个 XML
地图的表示。 它可以在以后重用，甚至在另一台机器上，
lstopo --input、HWLOC_XMLFILE 环境变量，或
hwloc_topology_set_xml() 函数。

可以使用以下特殊名称：

- 将文本摘要发送到标准输出。

/开发/标准输出
将文本摘要发送到标准输出。 它实际上与指定“-”相同。

-.
如果整个文件名是“-. ", lstopo 表现得好像 "--of -“ 曾是
给定，这意味着给定格式的文件被发送到标准输出。

有关图形输出格式的特定列表，请参阅“lstopo --help”的输出
在您的 hwloc 安装中支持。

COLORS

单个 CPU 以图形输出格式着色以指示不同的
特点：

绿色 拓扑报告为特定进程所见（请参阅 --pid)，以及给定的
CPU在这个过程中是CPU绑定掩码。

白色 CPU 在允许的范围内（见下文）。 如果拓扑报告如所见
一个特定的过程（见 --pid)，给定的CPU也不是这个进程的CPU
绑定面具。

红色 CPU 不在允许的范围内（见下文）。

黑色 CPU 离线（并非所有操作系统都支持显示离线 CPU）。

“允许集”是允许当前进程绑定到的 CPU 集。 这
允许集通常是从父进程继承或由管理设置
系统上的qpolicies。 Linux cpusets 是限制允许的集合的一个例子
进程及其子进程小于系统上的全套 CPU。

因此，不同的进程在允许的集合中可能有不同的 CPU。 因此，调用
lstopo 在不同的上下文和/或不同的用户可能会显示不同的颜色
相同的单个 CPU（例如，在一个上下文中运行 lstopo 可能会将特定 CPU 显示为
红色，但在不同的上下文中运行 lstopo 可能会显示与白色相同的 CPU）。

某些 lstopo 输出模式，例如控制台模式（默认非图形输出），不
完全支持颜色。 控制台模式通过附加
如果启用详细消息，则将文本发送到每个 PU 行。

定制 COLORS

图形输出中每个对象的颜色可以通过指定一个
该对象中的“lstopoStyle”信息属性。 它的值应该是一个分号分隔
清单 ” =#rrggbb" 其中 rr、gg 和 bb 是颜色的 RGB 分量，每个
0 到 255 之间，十六进制（00 到 ff）。 或许

背景
设置主对象框的背景颜色。

背景2
设置对象的附加框的背景颜色，例如
NUMA 节点盒内的内存盒。

文本 设置显示对象名称、类型、索引等的文本颜色。

文字2 设置对象附近附加文本的颜色，例如链接速度
在 PCI 桥后面。

“lstopoStyle”信息可以通过 hwloc- 添加到临时保存的 XML 拓扑中
注释，或使用 hwloc_obj_add_info()。 例如，以蓝色显示所有核心对象
（白人名）：

lstopo 保存.xml
hwloc-annotate save.xml save.xml 核心：所有信息 lstopoStyle
“背景=#0000ff；文字=#ffffff”
lstopo -i 保存.xml

布局

在其图形输出中，lstopo 使用简单的矩形启发式方法来尝试实现 4/3
宽高比。 然而，在 NUMA 节点的特殊情况下，布局
总是一个平面矩形，以避免让用户相信任何特定的 NUMA 拓扑
（lstopo 还不能呈现）。 一个级别的布局可能会改变
--vert、--horiz 和--rect。

示例

要以文本模式显示机器拓扑：

lstopo 无图形

以 ascii-art 模式显示机器拓扑：

lstopo-无图形-.ascii

以图形模式显示（假设 DISPLAY 环境变量设置为
相关值）：

停止

要将拓扑导出到 PNG 文件：

lstopo文件.png

在机器上导出 XML 文件，然后在机器上显示相应的图形输出
另一台机器：

machine1$ lstopo 文件.xml

machine2$ lstopo --输入文件.xml

将当前机器拓扑保存为 XML 并在稍后重新加载时更快
将其视为当前机器：

$ lstopo 文件.xml
<...>
$ lstopo --输入文件.xml --thissystem

要将 XML 拓扑限制为仅物理处理器 0、1、4 和 5：

lstopo --输入文件.xml --限制 0x33 新文件.xml

要将 XML 拓扑限制为仅逻辑索引为 1 的 numa 节点：

lstopo --input file.xml --restrict $(hwloc-calc --input file.xml 节点:1) newfile.xml

要显示拓扑摘要：

伊斯托波-s

要获取有关拓扑的更多详细信息：

伊斯托波-v

仅显示核心：

lstopo --only 核心

要显示 cpuset：

lstopo--cpuset

只显示包的cpusets：

lstopo --only 包 --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