Commit 8c207692fc8fa3ea1a5ff97ad698efb09a81975a

Authored by Shawn Bohrer
Committed by Arnaldo Carvalho de Melo
1 parent f68d6bd451

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>

Showing 1 changed file with 27 additions and 7 deletions Side-by-side Diff

tools/perf/Documentation/perf-stat.txt
... ... @@ -8,8 +8,8 @@
8 8 SYNOPSIS
9 9 --------
10 10 [verse]
11   -'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] <command>
12   -'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] -- <command> [<options>]
  11 +'perf stat' [-e <EVENT> | --event=EVENT] [-a] <command>
  12 +'perf stat' [-e <EVENT> | --event=EVENT] [-a] -- <command> [<options>]
13 13  
14 14 DESCRIPTION
15 15 -----------
16 16  
17 17  
18 18  
19 19  
20 20  
21 21  
... ... @@ -35,21 +35,33 @@
35 35 child tasks do not inherit counters
36 36 -p::
37 37 --pid=<pid>::
38   - stat events on existing pid
  38 + stat events on existing process id
39 39  
  40 +-t::
  41 +--tid=<tid>::
  42 + stat events on existing thread id
  43 +
  44 +
40 45 -a::
41   - system-wide collection
  46 +--all-cpus::
  47 + system-wide collection from all CPUs
42 48  
43 49 -c::
44   - scale counter values
  50 +--scale::
  51 + scale/normalize counter values
45 52  
  53 +-r::
  54 +--repeat=<n>::
  55 + repeat command and print average + stddev (max: 100)
  56 +
46 57 -B::
  58 +--big-num::
47 59 print large numbers with thousands' separators according to locale
48 60  
49 61 -C::
50 62 --cpu=::
51   -Count only on the list of cpus provided. Multiple CPUs can be provided as a
52   -comma-sperated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
  63 +Count only on the list of CPUs provided. Multiple CPUs can be provided as a
  64 +comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
53 65 In per-thread mode, this option is ignored. The -a option is still necessary
54 66 to activate system-wide monitoring. Default is to count on all CPUs.
55 67  
... ... @@ -57,6 +69,14 @@
57 69 --no-aggr::
58 70 Do not aggregate counts across all monitored CPUs in system-wide mode (-a).
59 71 This option is only valid in system-wide mode.
  72 +
  73 +-n::
  74 +--null::
  75 + null run - don't start any counters
  76 +
  77 +-v::
  78 +--verbose::
  79 + be more verbose (show counter open errors, etc)
60 80  
61 81 EXAMPLES
62 82 --------