From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754328AbbCCGXs (ORCPT ); Tue, 3 Mar 2015 01:23:48 -0500 Received: from terminus.zytor.com ([198.137.202.10]:49235 "EHLO terminus.zytor.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753836AbbCCGXq (ORCPT ); Tue, 3 Mar 2015 01:23:46 -0500 Date: Mon, 2 Mar 2015 22:23:25 -0800 From: tip-bot for Namhyung Kim Message-ID: Cc: a.p.zijlstra@chello.nl, namhyung@kernel.org, mingo@kernel.org, eranian@google.com, hpa@zytor.com, linux-kernel@vger.kernel.org, acme@redhat.com, jolsa@redhat.com, tglx@linutronix.de Reply-To: tglx@linutronix.de, jolsa@redhat.com, linux-kernel@vger.kernel.org, hpa@zytor.com, eranian@google.com, acme@redhat.com, mingo@kernel.org, namhyung@kernel.org, a.p.zijlstra@chello.nl In-Reply-To: <1425266013-5034-1-git-send-email-namhyung@kernel.org> References: <1425266013-5034-1-git-send-email-namhyung@kernel.org> To: linux-tip-commits@vger.kernel.org Subject: [tip:perf/core] perf record: Document --group option Git-Commit-ID: 9a75606ca06d94aab1ed0dbe96935e3f89dfb81c 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: 9a75606ca06d94aab1ed0dbe96935e3f89dfb81c Gitweb: http://git.kernel.org/tip/9a75606ca06d94aab1ed0dbe96935e3f89dfb81c Author: Namhyung Kim AuthorDate: Mon, 2 Mar 2015 12:13:33 +0900 Committer: Arnaldo Carvalho de Melo CommitDate: Mon, 2 Mar 2015 12:04:45 -0300 perf record: Document --group option The 'perf record --group' option lacks documentation and confuses users. As -e/--event option already supports group spec, it should not be used anymore. Also add a short description of event group itself. Reported-by: Stephane Eranian Signed-off-by: Namhyung Kim Cc: Jiri Olsa Cc: Peter Zijlstra Cc: Stephane Eranian Link: http://lkml.kernel.org/r/1425266013-5034-1-git-send-email-namhyung@kernel.org Signed-off-by: Arnaldo Carvalho de Melo --- tools/perf/Documentation/perf-record.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/tools/perf/Documentation/perf-record.txt b/tools/perf/Documentation/perf-record.txt index 4d66894..355c4f5 100644 --- a/tools/perf/Documentation/perf-record.txt +++ b/tools/perf/Documentation/perf-record.txt @@ -55,6 +55,11 @@ OPTIONS If you want to profile write accesses in [0x1000~1008), just set 'mem:0x1000/8:w'. + - a group of events surrounded by a pair of brace ("{event1,event2,...}"). + Each event is separated by commas and the group should be quoted to + prevent the shell interpretation. You also need to use --group on + "perf report" to view group events together. + --filter=:: Event filter. @@ -104,6 +109,10 @@ OPTIONS specification with appended unit character - B/K/M/G. The size is rounded up to have nearest pages power of two value. +--group:: + Put all events in a single event group. This precedes the --event + option and remains only for backward compatibility. See --event. + -g:: Enables call-graph (stack chain/backtrace) recording.