System Administration Commands pginfo(1M)
NAME
pginfo - display information about processor groups
SYNOPSIS
pginfo [-T] [-p] [-v] [-r string] [-R string]
[pg ... | -c processor_id ...]
pginfo -s [-v] [-r string] [-R string] [pg ... | -c processor_id ...]
pginfo -c | -I [-r string] [-R string] [pg ... | -c processor_id ...]
pginfo -h
DESCRIPTION
The pginfo displays information about the Processor Group
(PG) hierarchy, its contents, and its characteristics. A PG is a set of CPUs that are grouped together by a common characteristic. PGs are used by the operating system to represent the CPUsthat share performance relevant hardware such as the execu-
tion pipelines, caches, and so forth. These PGs are organ-
ized into a hierarchy that models the processor topology of the machine. In this hierarchy, each CPU (strand) has a leaf PG that represents the CPUs that share the most hardwarewith it. Each successive ancestor of the leaf PG shares pro-
gressively less hardware with the CPU until the root PG is reached. The root PG contains all of the CPUs in the system and represents the group of CPUs sharing the least hardwarewith each other. (See EXAMPLES below for an example of PG
hierarchy.)If a machine does not have any performance-relevant hardware
sharing relationships, then pginfo displays only a root PG
that contains all of the CPUs in the system.By default, pginfo displays information about each PG in the
system, including its PG ID, sharing relationship, and online and offline CPUs. It displays the PGs in depth first order by default and uses indentation to help show how thePGs are related to each other (see EXAMPLES below).
You can specify options to:SunOS 5.11 Last change: 18 Aug 2010 1
System Administration Commands pginfo(1M)
o Display the PG hierarchy graphically o List the PG sharing relationships that exist on the running system o Give current PG utilization information, specifyingPGs of interest by PG ID, CPU ID, or sharing rela-
tionship o Specify that only CPU or PG IDs be displayedIn addition, there is a -p option to show which PGs contain
the CPUs that correspond to the CPUs with a common physical relationship such as system, chip, and core. These physical relationships describe the physical characteristics of theCPUs and might or might not encapsulate performance-relevant
processor sharing relationships.If the system configuration repeatedly changes when pginfo
is obtaining a snapshot of system data, pginfo displays an
error message and terminates with exit status 1. OPTIONS The following options are supported:-c processor_id ...
Interpret arguments as processor IDs and display onlyinformation about PGs that contain the specified proces-
sors.When used with the -T option, this option limits the PG
hierarchy displayed to include only the lineage of each of the specified CPUs. This option cannot be used when specifying PGs of interest by PG ID.-C
Display only CPU IDs for all CPUs belonging to the PGs.This option cannot be used at the same time as the -I
option.-h
Display short help message and exit with exit status 0.SunOS 5.11 Last change: 18 Aug 2010 2
System Administration Commands pginfo(1M)
-I
Display only PG IDs for the PGs. This option cannot beused at the same time as the -C option.
-p
Display the physical relationship that corresponds to a PGs. If a PG has the same CPUs as the whole system, a processor core, or a chip, system, core, or chip will bedisplayed, as appropriate, after the sharing relation-
ship of the PG in square brackets ("[]").-r string1,string2,...
Display only information about PGs with a sharing rela-
tionship name that matches any of the specified strings. Each specified string can be a whole relationship name or a portion of one or more relationship names and thestring matching is case-insensitive. The possible rela-
tionship names are in the list of sharing relationshipsthat the -s option displays.
You can specify multiple -r options, which results in
matching all PGs with a relationship name that containany of the specified strings. When used with the -T
option, this option limits the PG hierarchy displayed to include only the lineage of each of the PGs with the specified relationship.-R string1,string2,...
Display only information about PGs with a sharing rela-
tionship name other than the one(s) specified. String matching is the same as described above for the-r option. Multiple -R options can be entered.
-s
Display all sharing relationships supported on the run-
ning system for the specified PGs. The -v option can be
used with this option to get the list of PGs for each sharing relationship.SunOS 5.11 Last change: 18 Aug 2010 3
System Administration Commands pginfo(1M)
-T
In the resulting hierarchy, the lineage of each CPU (hardware strand) is arranged from the PGs that share the most hardware in common with the CPU to the PGs that share the least with the CPU. If any CPUs, PGs, or relationships of interest are specified, the resulting PG hierarchy is limited to the lineages of the PGs with the specified CPUs, PGs, or relationships in the PG hierarchy.-v
Verbose mode. Display additional information about PGs.When used without -s, -C, or -I, it is equivalent to
giving the -T and -p options together at the same time.
When used with the -s option, it gives the list of PGs
for each sharing relationship. OPERANDS The following operands can be given on the command line by specifying one or more of their corresponding IDs or thekeyword all. Multiple IDs can be specified as a space-
separated list (for example, 1 3), a range of numbers (forexample, 5-8), or both (for example, 1 3 5-8 13-16). PGs and
CPUs cannot be specified at the same time.pg PGs of interest can be specified on the com-
mand line by PG ID.processor_id When the -c option is entered, CPUs of
interest can be specified on the command line by CPU ID.If an invalid PG or CPU is specified, the pginfo command
displays a message on standard error showing the invalid ID and continues processing other PGs or CPUs specified on the command line. When none of the specified PGs or CPUs arevalid, pginfo exits with an exit status of 2.
EXAMPLES
In the examples below, the system contains one UltraSPARC T1 processor chip with 8 cores and 32 strands. Example 1 Displaying Information About Every PGSunOS 5.11 Last change: 18 Aug 2010 4
System Administration Commands pginfo(1M)
The following command, using no arguments, displays informa-
tion about every PG.$ pginfo
PG RELATIONSHIP CPUs0 System 0-31
3 Data_Pipe_to_memory 0-31
2 Floating_Point_Unit 0-31
1 Integer_Pipeline 0-3
4 Integer_Pipeline 4-7
5 Integer_Pipeline 8-11
6 Integer_Pipeline 12-15
7 Integer_Pipeline 16-19
8 Integer_Pipeline 20-23
9 Integer_Pipeline 24-27
10 Integer_Pipeline 28-31
Example 2 Displaying Information About All Sharing Relation-
ships The following command displays information about all sharing relationships.$ pginfo -s -v
RELATIONSHIP PGs-------------------- -------
System 0Data_Pipe_to_memory 3
Floating_Point_Unit 2
Integer_Pipeline 1 4-10
Example 3 Displaying PG Hierarchy The following command displays general information about all PGs in the system. The output shows which PGs belong to chips and cores.$ pginfo -p -T
0 (System) CPUs: 0-31
`-- 3 (Data_Pipe_to_memory [system,chip]) CPUs: 0-31
`-- 2 (Floating_Point_Unit [system,chip]) CPUs: 0-31
|-- 1 (Integer_Pipeline [core]) CPUs: 0-3
|-- 4 (Integer_Pipeline [core]) CPUs: 4-7
SunOS 5.11 Last change: 18 Aug 2010 5
System Administration Commands pginfo(1M)
|-- 5 (Integer_Pipeline [core]) CPUs: 8-11
|-- 6 (Integer_Pipeline [core]) CPUs: 12-15
|-- 7 (Integer_Pipeline [core]) CPUs: 16-19
|-- 8 (Integer_Pipeline [core]) CPUs: 20-23
|-- 9 (Integer_Pipeline [core]) CPUs: 24-27
`-- 10 (Integer_Pipeline [core]) CPUs: 28-31
Example 4 Displaying List with Specific Criterion The following command displays a list of CPUs sharing integer pipeline with CPU 0. This example also demonstratesthe use of -r option to filter PGs by sharing relationship
name.$ pginfo -r integer_pipeline -C -c 0
0 1 2 3 Example 5 Using Option to Exclude by Specific Criterion The following command lists all PGs other than the ones thathave Integer_Pipeline as their relationship.
$ pginfo -R Integer_Pipeline
PG RELATIONSHIP CPUs0 System 0-31
3 Data_Pipe_to_memory 0-31
2 Floating_Point_Unit 0-31
EXIT STATUS 0 Successful completion. 1 An error occurred. 2 Invalid syntax.SunOS 5.11 Last change: 18 Aug 2010 6
System Administration Commands pginfo(1M)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWesu ||_____________________________|_____________________________|
| Interface Stability | Uncommitted ||_____________________________|_____________________________|
The command line options and output are Uncommitted.SEE ALSO
pgstat(1M), attributes(5)SunOS 5.11 Last change: 18 Aug 2010 7