xref: /linux/tools/perf/Documentation/perf-record.txt (revision 2277ab4a1df50e05bc732fe9488d4e902bb8399a)
1perf-record(1)
2==============
3
4NAME
5----
6perf-record - Run a command and record its profile into perf.data
7
8SYNOPSIS
9--------
10[verse]
11'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
12'perf record' [-e <EVENT> | --event=EVENT] [-l] [-a] -- <command> [<options>]
13
14DESCRIPTION
15-----------
16This command runs a command and gathers a performance counter profile
17from it, into perf.data - without displaying anything.
18
19This file can then be inspected later on, using 'perf report'.
20
21
22OPTIONS
23-------
24<command>...::
25	Any command you can specify in a shell.
26
27-e::
28--event=::
29	Select the PMU event. Selection can be a symbolic event name
30	(use 'perf list' to list all events) or a raw PMU
31	event (eventsel+umask) in the form of rNNN where NNN is a
32	 hexadecimal event descriptor.
33
34-a::
35        system-wide collection
36
37-l::
38        scale counter values
39
40SEE ALSO
41--------
42linkperf:perf-stat[1], linkperf:perf-list[1]
43