2009-04-20 13:58:01 +00:00
|
|
|
perf-record(1)
|
2009-05-30 10:38:51 +00:00
|
|
|
==============
|
2009-04-20 13:58:01 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2009-05-27 07:33:18 +00:00
|
|
|
perf-record - Run a command and record its profile into perf.data
|
2009-04-20 13:58:01 +00:00
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
[verse]
|
|
|
|
'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
|
2009-05-28 14:25:34 +00:00
|
|
|
'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>]
|
2009-04-20 13:58:01 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
This command runs a command and gathers a performance counter profile
|
2009-05-27 07:33:18 +00:00
|
|
|
from it, into perf.data - without displaying anything.
|
2009-04-20 13:58:01 +00:00
|
|
|
|
|
|
|
This file can then be inspected later on, using 'perf report'.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
<command>...::
|
|
|
|
Any command you can specify in a shell.
|
|
|
|
|
|
|
|
-e::
|
|
|
|
--event=::
|
2009-11-23 14:42:35 +00:00
|
|
|
Select the PMU event. Selection can be:
|
2009-04-20 13:58:01 +00:00
|
|
|
|
2009-11-23 14:42:35 +00:00
|
|
|
- a symbolic event name (use 'perf list' to list all events)
|
|
|
|
|
|
|
|
- a raw PMU event (eventsel+umask) in the form of rNNN where NNN is a
|
|
|
|
hexadecimal event descriptor.
|
|
|
|
|
|
|
|
- a hardware breakpoint event in the form of '\mem:addr[:access]'
|
|
|
|
where addr is the address in memory you want to break in.
|
|
|
|
Access is the memory access type (read, write, execute) it can
|
|
|
|
be passed as follows: '\mem:addr[:[r][w][x]]'.
|
|
|
|
If you want to profile read-write accesses in 0x1000, just set
|
|
|
|
'mem:0x1000:rw'.
|
2009-04-20 13:58:01 +00:00
|
|
|
-a::
|
2009-08-05 13:04:53 +00:00
|
|
|
System-wide collection.
|
2009-04-20 13:58:01 +00:00
|
|
|
|
|
|
|
-l::
|
2009-08-05 13:04:53 +00:00
|
|
|
Scale counter values.
|
|
|
|
|
|
|
|
-p::
|
|
|
|
--pid=::
|
|
|
|
Record events on existing pid.
|
|
|
|
|
|
|
|
-r::
|
|
|
|
--realtime=::
|
|
|
|
Collect data with this RT SCHED_FIFO priority.
|
|
|
|
-A::
|
|
|
|
--append::
|
|
|
|
Append to the output file to do incremental profiling.
|
|
|
|
|
|
|
|
-f::
|
|
|
|
--force::
|
2010-04-14 17:42:07 +00:00
|
|
|
Overwrite existing data file. (deprecated)
|
2009-08-05 13:04:53 +00:00
|
|
|
|
|
|
|
-c::
|
|
|
|
--count=::
|
|
|
|
Event period to sample.
|
|
|
|
|
|
|
|
-o::
|
|
|
|
--output=::
|
|
|
|
Output file name.
|
|
|
|
|
|
|
|
-i::
|
|
|
|
--inherit::
|
|
|
|
Child tasks inherit counters.
|
|
|
|
-F::
|
|
|
|
--freq=::
|
|
|
|
Profile at this frequency.
|
|
|
|
|
|
|
|
-m::
|
|
|
|
--mmap-pages=::
|
|
|
|
Number of mmap data pages.
|
|
|
|
|
|
|
|
-g::
|
|
|
|
--call-graph::
|
|
|
|
Do call-graph (stack chain/backtrace) recording.
|
|
|
|
|
|
|
|
-v::
|
|
|
|
--verbose::
|
|
|
|
Be more verbose (show counter open errors, etc).
|
|
|
|
|
|
|
|
-s::
|
|
|
|
--stat::
|
|
|
|
Per thread counts.
|
|
|
|
|
|
|
|
-d::
|
|
|
|
--data::
|
|
|
|
Sample addresses.
|
|
|
|
|
|
|
|
-n::
|
|
|
|
--no-samples::
|
|
|
|
Don't sample.
|
2009-04-20 13:58:01 +00:00
|
|
|
|
2009-08-31 01:32:03 +00:00
|
|
|
-R::
|
|
|
|
--raw-samples::
|
|
|
|
Collect raw sample records from all opened counters (typically for tracepoint counters).
|
|
|
|
|
2009-04-20 13:58:01 +00:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
2009-06-06 12:56:33 +00:00
|
|
|
linkperf:perf-stat[1], linkperf:perf-list[1]
|