1 perf-kwork(1)
2 =============
3
4 NAME
5 ----
6 perf-kwork - Tool to trace/measure kernel work
7
8 SYNOPSIS
9 --------
10 [verse]
11 'perf kwork' {record|report|latency|timehist|t
12
13 DESCRIPTION
14 -----------
15 There are several variants of 'perf kwork':
16
17 'perf kwork record <command>' to record the
18 of an arbitrary workload.
19
20 'perf kwork report' to report the per kwork
21
22 'perf kwork latency' to report the per kwork
23
24 'perf kwork timehist' provides an analysis o
25
26 'perf kwork top' to report the task cpu usag
27
28 Example usage:
29 perf kwork record -- sleep 1
30 perf kwork report
31 perf kwork report -b
32 perf kwork latency
33 perf kwork latency -b
34 perf kwork timehist
35 perf kwork top
36 perf kwork top -b
37
38 By default it shows the individual work eve
39 including the run time and delay (time betw
40
41 Runtime start Runtime end Cp
42
43 ----------------- ----------------- -----
44 1811186.976062 1811186.976327 [0000
45 1811186.978452 1811186.978547 [0000
46 1811186.980327 1811186.980490 [0000
47 1811186.981221 1811186.981271 [0000
48 1811186.984267 1811186.984318 [0000
49 1811186.987252 1811186.987315 [0000
50 1811186.987785 1811186.987843 [0006
51 1811186.988319 1811186.988383 [0000
52 1811186.989404 1811186.989607 [0002
53 1811186.989660 1811186.989732 [0002
54 1811186.991295 1811186.991407 [0002
55 1811186.991639 1811186.991734 [0002
56 1811186.989860 1811186.991826 [0002
57 ...
58
59 Times are in msec.usec.
60
61 OPTIONS
62 -------
63 -D::
64 --dump-raw-trace=::
65 Display verbose dump of the sched data
66
67 -f::
68 --force::
69 Don't complain, do it.
70
71 -k::
72 --kwork::
73 List of kwork to profile (irq, softirq
74
75 -v::
76 --verbose::
77 Be more verbose. (show symbol address,
78
79 OPTIONS for 'perf kwork report'
80 ----------------------------
81
82 -b::
83 --use-bpf::
84 Use BPF to measure kwork runtime
85
86 -C::
87 --cpu::
88 Only show events for the given CPU(s)
89
90 -i::
91 --input::
92 Input file name. (default: perf.data u
93
94 -n::
95 --name::
96 Only show events for the given name.
97
98 -s::
99 --sort::
100 Sort by key(s): runtime, max, count
101
102 -S::
103 --with-summary::
104 Show summary with statistics
105
106 --time::
107 Only analyze samples within given time
108 have the format seconds.microseconds.
109 string is ',x.y') then analysis starts
110 stop time is not given (i.e, time stri
111 to end of file.
112
113 OPTIONS for 'perf kwork latency'
114 ----------------------------
115
116 -b::
117 --use-bpf::
118 Use BPF to measure kwork latency
119
120 -C::
121 --cpu::
122 Only show events for the given CPU(s)
123
124 -i::
125 --input::
126 Input file name. (default: perf.data u
127
128 -n::
129 --name::
130 Only show events for the given name.
131
132 -s::
133 --sort::
134 Sort by key(s): avg, max, count
135
136 --time::
137 Only analyze samples within given time
138 have the format seconds.microseconds.
139 string is ',x.y') then analysis starts
140 stop time is not given (i.e, time stri
141 to end of file.
142
143 OPTIONS for 'perf kwork timehist'
144 ---------------------------------
145
146 -C::
147 --cpu::
148 Only show events for the given CPU(s)
149
150 -g::
151 --call-graph::
152 Display call chains if present (defaul
153
154 -i::
155 --input::
156 Input file name. (default: perf.data u
157
158 -k::
159 --vmlinux=<file>::
160 Vmlinux pathname
161
162 -n::
163 --name::
164 Only show events for the given name.
165
166 --kallsyms=<file>::
167 Kallsyms pathname
168
169 --max-stack::
170 Maximum number of functions to display
171
172 --symfs=<directory>::
173 Look for files with symbols relative to th
174
175 --time::
176 Only analyze samples within given time
177 have the format seconds.microseconds.
178 string is ',x.y') then analysis starts
179 stop time is not given (i.e, time stri
180 to end of file.
181
182 OPTIONS for 'perf kwork top'
183 ---------------------------------
184
185 -b::
186 --use-bpf::
187 Use BPF to measure task cpu usage.
188
189 -C::
190 --cpu::
191 Only show events for the given CPU(s)
192
193 -i::
194 --input::
195 Input file name. (default: perf.data u
196
197 -n::
198 --name::
199 Only show events for the given name.
200
201 -s::
202 --sort::
203 Sort by key(s): rate, runtime, tid
204
205 --time::
206 Only analyze samples within given time
207 have the format seconds.microseconds.
208 string is ',x.y') then analysis starts
209 stop time is not given (i.e, time stri
210 to end of file.
211
212 SEE ALSO
213 --------
214 linkperf:perf-record[1]
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.