tools/perf/Documentation/perf-stat.txt

   1 perf-stat(1)
   2 ============
   3
   4 NAME
   5 ----
   6 perf-stat - Run a command and gather performance counter statistics
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] <command>
  12 'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] -- <command> [<options>]
  13
  14 DESCRIPTION
  15 -----------
  16 This command runs a command and gathers performance counter statistics
  17 from it.
  18
  19
  20 OPTIONS
  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 pid
  39
  40 -a::
  41         system-wide collection
  42
  43 -c::
  44         scale counter values
  45
  46 -B::
  47         print large numbers with thousands' separators according to locale
  48
  49 EXAMPLES
  50 --------
  51
  52 $ perf stat -- make -j
  53
  54  Performance counter stats for 'make -j':
  55
  56     8117.370256  task clock ticks     #      11.281 CPU utilization factor
  57             678  context switches     #       0.000 M/sec
  58             133  CPU migrations       #       0.000 M/sec
  59          235724  pagefaults           #       0.029 M/sec
  60     24821162526  CPU cycles           #    3057.784 M/sec
  61     18687303457  instructions         #    2302.138 M/sec
  62       172158895  cache references     #      21.209 M/sec
  63        27075259  cache misses         #       3.335 M/sec
  64
  65  Wall-clock time elapsed:   719.554352 msecs
  66
  67 SEE ALSO
  68 --------
  69 linkperf:perf-top[1], linkperf:perf-list[1]