1PERF-TOP(1)                       perf Manual                      PERF-TOP(1)
2
3
4

NAME

6       perf-top - System profiling tool.
7

SYNOPSIS

9       perf top [-e <EVENT> | --event=EVENT] [<options>]
10

DESCRIPTION

12       This command generates and displays a performance counter profile in
13       realtime.
14

OPTIONS

16       -a, --all-cpus
17           System-wide collection. (default)
18
19       -c <count>, --count=<count>
20           Event period to sample.
21
22       -C <cpu>, --CPU=<cpu>
23           CPU to profile.
24
25       -d <seconds>, --delay=<seconds>
26           Number of seconds to delay between refreshes.
27
28       -e <event>, --event=<event>
29           Select the PMU event. Selection can be a symbolic event name (use
30           perf list to list all events) or a raw PMU event (eventsel+umask)
31           in the form of rNNN where NNN is a hexadecimal event descriptor.
32
33       -E <entries>, --entries=<entries>
34           Display this many functions.
35
36       -f <count>, --count-filter=<count>
37           Only display functions with more events than this.
38
39       -F <freq>, --freq=<freq>
40           Profile at this frequency.
41
42       -i, --inherit
43           Child tasks inherit counters, only makes sens with -p option.
44
45       -k <path>, --vmlinux=<path>
46           Path to vmlinux. Required for annotation functionality.
47
48       -m <pages>, --mmap-pages=<pages>
49           Number of mmapped data pages.
50
51       -p <pid>, --pid=<pid>
52           Profile events on existing pid.
53
54       -r <priority>, --realtime=<priority>
55           Collect data with this RT SCHED_FIFO priority.
56
57       -s <symbol>, --sym-annotate=<symbol>
58           Annotate this symbol.
59
60       -v, --verbose
61           Be more verbose (show counter open errors, etc).
62
63       -z, --zero
64           Zero history across display updates.
65

INTERACTIVE PROMPTING KEYS

67       [d]
68           Display refresh delay.
69
70       [e]
71           Number of entries to display.
72
73       [E]
74           Event to display when multiple counters are active.
75
76       [f]
77           Profile display filter (>= hit count).
78
79       [F]
80           Annotation display filter (>= % of total).
81
82       [s]
83           Annotate symbol.
84
85       [S]
86           Stop annotation, return to full profile display.
87
88       [w]
89           Toggle between weighted sum and individual count[E]r profile.
90
91       [z]
92           Toggle event count zeroing across display updates.
93
94       [qQ]
95           Quit.
96
97       Pressing any unmapped key displays a menu, and prompts for input.
98

SEE ALSO

100       perf-stat(1), perf-list(1)
101
102
103
104perf 2.6.35.14-106.fc             11/23/2011                       PERF-TOP(1)
Impressum