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