linux/tools/perf/Documentation/perf-stat.txt
<<
>>
Prefs
   1perf-stat(1)
   2============
   3
   4NAME
   5----
   6perf-stat - Run a command and gather performance counter statistics
   7
   8SYNOPSIS
   9--------
  10[verse]
  11'perf stat' [-e <EVENT> | --event=EVENT] [-a] <command>
  12'perf stat' [-e <EVENT> | --event=EVENT] [-a] -- <command> [<options>]
  13
  14DESCRIPTION
  15-----------
  16This command runs a command and gathers performance counter statistics
  17from it.
  18
  19
  20OPTIONS
  21-------
  22<command>...::
  23        Any command you can specify in a shell.
  24
  25
  26-e::
  27--event=::
  28        Select the PMU event. Selection can be a symbolic event name
  29        (use 'perf list' to list all events) or a raw PMU
  30        event (eventsel+umask) in the form of rNNN where NNN is a
  31         hexadecimal event descriptor.
  32
  33-i::
  34--no-inherit::
  35        child tasks do not inherit counters
  36-p::
  37--pid=<pid>::
  38        stat events on existing process id
  39
  40-t::
  41--tid=<tid>::
  42        stat events on existing thread id
  43
  44
  45-a::
  46--all-cpus::
  47        system-wide collection from all CPUs
  48
  49-c::
  50--scale::
  51        scale/normalize counter values
  52
  53-r::
  54--repeat=<n>::
  55        repeat command and print average + stddev (max: 100)
  56
  57-B::
  58--big-num::
  59        print large numbers with thousands' separators according to locale
  60
  61-C::
  62--cpu=::
  63Count only on the list of CPUs provided. Multiple CPUs can be provided as a
  64comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
  65In per-thread mode, this option is ignored. The -a option is still necessary
  66to activate system-wide monitoring. Default is to count on all CPUs.
  67
  68-A::
  69--no-aggr::
  70Do not aggregate counts across all monitored CPUs in system-wide mode (-a).
  71This 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)
  80
  81-x SEP::
  82--field-separator SEP::
  83print counts using a CSV-style output to make it easy to import directly into
  84spreadsheets. Columns are separated by the string specified in SEP.
  85
  86EXAMPLES
  87--------
  88
  89$ perf stat -- make -j
  90
  91 Performance counter stats for 'make -j':
  92
  93    8117.370256  task clock ticks     #      11.281 CPU utilization factor
  94            678  context switches     #       0.000 M/sec
  95            133  CPU migrations       #       0.000 M/sec
  96         235724  pagefaults           #       0.029 M/sec
  97    24821162526  CPU cycles           #    3057.784 M/sec
  98    18687303457  instructions         #    2302.138 M/sec
  99      172158895  cache references     #      21.209 M/sec
 100       27075259  cache misses         #       3.335 M/sec
 101
 102 Wall-clock time elapsed:   719.554352 msecs
 103
 104SEE ALSO
 105--------
 106linkperf:perf-top[1], linkperf:perf-list[1]
 107