跳过导航链接 | |
退出打印视图 | |
![]() |
手册页第 1 部分:用户命令 Oracle Solaris 11.1 Information Library (简体中文) |
- 显示有关地址组的信息
lgrpinfo [-aceGlLmrt] [-u unit] [-C | -P] lgrp ...
lgrpinfo -h
lgrpinfo -I [-c] [-G] [-C | -P] lgrp ...
lgrpinfo [-T] [-aceGlLmr] [-u unit]
lgrpinfo -d device_path
lgrpinfo 输出有关地址组 (lgroup) 分层结构及其内容的信息。
lgroup 表示彼此之间最多相隔某个间隔(等待时间)的 CPU 和内存之类的硬件设备的集合。系统中的所有 lgroup 都由一个称作 lgroup ID 的唯一整数进行标识。
lgroup 组织到分层结构中,以便于查找最近的资源。每个叶 lgroup 包含一组彼此之间最近的(本地的)资源。分层结构中的每个父 lgroup 都包含其子 lgroup 的资源以及其最邻近的资源。最后,root 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。请参见“操作数”部分。
可以组合使用这些选项,指定选项时的顺序不重要。小写字母选项用于选择应输出关于 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。
输出与指定的 I/O 设备最近的 lgroup 的 ID。device_path 是表示设备路径的字符串。
输出 lgroup 平均负荷值。只会为叶 lgroups 显示 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 相对于其他各个 lgroups(包括自身)的相对等待时间。
输出内存信息。
除非还指定了 -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 选项会被忽略。不会输出 root 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
示例 7 输出与给定设备最近的 lgroup 的 ID
以下示例表明 lgroup 2 和 6 与给定设备最近。
$ lgrpinfo -d /dev/dsk/c9t0d0s0 lgroup IDs : 2 6
将返回以下退出值:
成功完成。
无法从系统获取 lgroup 信息。
指定的所有 lgroups 或 device_path 无效。
语法无效。
有关下列属性的说明,请参见 attributes(5):
|
人类可读的输出是 "Uncommitted"(未确定)。
ls(1)、plgrp(1)、pmap(1)、proc(1)、ps(1)、df(1M)、prstat(1M)、lgrp_init(3LGRP)、liblgrp(3LIB)、lgrp_cpus(3LGRP)、lgrp_resources(3LGRP)、proc(4)、attributes(5)