trace: remove deprecated entry->cpu
[deliverable/linux.git] / kernel / trace / Kconfig
CommitLineData
16444a8a 1#
606576ce
SR
2# Architectures that offer an FUNCTION_TRACER implementation should
3# select HAVE_FUNCTION_TRACER:
16444a8a 4#
2a3a4f66 5
8d26487f
TE
6config USER_STACKTRACE_SUPPORT
7 bool
8
2a3a4f66
FW
9config NOP_TRACER
10 bool
11
606576ce 12config HAVE_FUNCTION_TRACER
16444a8a 13 bool
bc0c38d1 14
fb52607a 15config HAVE_FUNCTION_GRAPH_TRACER
15e6cb36
FW
16 bool
17
60a7ecf4
SR
18config HAVE_FUNCTION_TRACE_MCOUNT_TEST
19 bool
20 help
21 This gets selected when the arch tests the function_trace_stop
22 variable at the mcount call site. Otherwise, this variable
23 is tested by the called function.
24
677aa9f7
SR
25config HAVE_DYNAMIC_FTRACE
26 bool
27
8da3821b
SR
28config HAVE_FTRACE_MCOUNT_RECORD
29 bool
30
1e9b51c2
MM
31config HAVE_HW_BRANCH_TRACER
32 bool
33
352ad25a
SR
34config TRACER_MAX_TRACE
35 bool
36
7a8e76a3
SR
37config RING_BUFFER
38 bool
39
bc0c38d1
SR
40config TRACING
41 bool
42 select DEBUG_FS
7a8e76a3 43 select RING_BUFFER
c2c80529 44 select STACKTRACE if STACKTRACE_SUPPORT
5f87f112 45 select TRACEPOINTS
f3384b28 46 select NOP_TRACER
bc0c38d1 47
17d80fd0
PZ
48menu "Tracers"
49
606576ce 50config FUNCTION_TRACER
1b29b018 51 bool "Kernel Function Tracer"
606576ce 52 depends on HAVE_FUNCTION_TRACER
d3ee6d99 53 depends on DEBUG_KERNEL
1b29b018
SR
54 select FRAME_POINTER
55 select TRACING
35e8e302 56 select CONTEXT_SWITCH_TRACER
1b29b018
SR
57 help
58 Enable the kernel to trace every kernel function. This is done
59 by using a compiler feature to insert a small, 5-byte No-Operation
60 instruction to the beginning of every kernel function, which NOP
61 sequence is then dynamically patched into a tracer call when
62 tracing is enabled by the administrator. If it's runtime disabled
63 (the bootup default), then the overhead of the instructions is very
64 small and not measurable even in micro-benchmarks.
35e8e302 65
fb52607a
FW
66config FUNCTION_GRAPH_TRACER
67 bool "Kernel Function Graph Tracer"
68 depends on HAVE_FUNCTION_GRAPH_TRACER
15e6cb36 69 depends on FUNCTION_TRACER
764f3b95 70 default y
15e6cb36 71 help
fb52607a
FW
72 Enable the kernel to trace a function at both its return
73 and its entry.
74 It's first purpose is to trace the duration of functions and
75 draw a call graph for each thread with some informations like
76 the return value.
77 This is done by setting the current return address on the current
78 task structure into a stack of calls.
15e6cb36 79
81d68a96
SR
80config IRQSOFF_TRACER
81 bool "Interrupts-off Latency Tracer"
82 default n
83 depends on TRACE_IRQFLAGS_SUPPORT
84 depends on GENERIC_TIME
d3ee6d99 85 depends on DEBUG_KERNEL
81d68a96
SR
86 select TRACE_IRQFLAGS
87 select TRACING
88 select TRACER_MAX_TRACE
89 help
90 This option measures the time spent in irqs-off critical
91 sections, with microsecond accuracy.
92
93 The default measurement method is a maximum search, which is
94 disabled by default and can be runtime (re-)started
95 via:
96
97 echo 0 > /debugfs/tracing/tracing_max_latency
98
6cd8a4bb
SR
99 (Note that kernel size and overhead increases with this option
100 enabled. This option and the preempt-off timing option can be
101 used together or separately.)
102
103config PREEMPT_TRACER
104 bool "Preemption-off Latency Tracer"
105 default n
106 depends on GENERIC_TIME
107 depends on PREEMPT
d3ee6d99 108 depends on DEBUG_KERNEL
6cd8a4bb
SR
109 select TRACING
110 select TRACER_MAX_TRACE
111 help
112 This option measures the time spent in preemption off critical
113 sections, with microsecond accuracy.
114
115 The default measurement method is a maximum search, which is
116 disabled by default and can be runtime (re-)started
117 via:
118
119 echo 0 > /debugfs/tracing/tracing_max_latency
120
121 (Note that kernel size and overhead increases with this option
122 enabled. This option and the irqs-off timing option can be
123 used together or separately.)
124
f06c3810
IM
125config SYSPROF_TRACER
126 bool "Sysprof Tracer"
4d2df795 127 depends on X86
f06c3810
IM
128 select TRACING
129 help
130 This tracer provides the trace needed by the 'Sysprof' userspace
131 tool.
132
352ad25a
SR
133config SCHED_TRACER
134 bool "Scheduling Latency Tracer"
d3ee6d99 135 depends on DEBUG_KERNEL
352ad25a
SR
136 select TRACING
137 select CONTEXT_SWITCH_TRACER
138 select TRACER_MAX_TRACE
139 help
140 This tracer tracks the latency of the highest priority task
141 to be scheduled in, starting from the point it has woken up.
142
35e8e302
SR
143config CONTEXT_SWITCH_TRACER
144 bool "Trace process context switches"
d3ee6d99 145 depends on DEBUG_KERNEL
35e8e302
SR
146 select TRACING
147 select MARKERS
148 help
149 This tracer gets called from the context switch and records
150 all switching of tasks.
151
1f5c2abb
FW
152config BOOT_TRACER
153 bool "Trace boot initcalls"
1f5c2abb
FW
154 depends on DEBUG_KERNEL
155 select TRACING
ea31e72d 156 select CONTEXT_SWITCH_TRACER
1f5c2abb
FW
157 help
158 This tracer helps developers to optimize boot times: it records
98d9c66a
IM
159 the timings of the initcalls and traces key events and the identity
160 of tasks that can cause boot delays, such as context-switches.
161
162 Its aim is to be parsed by the /scripts/bootgraph.pl tool to
163 produce pretty graphics about boot inefficiencies, giving a visual
164 representation of the delays during initcalls - but the raw
165 /debug/tracing/trace text output is readable too.
166
79fb0768
SR
167 You must pass in ftrace=initcall to the kernel command line
168 to enable this on bootup.
1f5c2abb 169
2ed84eeb 170config TRACE_BRANCH_PROFILING
1f0d69a9
SR
171 bool "Trace likely/unlikely profiler"
172 depends on DEBUG_KERNEL
173 select TRACING
174 help
175 This tracer profiles all the the likely and unlikely macros
176 in the kernel. It will display the results in:
177
45b79749 178 /debugfs/tracing/profile_annotated_branch
1f0d69a9
SR
179
180 Note: this will add a significant overhead, only turn this
181 on if you need to profile the system's use of these macros.
182
183 Say N if unsure.
184
2bcd521a
SR
185config PROFILE_ALL_BRANCHES
186 bool "Profile all if conditionals"
187 depends on TRACE_BRANCH_PROFILING
188 help
189 This tracer profiles all branch conditions. Every if ()
190 taken in the kernel is recorded whether it hit or miss.
191 The results will be displayed in:
192
193 /debugfs/tracing/profile_branch
194
195 This configuration, when enabled, will impose a great overhead
196 on the system. This should only be enabled when the system
197 is to be analyzed
198
199 Say N if unsure.
200
2ed84eeb 201config TRACING_BRANCHES
52f232cb
SR
202 bool
203 help
204 Selected by tracers that will trace the likely and unlikely
205 conditions. This prevents the tracers themselves from being
206 profiled. Profiling the tracing infrastructure can only happen
207 when the likelys and unlikelys are not being traced.
208
2ed84eeb 209config BRANCH_TRACER
52f232cb 210 bool "Trace likely/unlikely instances"
2ed84eeb
SR
211 depends on TRACE_BRANCH_PROFILING
212 select TRACING_BRANCHES
52f232cb
SR
213 help
214 This traces the events of likely and unlikely condition
215 calls in the kernel. The difference between this and the
216 "Trace likely/unlikely profiler" is that this is not a
217 histogram of the callers, but actually places the calling
218 events into a running trace buffer to see when and where the
219 events happened, as well as their results.
220
221 Say N if unsure.
222
f3f47a67
AV
223config POWER_TRACER
224 bool "Trace power consumption behavior"
225 depends on DEBUG_KERNEL
226 depends on X86
227 select TRACING
228 help
229 This tracer helps developers to analyze and optimize the kernels
230 power management decisions, specifically the C-state and P-state
231 behavior.
232
233
e5a81b62
SR
234config STACK_TRACER
235 bool "Trace max stack"
606576ce 236 depends on HAVE_FUNCTION_TRACER
2ff01c6a 237 depends on DEBUG_KERNEL
606576ce 238 select FUNCTION_TRACER
e5a81b62
SR
239 select STACKTRACE
240 help
4519d9e5
IM
241 This special tracer records the maximum stack footprint of the
242 kernel and displays it in debugfs/tracing/stack_trace.
243
244 This tracer works by hooking into every function call that the
245 kernel executes, and keeping a maximum stack depth value and
f38f1d2a
SR
246 stack-trace saved. If this is configured with DYNAMIC_FTRACE
247 then it will not have any overhead while the stack tracer
248 is disabled.
249
250 To enable the stack tracer on bootup, pass in 'stacktrace'
251 on the kernel command line.
252
253 The stack tracer can also be enabled or disabled via the
254 sysctl kernel.stack_tracer_enabled
4519d9e5
IM
255
256 Say N if unsure.
e5a81b62 257
a93751ca 258config HW_BRANCH_TRACER
1e9b51c2 259 depends on HAVE_HW_BRANCH_TRACER
a93751ca 260 bool "Trace hw branches"
1e9b51c2
MM
261 select TRACING
262 help
263 This tracer records all branches on the system in a circular
264 buffer giving access to the last N branches for each cpu.
265
36994e58
FW
266config KMEMTRACE
267 bool "Trace SLAB allocations"
268 select TRACING
36994e58
FW
269 help
270 kmemtrace provides tracing for slab allocator functions, such as
271 kmalloc, kfree, kmem_cache_alloc, kmem_cache_free etc.. Collected
272 data is then fed to the userspace application in order to analyse
273 allocation hotspots, internal fragmentation and so on, making it
274 possible to see how well an allocator performs, as well as debug
275 and profile kernel code.
276
277 This requires an userspace application to use. See
278 Documentation/vm/kmemtrace.txt for more information.
279
280 Saying Y will make the kernel somewhat larger and slower. However,
281 if you disable kmemtrace at run-time or boot-time, the performance
282 impact is minimal (depending on the arch the kernel is built for).
283
284 If unsure, say N.
285
e1d8aa9f
FW
286config WORKQUEUE_TRACER
287 bool "Trace workqueues"
288 select TRACING
289 help
290 The workqueue tracer provides some statistical informations
291 about each cpu workqueue thread such as the number of the
292 works inserted and executed since their creation. It can help
293 to evaluate the amount of work each of them have to perform.
294 For example it can help a developer to decide whether he should
295 choose a per cpu workqueue instead of a singlethreaded one.
296
36994e58 297
3d083395
SR
298config DYNAMIC_FTRACE
299 bool "enable/disable ftrace tracepoints dynamically"
606576ce 300 depends on FUNCTION_TRACER
677aa9f7 301 depends on HAVE_DYNAMIC_FTRACE
d3ee6d99 302 depends on DEBUG_KERNEL
3d083395
SR
303 default y
304 help
305 This option will modify all the calls to ftrace dynamically
306 (will patch them out of the binary image and replaces them
307 with a No-Op instruction) as they are called. A table is
308 created to dynamically enable them again.
309
606576ce 310 This way a CONFIG_FUNCTION_TRACER kernel is slightly larger, but otherwise
3d083395
SR
311 has native performance as long as no tracing is active.
312
313 The changes to the code are done by a kernel thread that
314 wakes up once a second and checks to see if any ftrace calls
315 were made. If so, it runs stop_machine (stops all CPUS)
316 and modifies the code to jump over the call to ftrace.
60a11774 317
8da3821b
SR
318config FTRACE_MCOUNT_RECORD
319 def_bool y
320 depends on DYNAMIC_FTRACE
321 depends on HAVE_FTRACE_MCOUNT_RECORD
322
60a11774
SR
323config FTRACE_SELFTEST
324 bool
325
326config FTRACE_STARTUP_TEST
327 bool "Perform a startup test on ftrace"
79fb0768 328 depends on TRACING && DEBUG_KERNEL
60a11774
SR
329 select FTRACE_SELFTEST
330 help
331 This option performs a series of startup tests on ftrace. On bootup
332 a series of tests are made to verify that the tracer is
333 functioning properly. It will do tests on all the configured
334 tracers of ftrace.
17d80fd0 335
fe6f90e5
PP
336config MMIOTRACE
337 bool "Memory mapped IO tracing"
338 depends on HAVE_MMIOTRACE_SUPPORT && DEBUG_KERNEL && PCI
339 select TRACING
340 help
341 Mmiotrace traces Memory Mapped I/O access and is meant for
342 debugging and reverse engineering. It is called from the ioremap
343 implementation and works via page faults. Tracing is disabled by
344 default and can be enabled at run-time.
345
346 See Documentation/tracers/mmiotrace.txt.
347 If you are not helping to develop drivers, say N.
348
349config MMIOTRACE_TEST
350 tristate "Test module for mmiotrace"
351 depends on MMIOTRACE && m
352 help
353 This is a dumb module for testing mmiotrace. It is very dangerous
354 as it will write garbage to IO memory starting at a given address.
355 However, it should be safe to use on e.g. unused portion of VRAM.
356
357 Say N, unless you absolutely know what you are doing.
358
17d80fd0 359endmenu
This page took 0.101779 seconds and 5 git commands to generate.