pmlist Command
Purpose
Lists information about supported processors.
Syntax
pmlist [ -h ]
pmlist { -s | -e ShortName | -c Counter [ ,event ] | -g Group | -S Set | -D DerivedMetricID | -m MetricGroup | -V Variable } [ -p ProcessorType ] [ -s ] [ -d ] [ -o t | c | x ] [ -f Filter ]
Description
The pmlist command performs
the following functions:
- List the supported processors.
- List the information summary for a specified processor.
- List the event table for a specified processor.
- List any existing event groups for a specified processor.
- List any existing event sets for a specified processor.
- List the event set and formula for a specified derived metric.
- List the variables in the derived metric files.
Flags
| Item | Description |
|---|---|
| -c -1 | Lists all events for all counters. |
| -c Counter | Lists all events for the specified Counter. |
| -c Counter,Event | Lists the specified Event for the specified Counter. |
| -d | Displays event detailed description. |
| -D -1 | Displays all the derived metrics supported. |
| -D DerivedMetricID | Displays the specified DerivedMetricID. |
| -e ShortName | Lists the description of the specified ShortName for all Counters. |
| -f v,u,c | Specifies the event filter as a comma-separated list of filters. The valid filters are: v (verified) , u (unverified) , and c (caveat). These filters represent the testing status of an event. The default filter is v,u,c. |
| -g -1 | Lists all event groups. |
| -g Group | Lists the specified event Group. |
| -h | displays help information for the pmlist command. |
| -l | Lists all supported processor types. |
| -m -1 | Lists all derived metrics by metric group. |
| -m MetricGroup | Displays all the derived metrics that pertain to the specified MetricGroup. |
| -o t | c | x | Specifies the output format for the pmlist command. The valid output formats are specified as one of: t (text format), c (CSV format) and x (XML format). The default output format is text. |
| -p ProcessorType | Specifies the processor type. |
| -s | Displays the processor information summary. |
| -S -1 | Displays all the event sets supported. |
| -S Set | Displays the specified event Set. |
| -V -1 | Displays all the variables that are used to calculate derived metrics. |
| -V Variable | Displays the specified variable. |
Examples
- To display the list of all supported processors, type:
pmlist -l - To display a summary information for the current processor, type:
pmlist -s - To display a summary information for the current processor in
CSV format, type:
pmlist -s -o c - To display group number
62for the current processor (if the current processor supports event groups), type:pmlist -g 62 - To display detailed information for event 3 of counter 1 of POWER4 processor, type:
pmlist -p POWER4 -c 1,3 -d - To display set number 2 for the current processor (if the current
processor supports event sets), type:
pmlist -S 2