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 -C::
  50 --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.
  53 In per-thread mode, this option is ignored. The -a option is still necessary
  54 to activate system-wide monitoring. Default is to count on all CPUs.
  55
  56 EXAMPLES
  57 --------
  58
  59 $ perf stat -- make -j
  60
  61  Performance counter stats for 'make -j':
  62
  63     8117.370256  task clock ticks     #      11.281 CPU utilization factor
  64             678  context switches     #       0.000 M/sec
  65             133  CPU migrations       #       0.000 M/sec
  66          235724  pagefaults           #       0.029 M/sec
  67     24821162526  CPU cycles           #    3057.784 M/sec
  68     18687303457  instructions         #    2302.138 M/sec
  69       172158895  cache references     #      21.209 M/sec
  70        27075259  cache misses         #       3.335 M/sec
  71
  72  Wall-clock time elapsed:   719.554352 msecs
  73
  74 SEE ALSO
  75 --------
  76 linkperf:perf-top[1], linkperf:perf-list[1]