1perf-stat(1) 2============ 3 4NAME 5---- 6perf-stat - Run a command and gather performance counter statistics 7 8SYNOPSIS 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 14DESCRIPTION 15----------- 16This command runs a command and gathers performance counter statistics 17from it. 18 19 20OPTIONS 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=:: 51Count only on the list of cpus provided. Multiple CPUs can be provided as a 52comma-sperated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. 53In per-thread mode, this option is ignored. The -a option is still necessary 54to activate system-wide monitoring. Default is to count on all CPUs. 55 56EXAMPLES 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 74SEE ALSO 75-------- 76linkperf:perf-top[1], linkperf:perf-list[1] 77