public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: tip-bot for Shawn Bohrer <shawn.bohrer@gmail.com>
To: linux-tip-commits@vger.kernel.org
Cc: acme@redhat.com, linux-kernel@vger.kernel.org, paulus@samba.org,
	hpa@zytor.com, mingo@redhat.com, a.p.zijlstra@chello.nl,
	shawn.bohrer@gmail.com, tglx@linutronix.de, mingo@elte.hu
Subject: [tip:perf/core] perf stat: Document missing options
Date: Thu, 2 Dec 2010 11:47:23 GMT	[thread overview]
Message-ID: <tip-8c207692fc8fa3ea1a5ff97ad698efb09a81975a@git.kernel.org> (raw)
In-Reply-To: <1291168642-11402-12-git-send-email-shawn.bohrer@gmail.com>

Commit-ID:  8c207692fc8fa3ea1a5ff97ad698efb09a81975a
Gitweb:     http://git.kernel.org/tip/8c207692fc8fa3ea1a5ff97ad698efb09a81975a
Author:     Shawn Bohrer <shawn.bohrer@gmail.com>
AuthorDate: Tue, 30 Nov 2010 19:57:19 -0600
Committer:  Arnaldo Carvalho de Melo <acme@redhat.com>
CommitDate: Wed, 1 Dec 2010 18:22:49 -0200

perf stat: Document missing options

Cc: Ingo Molnar <mingo@elte.hu>
Cc: Paul Mackerras <paulus@samba.org>
Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
LKML-Reference: <1291168642-11402-12-git-send-email-shawn.bohrer@gmail.com>
Signed-off-by: Shawn Bohrer <shawn.bohrer@gmail.com>
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
---
 tools/perf/Documentation/perf-stat.txt |   34 +++++++++++++++++++++++++------
 1 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/tools/perf/Documentation/perf-stat.txt b/tools/perf/Documentation/perf-stat.txt
index c405bca..c469ba5 100644
--- a/tools/perf/Documentation/perf-stat.txt
+++ b/tools/perf/Documentation/perf-stat.txt
@@ -8,8 +8,8 @@ perf-stat - Run a command and gather performance counter statistics
 SYNOPSIS
 --------
 [verse]
-'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] <command>
-'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] -- <command> [<options>]
+'perf stat' [-e <EVENT> | --event=EVENT] [-a] <command>
+'perf stat' [-e <EVENT> | --event=EVENT] [-a] -- <command> [<options>]
 
 DESCRIPTION
 -----------
@@ -35,21 +35,33 @@ OPTIONS
         child tasks do not inherit counters
 -p::
 --pid=<pid>::
-        stat events on existing pid
+        stat events on existing process id
+
+-t::
+--tid=<tid>::
+        stat events on existing thread id
+
 
 -a::
-        system-wide collection
+--all-cpus::
+        system-wide collection from all CPUs
 
 -c::
-        scale counter values
+--scale::
+	scale/normalize counter values
+
+-r::
+--repeat=<n>::
+	repeat command and print average + stddev (max: 100)
 
 -B::
+--big-num::
         print large numbers with thousands' separators according to locale
 
 -C::
 --cpu=::
-Count only on the list of cpus provided. Multiple CPUs can be provided as a
-comma-sperated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
+Count only on the list of CPUs provided. Multiple CPUs can be provided as a
+comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
 In per-thread mode, this option is ignored. The -a option is still necessary
 to activate system-wide monitoring. Default is to count on all CPUs.
 
@@ -58,6 +70,14 @@ to activate system-wide monitoring. Default is to count on all CPUs.
 Do not aggregate counts across all monitored CPUs in system-wide mode (-a).
 This option is only valid in system-wide mode.
 
+-n::
+--null::
+        null run - don't start any counters
+
+-v::
+--verbose::
+        be more verbose (show counter open errors, etc)
+
 EXAMPLES
 --------
 

  reply	other threads:[~2010-12-02 11:47 UTC|newest]

Thread overview: 30+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-12-01  1:57 [PATCH 00/14] perf documentation updates Shawn Bohrer
2010-12-01  1:57 ` [PATCH 01/14] perf: Document missing annotate options Shawn Bohrer
2010-12-02 11:42   ` [tip:perf/core] perf annotate: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 02/14] perf: Document missing buildid-list options Shawn Bohrer
2010-12-02 11:43   ` [tip:perf/core] perf buildid-list: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 03/14] perf: fix diff displacement and modules options short flag Shawn Bohrer
2010-12-02 11:43   ` [tip:perf/core] perf diff: Fix " tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 04/14] perf: Document missing diff options Shawn Bohrer
2010-12-02 11:43   ` [tip:perf/core] perf diff: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 05/14] perf: Document missing kvm options Shawn Bohrer
2010-12-02 11:44   ` [tip:perf/core] perf kvm: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 06/14] perf: Document missing lock options Shawn Bohrer
2010-12-02 11:44   ` [tip:perf/core] perf lock: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 07/14] perf: Fix spelling mistake in probe documentation Shawn Bohrer
2010-12-01  8:22   ` Masami Hiramatsu
2010-12-02 11:44   ` [tip:perf/core] perf probe: Fix spelling mistake in documentation tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 08/14] perf: Document missing record options Shawn Bohrer
2010-12-02 11:45   ` [tip:perf/core] perf record: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 09/14] perf: Document missing report options Shawn Bohrer
2010-12-02 11:45   ` [tip:perf/core] perf report: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 10/14] perf: Document missing sched options Shawn Bohrer
2010-12-02 11:46   ` [tip:perf/core] perf sched: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 11/14] perf: Document missing stat options Shawn Bohrer
2010-12-02 11:47   ` tip-bot for Shawn Bohrer [this message]
2010-12-01  1:57 ` [PATCH 12/14] perf: Fix spelling mistake in test documentation Shawn Bohrer
2010-12-02 11:47   ` [tip:perf/core] perf test: Fix spelling mistake in documentation tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 13/14] perf: Document missing top options Shawn Bohrer
2010-12-02 11:46   ` [tip:perf/core] perf top: Document missing options tip-bot for Shawn Bohrer
2010-12-01  1:57 ` [PATCH 14/14] perf: Document missing trace options Shawn Bohrer
2010-12-02 11:46   ` [tip:perf/core] perf trace: Document missing options tip-bot for Shawn Bohrer

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=tip-8c207692fc8fa3ea1a5ff97ad698efb09a81975a@git.kernel.org \
    --to=shawn.bohrer@gmail.com \
    --cc=a.p.zijlstra@chello.nl \
    --cc=acme@redhat.com \
    --cc=hpa@zytor.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-tip-commits@vger.kernel.org \
    --cc=mingo@elte.hu \
    --cc=mingo@redhat.com \
    --cc=paulus@samba.org \
    --cc=tglx@linutronix.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox