From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752166AbcAEJ06 (ORCPT ); Tue, 5 Jan 2016 04:26:58 -0500 Received: from mx1.redhat.com ([209.132.183.28]:40607 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751477AbcAEJ0F (ORCPT ); Tue, 5 Jan 2016 04:26:05 -0500 Date: Tue, 5 Jan 2016 10:26:01 +0100 From: Jiri Olsa To: Namhyung Kim Cc: Arnaldo Carvalho de Melo , Ingo Molnar , Peter Zijlstra , LKML , David Ahern , Steven Rostedt , Frederic Weisbecker , Andi Kleen , Wang Nan Subject: Re: [PATCH 3/5] perf tools: Add document for dynamic sort keys Message-ID: <20160105092601.GB21867@krava.brq.redhat.com> References: <1451963027-16973-1-git-send-email-namhyung@kernel.org> <1451963027-16973-3-git-send-email-namhyung@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1451963027-16973-3-git-send-email-namhyung@kernel.org> User-Agent: Mutt/1.5.24 (2015-08-30) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Jan 05, 2016 at 12:03:45PM +0900, Namhyung Kim wrote: > Signed-off-by: Namhyung Kim Acked-by: Jiri Olsa thanks, jirka > --- > 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 ae7cd91727f6..8a301f6afb37 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. > -- > 2.6.4 >