From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751255AbaEMQuG (ORCPT ); Tue, 13 May 2014 12:50:06 -0400 Received: from mx1.redhat.com ([209.132.183.28]:49913 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752382AbaEMQtY (ORCPT ); Tue, 13 May 2014 12:49:24 -0400 From: Don Zickus To: acme@ghostprotocols.net, peterz@infradead.org Cc: LKML , jolsa@redhat.com, namhyung@gmail.com, eranian@google.com, Andi Kleen , Don Zickus Subject: [PATCH 4/6] perf report: Add mem-mode documentation to report command Date: Tue, 13 May 2014 12:48:15 -0400 Message-Id: <1399999697-65875-5-git-send-email-dzickus@redhat.com> In-Reply-To: <1399999697-65875-1-git-send-email-dzickus@redhat.com> References: <1399999697-65875-1-git-send-email-dzickus@redhat.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add mem-mode sorting types and mem-mode itself to perf-report documentation. Signed-off-by: Don Zickus --- tools/perf/Documentation/perf-report.txt | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/tools/perf/Documentation/perf-report.txt b/tools/perf/Documentation/perf-report.txt index 09af662..bea1c83 100644 --- a/tools/perf/Documentation/perf-report.txt +++ b/tools/perf/Documentation/perf-report.txt @@ -98,6 +98,21 @@ OPTIONS And default sort keys are changed to comm, dso_from, symbol_from, dso_to and symbol_to, see '--branch-stack'. + If --mem-mode option is used, following sort keys are also available + (incompatible with --branch-stack): + symbol_daddr, dso_daddr, locked, tlb, mem, snoop. + + - symbol_daddr: name of data symbol being executed on at the time of sample + - dso_daddr: name of library or module containing the data being executed + on at the time of sample + - locked: whether the bus was locked at the time of sample + - tlb: type of tlb access for the data at the time of sample + - mem: type of memory access for the data at the time of sample + - snoop: type of snoop (if any) for the data at the time of sample + + And default sort keys are changed to local_weight, mem, sym, dso, + symbol_daddr, dso_daddr, snoop, tlb, locked, see '--mem-mode'. + -p:: --parent=:: A regex filter to identify parent. The parent is a caller of this @@ -236,6 +251,13 @@ OPTIONS Demangle symbol names to human readable form. It's enabled by default, disable with --no-demangle. +--mem-mode:: + Use the data addresses of samples in addition to instruction addresses + to build the histograms. To generate meaningful output, the perf.data + file must have been obtained using perf record -d -W and using a + special event -e cpu/mem-loads/ or -e cpu/mem-stores/. See + 'perf mem' for simpler access. + --percent-limit:: Do not show entries which have an overhead under that percent. (Default: 0). -- 1.7.11.7