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 --inherit::
  35         child tasks 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 EXAMPLES
  47 --------
  48
  49 $ perf stat -- make -j
  50
  51  Performance counter stats for 'make -j':
  52
  53     8117.370256  task clock ticks     #      11.281 CPU utilization factor
  54             678  context switches     #       0.000 M/sec
  55             133  CPU migrations       #       0.000 M/sec
  56          235724  pagefaults           #       0.029 M/sec
  57     24821162526  CPU cycles           #    3057.784 M/sec
  58     18687303457  instructions         #    2302.138 M/sec
  59       172158895  cache references     #      21.209 M/sec
  60        27075259  cache misses         #       3.335 M/sec
  61
  62  Wall-clock time elapsed:   719.554352 msecs
  63
  64 SEE ALSO
  65 --------
  66 linkperf:perf-top[1], linkperf:perf-list[1]