跳过导航链接 | |
退出打印视图 | |
![]() |
手册页第 1 部分:用户命令 Oracle Solaris 11 Information Library (简体中文) |
- 显示有关地址组的信息
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 包含域中位于最大等待时间范围内的所有资源。
一个统一内存访问 (Uniform Memory Access, UMA) 计算机由根 lgroup 来简明地表示。非统一内存访问 (Non Uniform Memory Access, NUMA) 计算机由一个 lgroup 层次结构表示以显示地址的相应级别。例如,具有两个等待时间(本地和远程)的 NUMA 计算机具有由叶和根两个级别组成的 lgroup 层次结构。
每个应用程序线程都分配有一个主 lgroup。当系统需要为线程分配 CPU 或内存资源时,它将从线程的主 lgroup 中搜索 lgroup 分层结构以查找离线程的主 lgroup 最近的可用资源。有关详细信息,请参见 plgrp(1)。
不使用参数时,lgrpinfo 将输出关于系统中的所有 lgroup 的常规信息。如果在命令行上指定了任何 lgroup ID,该命令仅输出有关指定的 lgroup 的信息。各个选项用于控制显示哪些 lgroup 以及为每个 lgroup 输出的确切信息。
可以在命令行上通过 lgroup ID 或使用特定的关键字指定 lgroup。请参见 OPERANDS(操作数)。
可以组合使用这些选项,指定选项时的顺序不重要。小写字母选项指定应输出关于 lgroup 的什么信息。
不带参数调用 lgrpinfo 等效于以下命令:
lgrpinfo -c -e -l -m -r -t all
支持下列选项:
输出拓扑、CPU、内存、负荷和等待时间信息。
此选项是以下内容的简略表达方法
lgrpinfo -t -c -e -m -r -l -L
除非还指定了 -T。如果指定了 -T,将不包括 -t 选项。
输出 CPU 信息。
这是缺省值。
将列表中的每个 lgroup 替换为其子代。
此选项不能与 -P 或 -T 选项一起使用。如果未指定任何参数,则此选项应用于缺省情况下显示的 lgroup。
输出 lgroup 平均负荷值。只会为叶 lgroup 显示 lgroup 平均负荷值。
这是缺省值。
输出 lgroup 层次结构的操作系统视图。
缺省情况下,会显示调用者的 lgroup 层次结构视图,其中仅包括调用者可以使用的内容,例如,仅显示调用者的处理器集合中的 CPU。有关操作系统和调用者的视图,请参见 lgrp_init(3LGRP)。
输出简短帮助消息并退出。
仅输出匹配的 ID。
此选项用于脚本,并可以与 -c、-G 以及 -C 或 -P 一起使用。如果指定了 -c,将输出所有匹配 lgroup 中包含的 CPU 的列表。否则,将显示匹配的 lgroup 的 ID。请参见示例。
如果未指定任何参数,则此选项应用于缺省情况下显示的 lgroup(即所有 lgroup)。
输出有关 lgroup 等待时间的信息。
为每个 lgroup 指定的等待时间值是由操作系统定义的,并特定于平台。它只能用于在正在运行的系统上对 lgroup 进行相对比较。它不一定表示硬件设备之间的实际等待时间,可能不适合跨平台使用。
输出 lgroup 等待时间表。lgroup 等待时间表显示每个 lgroup 相对于其他各个 lgroup(包括本身)的相对等待时间。
输出内存信息。
除非还指定了 -u 选项,否则将根据情况对内存大小的单位进行调整,使最后生成的值为 0 到 1023 之间的整数。只会为小于 10 的值显示数字的小数部分。此行为类似于使用 ls(1) 或 df(1M) 的 -h 选项显示人类可阅读的格式。
这是缺省值。
将列表中的每个 lgroup 替换为其父代。
此选项无法与 -C 或 -T 选项一起使用。如果未指定任何参数,则此选项应用于缺省情况下显示的 lgroup(即所有 lgroup)。
输出有关 lgroup 资源的信息。
资源由一组 lgroup 来表示,其中每个成员 lgroup 直接包含 CPU 和内存资源。如果还指定了 -T,则只会显示有关中间 lgroup 的资源的信息。
输出有关 lgroup 拓扑的信息。
这是缺省值。
以图形方式将系统的 lgroup 拓扑输出为树的形式。此选项只能与 -a、-c、-e、-G、-l、-L、-m、-r 和 -u 选项一起使用。当与 -r 一起使用时,它只会输出中间 lgroup 的 lgroup 资源。当 -T 与 -a 一起使用时,-t 选项会被忽略。不会输出根 lgroup 的任何信息,除非它是唯一的 lgroup。
指定内存单位。单位应该为 b、k、m、g、t、p 或 e,分别表示字节、千字节、兆字节、千兆字节、兆兆字节、千兆兆字节、艾字节。只会为小于 10 的值显示数字的小数部分。此行为类似于使用 ls(1) 或 df(1M) 的 -h 选项显示人类可阅读的格式。
支持下列操作数:
可以在命令行上通过 lgroup ID 或使用以下关键字之一来指定 lgroup:
所有 lgroup。
这是缺省值。
所有中间 lgroup。中间 lgroup 是具有父代和子代的 lgroup。
所有叶 lgroup。叶 lgroup 是在 lgroup 层次结构中没有子代的 lgroup。
根 lgroup。根 lgroup 包含域中位于最大等待时间范围内的所有资源,且没有父 lgroup。
如果指定的 lgroup 无效,lgrpinfo 命令将在标准错误上输出一条显示有无效 ID 的消息,然后继续处理命令行中指定的其他 lgroup。如果指定的所有 lgroup 均无效,lgrpinfo 将退出且退出状态为 2。
示例 1 输出有关 lgroup 的信息
以下示例输出关于系统中的 lgroup 的常规信息。
在此示例中,系统为具有两个节点的 2 CPU AMD Opteron 计算机,每个节点具有一个 CPU 和 2 千兆字节的内存。每个节点由一个叶 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 拓扑
以下示例输出了 4 CPU AMD Opteron 计算机上的 lgroup 拓扑树:
$ lgrpinfo -T 0 |-- 5 | `-- 1 |-- 6 | `-- 2 |-- 7 | `-- 3 `-- 8 `-- 4
示例 3 输出 lgroup 拓扑
以下示例输出了 2 CPU AMD Opteron 计算机上的 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
将返回以下退出值:
成功完成。
无法从系统获取 lgroup 信息。
指定的所有 lgroup 均无效。
语法无效。
有关下列属性的描述,请参见 attributes(5):
|
人类可读的输出是 "Uncommitted"(未确定)。
ls(1)、plgrp(1)、pmap(1)、proc(1)、ps(1)、df(1M)、prstat(1M)、lgrp_init(3LGRP)、liblgrp(3LIB)、proc(4)、attributes(5)