mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
829fc3b294
Update and add description for new flags -x -X -s -H for command lshwc. Signed-off-by: Thomas Richter <tmricht@linux.ibm.com> Reviewed-by: Maria Eisenhaendler <maria1@de.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
168 lines
4.1 KiB
Groff
168 lines
4.1 KiB
Groff
.\" lshwc.8
|
|
.\"
|
|
.\"
|
|
.\" Copyright IBM Corp. 2021
|
|
.\" s390-tools is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the MIT license. See LICENSE for details.
|
|
.\" ----------------------------------------------------------------------
|
|
.ds c \fBlshwc\fP
|
|
.
|
|
.TH \*c "8" "Mar 2025" "s390-tools" "CPU-MF management programs"
|
|
.
|
|
.SH NAME
|
|
lshwc \- extract CPU Measurement Facilities counter sets
|
|
.
|
|
.SH SYNOPSIS
|
|
\*c
|
|
.RB [ \-a ][ \-H][ \-s ][ \-x ][ \-X]
|
|
.RB [ \-l
|
|
.IR count ]
|
|
.RB [ \-i
|
|
.IR interval ]
|
|
\fR[\fIcpulist\fR][:\fIsets\fR]\fP
|
|
.br
|
|
\*c
|
|
.BR \-h | \-\-help
|
|
.br
|
|
\*c
|
|
.BR \-v | \-\-version
|
|
.
|
|
.
|
|
.SH DESCRIPTION
|
|
The \*c command extracts complete counter sets from the CPU
|
|
Measurement Facilities for Linux on Z.
|
|
Counter sets can be specified and extracted for individual CPUs.
|
|
The output is a comma-separated values file.
|
|
Each line starts with a timestamp and the CPU number,
|
|
followed by the extracted counter values.
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Displays help information, then exits.
|
|
.
|
|
.TP
|
|
.BR \-v ", " \-\-version
|
|
Displays version information, then exits.
|
|
.
|
|
.TP
|
|
.BR \-a ", " \-\-allcpu
|
|
Displays counter values from each CPU.
|
|
The default is a total summary line of all counters from all CPUs.
|
|
.
|
|
.TP
|
|
.BR \-i ", " \-\-interval \fI\ seconds\fP
|
|
Specifies a time interval, in seconds,
|
|
that the command waits between read operations.
|
|
The default is 60 seconds.
|
|
.
|
|
.TP
|
|
.BR \-l ", " \-\-loop \fI\ count\fP
|
|
Performs the specified number of read operations.
|
|
.
|
|
.TP
|
|
.BR \-H ", " \-\-hide
|
|
Do not display values of undefined counters.
|
|
.
|
|
.TP
|
|
.BR \-s ", " \-\-short
|
|
Displays counter names as short names in the heading.
|
|
A short name consists of
|
|
a letter for the counter set followed by a number.
|
|
For example,
|
|
this flag displays counter number 0 in the basic counter
|
|
set as
|
|
.B B0
|
|
instead of
|
|
.BR Cycles .
|
|
Valid counter set letters are:
|
|
.RS
|
|
.IP B
|
|
Basic counter set
|
|
.IP P
|
|
Problem state counter set
|
|
.IP C
|
|
Crypto counter set
|
|
.IP E
|
|
Extended counter set
|
|
.IP M
|
|
MT-Diagnostic counter set
|
|
.IP U
|
|
Undefined counter.
|
|
.RE
|
|
.
|
|
.TP
|
|
.BR \-x ", " \-\-hex
|
|
Displays counter values as hexadecimal values.
|
|
.
|
|
.TP
|
|
.BR \-X ", " \-\-hex0x
|
|
Displays counter values as hexadecimal values with a leading 0x prefix.
|
|
.
|
|
.TP
|
|
\fR[\fIcpulist\fR][:\fIsets\fR]\fP
|
|
A comma-separated list of CPUs.
|
|
Each CPU can optionally be followed by characters that specify the counter set.
|
|
See below for details.
|
|
.
|
|
.SS "CPU List and counter-set specification"
|
|
In the comma-separated list of CPUs,
|
|
each element is a CPU or a range of CPUs.
|
|
By default, \*c lists all CPUs.
|
|
.P
|
|
The CPU list can be followed by an optional list
|
|
of characters that specify the counter sets to be extracted,
|
|
preceded by a colon.
|
|
The characters can be upper or lower case.
|
|
By default, all counter sets are used.
|
|
.IP b
|
|
Include the basic counter set.
|
|
.IP c
|
|
Include the crypto counter set.
|
|
.IP e
|
|
Include the extended counter set.
|
|
.IP m
|
|
Include the MT_Diagnostic counter set.
|
|
.IP p|u
|
|
Include the problem counter set.
|
|
.IP a
|
|
Include all known counter sets (default).
|
|
.SH "EXAMPLES"
|
|
The first example enables the basic and problem counter sets on CPU 0 and 1.
|
|
Two read operations are performed and a summary line is printed for each
|
|
read operation.
|
|
.sp 1
|
|
.nf
|
|
.ft CW
|
|
# lshwc -l2 0-1:BP
|
|
Date,Time,CPU,CPU_CYCLES(0),INSTRUCTIONS(1),L1I_DIR_WRITES(2),L1I_PENALTY_CYCLES(3),L1D_DIR_WRITES(4),
|
|
L1D_PENALTY_CYCLES(5),PROBLEM_STATE_CPU_CYCLES(32),PROBLEM_STATE_INSTRUCTIONS(33)
|
|
2021-04-01,11:50:32,Total,125422,39421,304,13953,454,
|
|
97489,0,0
|
|
2021-04-01,11:51:32,Total,68074231,16386850,194028,21382384,317227,
|
|
104503489,777383,14198
|
|
.ft
|
|
.fi
|
|
.sp 1
|
|
This example shows the counter values of the problem state counter set
|
|
per CPU. CPU 0 and CPU 1 is selected.
|
|
.nf
|
|
.ft CW
|
|
.sp 1
|
|
# lshwc -l3 -a 0-1:P
|
|
Date,Time,CPU,PROBLEM_STATE_CPU_CYCLES(32),PROBLEM_STATE_INSTRUCTIONS(33)
|
|
2021-04-01,11:54:47,CPU0,0,0
|
|
2021-04-01,11:54:47,CPU1,0,0
|
|
2021-04-01,11:54:47,Total,0,0
|
|
2021-04-01,11:55:47,CPU0,818775,14198
|
|
2021-04-01,11:55:47,CPU1,125689,1306
|
|
2021-04-01,11:55:47,Total,944464,15504
|
|
2021-04-01,11:56:47,CPU0,3207071426,1489122591
|
|
2021-04-01,11:56:47,CPU1,3225092021,1489278312
|
|
2021-04-01,11:56:47,Total,6432163447,2978400903
|
|
.ft
|
|
.fi
|
|
.SH "SEE ALSO"
|
|
.BR lscpumf (8)
|
|
.BR chcpumf (8)
|