lscpumf - Display information about the CPU-measurement facilities

Red Hat Enterprise Linux 8.6 LPAR mode

Use the lscpumf command to display information about the CPU-measurement facilities.

lscpumf syntax

where:

-i or --info: displays detailed information about available and supported CPU measurement facilities.
-c or --list-counters: lists counters that are provided by the CPU-measurement facility, omitting counters for which the LPAR is not authorized. For counter measurements with the perf program, the raw event identifier and symbolic counter name are displayed.
-C or --list-all-counters: lists all counters that are provided by the CPU-measurement counter facility, regardless of LPAR authorization. To list only those counters for which the LPAR is authorized, use the -c option. For counter measurements with the perf program, the raw event identifier and symbolic counter name are displayed.
-s or --list-sampling-events: lists perf raw events that activate the sampling facility.
-v or --version: displays the version number of lscpumf and exits.
-h or --help: displays out a short help text, then exits. To view the man page, enter man lscpumf.

Examples

To display the supported facilities, issue:

# lscpumf
CPU-measurement Counter Facility
CPU-measurement Sampling Facility

To display details about the facilities, issue:

# lscpumf -i
CPU-measurement counter facility
--------------------------------------------------------------------------
Version: 1.2

Authorized counter sets:
    Basic counter set
    Problem-State counter set

Linux perf event support: Yes (PMU: cpum_cf)


CPU-measurement sampling facility
--------------------------------------------------------------------------
Sampling Interval:
     Minimum:      18228 cycles (approx.   285714 Hz)
     Maximum:  170650536 cycles (approx.       30 Hz)

Authorized sampling modes:
     basic      (sample size:  32 bytes)


Linux perf event support: Yes (PMU: cpum_sf)

Current sampling buffer settings for cpum_sf:
    Basic-sampling mode
        Minimum:     15 sample-data-blocks (  64KB)
        Maximum:   8176 sample-data-blocks (  32MB)

To display perf event information for authorized sampling functions, issue:

# lscpumf -s
Perf events for activating the sampling facility
==============================================================================

Raw
event   Name    Description
------------------------------------------------------------------------------
rb0000  SF_CYCLES_BASIC

                Sample CPU cycles using basic-sampling mode.
                This event is not associated with a counter set.

To list all counters that are provided by your IBM Z® hardware, issue:

# lscpumf -C
Perf event counter list for IBM z13
==============================================================================

Raw
event   Name    Description
------------------------------------------------------------------------------
r0      CPU_CYCLES

                Cycle Count.
                Counter 0 / Basic Counter Set.

r1      INSTRUCTIONS

                Instruction Count.
                Counter 1 / Basic Counter Set.

r2      L1I_DIR_WRITES

                Level-1 I-Cache Directory Write Count.
                Counter 2 / Basic Counter Set.

r3      L1I_PENALTY_CYCLES

                Level-1 I-Cache Penalty Cycle Count.
                Counter 3 / Basic Counter Set.

r4      L1D_DIR_WRITES

                Level-1 D-Cache Directory Write Count.
                Counter 4 / Basic Counter Set.

r5      L1D_PENALTY_CYCLES

                Level-1 D-Cache Penalty Cycle Count.
                Counter 5 / Basic Counter Set.

r20     PROBLEM_STATE_CPU_CYCLES

                Problem-State Cycle Count.
                Counter 32 / Problem-State Counter Set.

r21     PROBLEM_STATE_INSTRUCTIONS

                Problem-State Instruction Count.
                Counter 33 / Problem-State Counter Set.
 ...