6 perf-stat - Run a command and gather performance counter statistics
11 'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] <command>
12 'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] -- <command> [<options>]
16 This command runs a command and gathers performance counter statistics
23 Any command you can specify in a shell.
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.
35 child tasks do not inherit counters
38 stat events on existing pid
41 system-wide collection
47 print large numbers with thousands' separators according to locale
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.
59 $ perf stat -- make -j
61 Performance counter stats for 'make -j':
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
72 Wall-clock time elapsed: 719.554352 msecs
76 linkperf:perf-top[1], linkperf:perf-list[1]