]>
Commit | Line | Data |
---|---|---|
1d8c8b20 | 1 | perf-top(1) |
6e6b754f | 2 | =========== |
1d8c8b20 IM |
3 | |
4 | NAME | |
5 | ---- | |
83617983 | 6 | perf-top - System profiling tool. |
1d8c8b20 IM |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
10 | [verse] | |
83617983 | 11 | 'perf top' [-e <EVENT> | --event=EVENT] [<options>] |
1d8c8b20 IM |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
83617983 | 15 | This command generates and displays a performance counter profile in realtime. |
1d8c8b20 IM |
16 | |
17 | ||
18 | OPTIONS | |
19 | ------- | |
83617983 MG |
20 | -a:: |
21 | --all-cpus:: | |
22 | System-wide collection. (default) | |
23 | ||
24 | -c <count>:: | |
25 | --count=<count>:: | |
26 | Event period to sample. | |
27 | ||
28 | -C <cpu>:: | |
29 | --CPU=<cpu>:: | |
30 | CPU to profile. | |
31 | ||
32 | -d <seconds>:: | |
33 | --delay=<seconds>:: | |
34 | Number of seconds to delay between refreshes. | |
1d8c8b20 | 35 | |
83617983 MG |
36 | -e <event>:: |
37 | --event=<event>:: | |
386b05e3 TG |
38 | Select the PMU event. Selection can be a symbolic event name |
39 | (use 'perf list' to list all events) or a raw PMU | |
40 | event (eventsel+umask) in the form of rNNN where NNN is a | |
83617983 | 41 | hexadecimal event descriptor. |
1d8c8b20 | 42 | |
83617983 MG |
43 | -E <entries>:: |
44 | --entries=<entries>:: | |
45 | Display this many functions. | |
46 | ||
47 | -f <count>:: | |
48 | --count-filter=<count>:: | |
49 | Only display functions with more events than this. | |
50 | ||
51 | -F <freq>:: | |
52 | --freq=<freq>:: | |
53 | Profile at this frequency. | |
54 | ||
55 | -i:: | |
56 | --inherit:: | |
57 | Child tasks inherit counters, only makes sens with -p option. | |
58 | ||
59 | -k <path>:: | |
60 | --vmlinux=<path>:: | |
61 | Path to vmlinux. Required for annotation functionality. | |
62 | ||
63 | -m <pages>:: | |
64 | --mmap-pages=<pages>:: | |
65 | Number of mmapped data pages. | |
66 | ||
67 | -p <pid>:: | |
68 | --pid=<pid>:: | |
69 | Profile events on existing pid. | |
70 | ||
71 | -r <priority>:: | |
72 | --realtime=<priority>:: | |
73 | Collect data with this RT SCHED_FIFO priority. | |
74 | ||
75 | -s <symbol>:: | |
76 | --sym-annotate=<symbol>:: | |
77 | Annotate this symbol. Requires -k option. | |
78 | ||
79 | -v:: | |
80 | --verbose:: | |
81 | Be more verbose (show counter open errors, etc). | |
82 | ||
83 | -z:: | |
84 | --zero:: | |
85 | Zero history across display updates. | |
86 | ||
87 | INTERACTIVE PROMPTING KEYS | |
88 | -------------------------- | |
89 | ||
90 | [d]:: | |
91 | Display refresh delay. | |
92 | ||
93 | [e]:: | |
94 | Number of entries to display. | |
95 | ||
96 | [E]:: | |
97 | Event to display when multiple counters are active. | |
98 | ||
99 | [f]:: | |
100 | Profile display filter (>= hit count). | |
101 | ||
102 | [F]:: | |
103 | Annotation display filter (>= % of total). | |
104 | ||
105 | [s]:: | |
106 | Annotate symbol. | |
107 | ||
108 | [S]:: | |
109 | Stop annotation, return to full profile display. | |
110 | ||
111 | [w]:: | |
112 | Toggle between weighted sum and individual count[E]r profile. | |
113 | ||
114 | [z]:: | |
115 | Toggle event count zeroing across display updates. | |
116 | ||
117 | [qQ]:: | |
118 | Quit. | |
119 | ||
120 | Pressing any unmapped key displays a menu, and prompts for input. | |
1d8c8b20 | 121 | |
1d8c8b20 | 122 | |
1d8c8b20 IM |
123 | SEE ALSO |
124 | -------- | |
386b05e3 | 125 | linkperf:perf-stat[1], linkperf:perf-list[1] |