From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756512AbcAIQ3l (ORCPT ); Sat, 9 Jan 2016 11:29:41 -0500 Received: from terminus.zytor.com ([198.137.202.10]:41889 "EHLO terminus.zytor.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755829AbcAIQ3i (ORCPT ); Sat, 9 Jan 2016 11:29:38 -0500 Date: Sat, 9 Jan 2016 08:28:51 -0800 From: tip-bot for Namhyung Kim Message-ID: Cc: acme@redhat.com, rostedt@goodmis.org, jolsa@kernel.org, hpa@zytor.com, dsahern@gmail.com, linux-kernel@vger.kernel.org, tglx@linutronix.de, peterz@infradead.org, fweisbec@gmail.com, namhyung@kernel.org, mingo@kernel.org, wangnan0@huawei.com, andi@firstfloor.org Reply-To: linux-kernel@vger.kernel.org, dsahern@gmail.com, hpa@zytor.com, jolsa@kernel.org, rostedt@goodmis.org, acme@redhat.com, andi@firstfloor.org, wangnan0@huawei.com, mingo@kernel.org, namhyung@kernel.org, fweisbec@gmail.com, tglx@linutronix.de, peterz@infradead.org In-Reply-To: <1451991518-25673-3-git-send-email-namhyung@kernel.org> References: <1451991518-25673-3-git-send-email-namhyung@kernel.org> To: linux-tip-commits@vger.kernel.org Subject: [tip:perf/core] perf report: Add documentation for dynamic sort keys Git-Commit-ID: 4c96bee03247c6eab27287fa66457a231b9fab79 X-Mailer: tip-git-log-daemon Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=UTF-8 Content-Disposition: inline Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit-ID: 4c96bee03247c6eab27287fa66457a231b9fab79 Gitweb: http://git.kernel.org/tip/4c96bee03247c6eab27287fa66457a231b9fab79 Author: Namhyung Kim AuthorDate: Tue, 5 Jan 2016 19:58:36 +0900 Committer: Arnaldo Carvalho de Melo CommitDate: Wed, 6 Jan 2016 20:11:14 -0300 perf report: Add documentation for dynamic sort keys Signed-off-by: Namhyung Kim Acked-by: Jiri Olsa Cc: Andi Kleen Cc: David Ahern Cc: Frederic Weisbecker Cc: Peter Zijlstra Cc: Steven Rostedt Cc: Wang Nan Link: http://lkml.kernel.org/r/1451991518-25673-3-git-send-email-namhyung@kernel.org Signed-off-by: Arnaldo Carvalho de Melo --- tools/perf/Documentation/perf-report.txt | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/tools/perf/Documentation/perf-report.txt b/tools/perf/Documentation/perf-report.txt index ae7cd91..8a301f6 100644 --- a/tools/perf/Documentation/perf-report.txt +++ b/tools/perf/Documentation/perf-report.txt @@ -117,6 +117,30 @@ OPTIONS And default sort keys are changed to comm, dso_from, symbol_from, dso_to and symbol_to, see '--branch-stack'. + If the data file has tracepoint event(s), following (dynamic) sort keys + are also available: + trace, trace_fields, [.][/raw] + + - trace: pretty printed trace output in a single column + - trace_fields: fields in tracepoints in separate columns + - : optional event and field name for a specific field + + The last form consists of event and field names. If event name is + omitted, it searches all events for matching field name. The matched + field will be shown only for the event has the field. The event name + supports substring match so user doesn't need to specify full subsystem + and event name everytime. For example, 'sched:sched_switch' event can + be shortened to 'switch' as long as it's not ambiguous. Also event can + be specified by its index (starting from 1) preceded by the '%'. + So '%1' is the first event, '%2' is the second, and so on. + + The field name can have '/raw' suffix which disables pretty printing + and shows raw field value like hex numbers. The --raw-trace option + has the same effect for all dynamic sort keys. + + The default sort keys are changed to 'trace' if all events in the data + file are tracepoint. + -F:: --fields=:: Specify output field - multiple keys can be specified in CSV format.