From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1034129AbdDTUyw (ORCPT ); Thu, 20 Apr 2017 16:54:52 -0400 Received: from mga05.intel.com ([192.55.52.43]:54606 "EHLO mga05.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1034114AbdDTUyu (ORCPT ); Thu, 20 Apr 2017 16:54:50 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.37,227,1488873600"; d="scan'208";a="91970771" From: Andi Kleen To: acme@kernel.org Cc: jolsa@kernel.org, linux-kernel@vger.kernel.org, Andi Kleen Subject: [PATCH] perf, tools: Describe uncore event changes in perf list Date: Thu, 20 Apr 2017 13:54:47 -0700 Message-Id: <20170420205447.25936-1-andi@firstfloor.org> X-Mailer: git-send-email 2.9.3 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Andi Kleen 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 --- 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