tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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
49EXAMPLES
50--------
51
52$ perf stat -- make -j
53
54 Performance counter stats for 'make -j':
55
56 8117.370256 task clock ticks # 11.281 CPU utilization factor
57 678 context switches # 0.000 M/sec
58 133 CPU migrations # 0.000 M/sec
59 235724 pagefaults # 0.029 M/sec
60 24821162526 CPU cycles # 3057.784 M/sec
61 18687303457 instructions # 2302.138 M/sec
62 172158895 cache references # 21.209 M/sec
63 27075259 cache misses # 3.335 M/sec
64
65 Wall-clock time elapsed: 719.554352 msecs
66
67SEE ALSO
68--------
69linkperf:perf-top[1], linkperf:perf-list[1]