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--inherit::
35        child tasks 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
46EXAMPLES
47--------
48
49$ perf stat -- make -j
50
51 Performance counter stats for 'make -j':
52
53    8117.370256  task clock ticks     #      11.281 CPU utilization factor
54            678  context switches     #       0.000 M/sec
55            133  CPU migrations       #       0.000 M/sec
56         235724  pagefaults           #       0.029 M/sec
57    24821162526  CPU cycles           #    3057.784 M/sec
58    18687303457  instructions         #    2302.138 M/sec
59      172158895  cache references     #      21.209 M/sec
60       27075259  cache misses         #       3.335 M/sec
61
62 Wall-clock time elapsed:   719.554352 msecs
63
64SEE ALSO
65--------
66linkperf:perf-top[1], linkperf:perf-list[1]
67