2009-04-20 15:58:01 +02:00
perf-record(1)
2009-05-30 12:38:51 +02:00
==============
2009-04-20 15:58:01 +02:00
NAME
----
2009-05-27 09:33:18 +02:00
perf-record - Run a command and record its profile into perf.data
2009-04-20 15:58:01 +02:00
SYNOPSIS
--------
[verse]
'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
2009-05-28 16:25:34 +02:00
'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>]
2009-04-20 15:58:01 +02:00
DESCRIPTION
-----------
This command runs a command and gathers a performance counter profile
2009-05-27 09:33:18 +02:00
from it, into perf.data - without displaying anything.
2009-04-20 15:58:01 +02: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-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
2009-08-05 10:04:53 -03:00
hexadecimal event descriptor.
2009-04-20 15:58:01 +02:00
-a::
2009-08-05 10:04:53 -03:00
System-wide collection.
2009-04-20 15:58:01 +02:00
-l::
2009-08-05 10:04:53 -03: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::
Overwrite existing data file.
-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 15:58:01 +02:00
2009-08-31 03:32:03 +02:00
-R::
--raw-samples::
Collect raw sample records from all opened counters (typically for tracepoint counters).
2009-04-20 15:58:01 +02:00
SEE ALSO
--------
2009-06-06 14:56:33 +02:00
linkperf:perf-stat[1], linkperf:perf-list[1]