2009-04-20 15:52:29 +02:00
|
|
|
perf-stat(1)
|
2008-04-15 22:39:31 +02:00
|
|
|
============
|
2009-04-20 15:52:29 +02:00
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
perf-stat - Run a command and gather performance counter statistics
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
[verse]
|
2009-06-23 02:22:39 +05:30
|
|
|
'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] <command>
|
|
|
|
|
'perf stat' [-e <EVENT> | --event=EVENT] [-S] [-a] -- <command> [<options>]
|
2009-04-20 15:52:29 +02:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
This command runs a command and gathers performance counter statistics
|
|
|
|
|
from it.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
<command>...::
|
|
|
|
|
Any command you can specify in a shell.
|
|
|
|
|
|
2009-06-04 16:33:00 +02:00
|
|
|
|
2009-04-20 15:52:29 +02:00
|
|
|
-e::
|
|
|
|
|
--event=::
|
2009-06-06 14:56:33 +02:00
|
|
|
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.
|
2009-04-20 15:52:29 +02:00
|
|
|
|
2009-06-04 16:33:00 +02:00
|
|
|
-i::
|
|
|
|
|
--inherit::
|
|
|
|
|
child tasks inherit counters
|
|
|
|
|
-p::
|
|
|
|
|
--pid=<pid>::
|
|
|
|
|
stat events on existing pid
|
|
|
|
|
|
2009-04-20 15:52:29 +02:00
|
|
|
-a::
|
|
|
|
|
system-wide collection
|
|
|
|
|
|
2009-06-23 02:22:39 +05:30
|
|
|
-S::
|
2009-04-20 15:52:29 +02:00
|
|
|
scale counter values
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
--------
|
|
|
|
|
|
2009-06-04 16:33:00 +02:00
|
|
|
$ perf stat -- make -j
|
2009-04-20 15:52:29 +02:00
|
|
|
|
2009-06-04 16:33:00 +02:00
|
|
|
Performance counter stats for 'make -j':
|
2009-04-20 15:52:29 +02:00
|
|
|
|
2009-06-04 16:33:00 +02:00
|
|
|
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
|
2009-04-20 15:52:29 +02:00
|
|
|
|
2009-06-04 16:33:00 +02:00
|
|
|
Wall-clock time elapsed: 719.554352 msecs
|
2009-04-20 15:52:29 +02:00
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
2009-06-06 14:56:33 +02:00
|
|
|
linkperf:perf-top[1], linkperf:perf-list[1]
|
