[PATCH] perf, tools: Describe uncore event changes in perf list

From: Andi Kleen
Date: Thu Apr 20 2017 - 16:54:55 EST


From: Andi Kleen <ak@xxxxxxxxxxxxxxx>

Describe the new uncore wildcard PMU match in the perf list
manpage.

Also fix a typo in an existing example.

Signed-off-by: Andi Kleen <ak@xxxxxxxxxxxxxxx>
---
tools/perf/Documentation/perf-list.txt | 12 +++++++++++-
1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/tools/perf/Documentation/perf-list.txt b/tools/perf/Documentation/perf-list.txt
index f709de54707b..b6eaa2b34921 100644
--- a/tools/perf/Documentation/perf-list.txt
+++ b/tools/perf/Documentation/perf-list.txt
@@ -134,12 +134,22 @@ all the CPUs in the same socket.
This example measures memory bandwidth every second
on the first memory controller on socket 0 of a Intel Xeon system

- perf stat -C 0 -a uncore_imc_0/cas_count_read/,uncore_imc_0/cas_count_write/ -I 1000 ...
+ perf stat -C 0 -e uncore_imc_0/cas_count_read/,uncore_imc_0/cas_count_write/ -I 1000 ...

Each memory controller has its own PMU. Measuring the complete system
bandwidth would require specifying all imc PMUs (see perf list output),
and adding the values together.

+perf supports wildcard matches on uncore PMUs. All "imc" boxes can be
+specified with
+
+ perf stat ... -e uncore_imc/cas_count_read/ -I 1000
+
+and perf will automatically measure all "imc" PMUs and sum them together.
+For the special case of a uncore prefix this can be also shortened to
+
+ perf stat ... -e imc/cas_count_read/ -I 1000
+
This example measures the combined core power every second

perf stat -I 1000 -e power/energy-cores/ -a
--
2.9.3