lspai - List Processor Activity Instrumentation counters

6.18 LPAR mode

Use the lspai command to list counter data about cryptographic and analytic CPU instructions. For more information about Processor Activity Instrumentation (PAI) counters, see Using the CPU Processor Activity Instrumentation Facility.

lspai syntax

where:

-t or --type <type>

specifies the type of PAI counter set to list. The default is to list all available PAI counter sets. Valid values for <type> are:

crypto: limits the list to the cryptographic processing assist facility counter set.

nnpa: limits the list to the Neural Network Processing Assist (NNPA) facility counter set.

-n or --numeric

Lists the PAI counter sets sorted by counter number. The default sort order is by PAI counter name.

Example

This example lists all PAI NNPA counters in numeric order:

# lspai -t nnpa -n
RAW     NAME          DESCRIPTION
13:6144 NNPA_ALL      Counter 0 / PAI NNPA counter set
13:6145 NNPA_ADD      Counter 1 / PAI NNPA counter set
13:6146 NNPA_SUB      Counter 2 / PAI NNPA counter set
13:6147 NNPA_MUL      Counter 3 / PAI NNPA counter set
...

The first column shows the raw event number, which you can use to specify raw events for the perf tool. The second column shows the PAI NNPA counter name, which you can use to specify events by name for the perf tool. The third column gives a short explanation, if one is available.

For details about the perf tool, see Obtaining counter and sample data with the perf tool.