Documentation/perf_counter/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] [-l] [-a] <command>
  12 'perf stat' [-e <EVENT> | --event=EVENT] [-l] [-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 -e::
  26 --event=::
  27                              0:0: cpu-cycles
  28                              0:0: cycles
  29                              0:1: instructions
  30                              0:2: cache-references
  31                              0:3: cache-misses
  32                              0:4: branch-instructions
  33                              0:4: branches
  34                              0:5: branch-misses
  35                              0:6: bus-cycles
  36                              1:0: cpu-clock
  37                              1:1: task-clock
  38                              1:2: page-faults
  39                              1:2: faults
  40                              1:5: minor-faults
  41                              1:6: major-faults
  42                              1:3: context-switches
  43                              1:3: cs
  44                              1:4: cpu-migrations
  45                              1:4: migrations
  46                            rNNN: raw PMU events (eventsel+umask)
  47
  48 -a::
  49         system-wide collection
  50
  51 -l::
  52         scale counter values
  53
  54 Configuration
  55 -------------
  56
  57 EXAMPLES
  58 --------
  59
  60 $ perf stat sleep 1
  61
  62  Performance counter stats for 'sleep':
  63
  64        0.678356  task clock ticks     (msecs)
  65               7  context switches     (events)
  66               4  CPU migrations       (events)
  67             232  pagefaults           (events)
  68         1810403  CPU cycles           (events)
  69          946759  instructions         (events)
  70           18952  cache references     (events)
  71            4885  cache misses         (events)
  72
  73  Wall-clock time elapsed:  1001.252894 msecs
  74
  75 SEE ALSO
  76 --------
  77 linkperf:git-tops[1]