1PERF-TOP(1) perf Manual PERF-TOP(1)
2
3
4
6 perf-top - System profiling tool.
7
9 perf top [-e <EVENT> | --event=EVENT] [<options>]
10
12 This command generates and displays a performance counter profile in
13 realtime.
14
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
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
100 perf-stat(1), perf-list(1)
101
102
103
104perf 2.6.35.14-106.fc 11/23/2011 PERF-TOP(1)