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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-Id: <20170420205447.25936-1-andi@firstfloor.org>
Date:   Thu, 20 Apr 2017 13:54:47 -0700
From:   Andi Kleen <andi@...stfloor.org>
To:     acme@...nel.org
Cc:     jolsa@...nel.org, linux-kernel@...r.kernel.org,
        Andi Kleen <ak@...ux.intel.com>
Subject: [PATCH] perf, tools: Describe uncore event changes in perf list

From: Andi Kleen <ak@...ux.intel.com>

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@...ux.intel.com>
---
 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