perf-stat.txt 1.5 KB
Newer Older
I
Ingo Molnar 已提交
1
perf-stat(1)
2
============
I
Ingo Molnar 已提交
3 4 5 6 7 8 9 10 11

NAME
----
perf-stat - Run a command and gather performance counter statistics

SYNOPSIS
--------
[verse]
'perf stat' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
12
'perf stat' [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>]
I
Ingo Molnar 已提交
13 14 15 16 17 18 19 20 21 22 23 24

DESCRIPTION
-----------
This command runs a command and gathers performance counter statistics
from it.


OPTIONS
-------
<command>...::
	Any command you can specify in a shell.

I
Ingo Molnar 已提交
25

I
Ingo Molnar 已提交
26 27
-e::
--event=::
28 29 30 31
	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
Ingo Molnar 已提交
32

I
Ingo Molnar 已提交
33 34 35 36 37 38 39
-i::
--inherit::
        child tasks inherit counters
-p::
--pid=<pid>::
        stat events on existing pid

I
Ingo Molnar 已提交
40 41 42 43 44 45 46 47 48
-a::
        system-wide collection

-l::
        scale counter values

EXAMPLES
--------

I
Ingo Molnar 已提交
49
$ perf stat -- make -j
I
Ingo Molnar 已提交
50

I
Ingo Molnar 已提交
51
 Performance counter stats for 'make -j':
I
Ingo Molnar 已提交
52

I
Ingo Molnar 已提交
53 54 55 56 57 58 59 60
    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
I
Ingo Molnar 已提交
61

I
Ingo Molnar 已提交
62
 Wall-clock time elapsed:   719.554352 msecs
I
Ingo Molnar 已提交
63 64 65

SEE ALSO
--------
66
linkperf:perf-top[1], linkperf:perf-list[1]