perf-stat(1) ============ NAME ---- perf-stat - Run a command and gather performance counter statistics SYNOPSIS -------- [verse] 'perf stat' [-e | --event=EVENT] [-S] [-a] 'perf stat' [-e | --event=EVENT] [-S] [-a] -- [] DESCRIPTION ----------- This command runs a command and gathers performance counter statistics from it. OPTIONS ------- ...:: Any command you can specify in a shell. -e:: --event=:: Select the PMU event. Selection can be a symbolic event name (use 'perf list' to list all events) or a raw PMU event (eventsel+umask) in the form of rNNN where NNN is a hexadecimal event descriptor. -i:: --no-inherit:: child tasks do not inherit counters -p:: --pid=:: stat events on existing pid -a:: system-wide collection -c:: scale counter values -B:: print large numbers with thousands' separators according to locale -C:: --cpu=:: Count only on the list of cpus provided. Multiple CPUs can be provided as a comma-sperated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. In per-thread mode, this option is ignored. The -a option is still necessary to activate system-wide monitoring. Default is to count on all CPUs. EXAMPLES -------- $ perf stat -- make -j Performance counter stats for 'make -j': 8117.370256 task clock ticks # 11.281 CPU utilization factor 678 context switches # 0.000 M/sec 133 CPU migrations # 0.000 M/sec 235724 pagefaults # 0.029 M/sec 24821162526 CPU cycles # 3057.784 M/sec 18687303457 instructions # 2302.138 M/sec 172158895 cache references # 21.209 M/sec 27075259 cache misses # 3.335 M/sec Wall-clock time elapsed: 719.554352 msecs SEE ALSO -------- linkperf:perf-top[1], linkperf:perf-list[1]