trace_skb: fix build when CONFIG_NET is not enabled
[linux-block.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
78d904b4
SR
12config HAVE_FTRACE_NMI_ENTER
13 bool
14
606576ce 15config HAVE_FUNCTION_TRACER
16444a8a 16 bool
bc0c38d1 17
fb52607a 18config HAVE_FUNCTION_GRAPH_TRACER
15e6cb36
FW
19 bool
20
71e308a2
SR
21config HAVE_FUNCTION_GRAPH_FP_TEST
22 bool
23 help
24 An arch may pass in a unique value (frame pointer) to both the
25 entering and exiting of a function. On exit, the value is compared
26 and if it does not match, then it will panic the kernel.
27
60a7ecf4
SR
28config HAVE_FUNCTION_TRACE_MCOUNT_TEST
29 bool
30 help
31 This gets selected when the arch tests the function_trace_stop
32 variable at the mcount call site. Otherwise, this variable
33 is tested by the called function.
34
677aa9f7
SR
35config HAVE_DYNAMIC_FTRACE
36 bool
37
8da3821b
SR
38config HAVE_FTRACE_MCOUNT_RECORD
39 bool
40
1e9b51c2
MM
41config HAVE_HW_BRANCH_TRACER
42 bool
43
ee08c6ec
FW
44config HAVE_FTRACE_SYSCALLS
45 bool
46
352ad25a
SR
47config TRACER_MAX_TRACE
48 bool
49
7a8e76a3
SR
50config RING_BUFFER
51 bool
52
78d904b4
SR
53config FTRACE_NMI_ENTER
54 bool
55 depends on HAVE_FTRACE_NMI_ENTER
56 default y
57
5f77a88b 58config EVENT_TRACING
b11c53e1
Z
59 select CONTEXT_SWITCH_TRACER
60 bool
61
62config CONTEXT_SWITCH_TRACER
63 select MARKERS
5f77a88b
TZ
64 bool
65
5e0a0939
SR
66# All tracer options should select GENERIC_TRACER. For those options that are
67# enabled by all tracers (context switch and event tracer) they select TRACING.
68# This allows those options to appear when no other tracer is selected. But the
69# options do not appear when something else selects it. We need the two options
70# GENERIC_TRACER and TRACING to avoid circular dependencies to accomplish the
71# hidding of the automatic options options.
72
bc0c38d1
SR
73config TRACING
74 bool
75 select DEBUG_FS
7a8e76a3 76 select RING_BUFFER
c2c80529 77 select STACKTRACE if STACKTRACE_SUPPORT
5f87f112 78 select TRACEPOINTS
f3384b28 79 select NOP_TRACER
769b0441 80 select BINARY_PRINTF
5f77a88b 81 select EVENT_TRACING
bc0c38d1 82
5e0a0939
SR
83config GENERIC_TRACER
84 bool
85 select TRACING
86
40ada30f
IM
87#
88# Minimum requirements an architecture has to meet for us to
89# be able to offer generic tracing facilities:
90#
91config TRACING_SUPPORT
92 bool
45b95608
AV
93 # PPC32 has no irqflags tracing support, but it can use most of the
94 # tracers anyway, they were tested to build and work. Note that new
95 # exceptions to this list aren't welcomed, better implement the
96 # irqflags tracing for your architecture.
97 depends on TRACE_IRQFLAGS_SUPPORT || PPC32
40ada30f 98 depends on STACKTRACE_SUPPORT
422d3c7a 99 default y
40ada30f
IM
100
101if TRACING_SUPPORT
102
4ed9f071
SR
103menuconfig FTRACE
104 bool "Tracers"
65b77242 105 default y if DEBUG_KERNEL
4ed9f071
SR
106 help
107 Enable the kernel tracing infrastructure.
108
109if FTRACE
17d80fd0 110
606576ce 111config FUNCTION_TRACER
1b29b018 112 bool "Kernel Function Tracer"
606576ce 113 depends on HAVE_FUNCTION_TRACER
1b29b018 114 select FRAME_POINTER
4d7a077c 115 select KALLSYMS
5e0a0939 116 select GENERIC_TRACER
35e8e302 117 select CONTEXT_SWITCH_TRACER
1b29b018
SR
118 help
119 Enable the kernel to trace every kernel function. This is done
120 by using a compiler feature to insert a small, 5-byte No-Operation
121 instruction to the beginning of every kernel function, which NOP
122 sequence is then dynamically patched into a tracer call when
123 tracing is enabled by the administrator. If it's runtime disabled
124 (the bootup default), then the overhead of the instructions is very
125 small and not measurable even in micro-benchmarks.
35e8e302 126
fb52607a
FW
127config FUNCTION_GRAPH_TRACER
128 bool "Kernel Function Graph Tracer"
129 depends on HAVE_FUNCTION_GRAPH_TRACER
15e6cb36 130 depends on FUNCTION_TRACER
eb4a0378 131 depends on !X86_32 || !CC_OPTIMIZE_FOR_SIZE
764f3b95 132 default y
15e6cb36 133 help
fb52607a
FW
134 Enable the kernel to trace a function at both its return
135 and its entry.
692105b8
ML
136 Its first purpose is to trace the duration of functions and
137 draw a call graph for each thread with some information like
138 the return value. This is done by setting the current return
139 address on the current task structure into a stack of calls.
15e6cb36 140
bac429f0 141
81d68a96
SR
142config IRQSOFF_TRACER
143 bool "Interrupts-off Latency Tracer"
144 default n
145 depends on TRACE_IRQFLAGS_SUPPORT
146 depends on GENERIC_TIME
147 select TRACE_IRQFLAGS
5e0a0939 148 select GENERIC_TRACER
81d68a96
SR
149 select TRACER_MAX_TRACE
150 help
151 This option measures the time spent in irqs-off critical
152 sections, with microsecond accuracy.
153
154 The default measurement method is a maximum search, which is
155 disabled by default and can be runtime (re-)started
156 via:
157
156f5a78 158 echo 0 > /sys/kernel/debug/tracing/tracing_max_latency
81d68a96 159
6cd8a4bb
SR
160 (Note that kernel size and overhead increases with this option
161 enabled. This option and the preempt-off timing option can be
162 used together or separately.)
163
164config PREEMPT_TRACER
165 bool "Preemption-off Latency Tracer"
166 default n
167 depends on GENERIC_TIME
168 depends on PREEMPT
5e0a0939 169 select GENERIC_TRACER
6cd8a4bb
SR
170 select TRACER_MAX_TRACE
171 help
172 This option measures the time spent in preemption off critical
173 sections, with microsecond accuracy.
174
175 The default measurement method is a maximum search, which is
176 disabled by default and can be runtime (re-)started
177 via:
178
156f5a78 179 echo 0 > /sys/kernel/debug/tracing/tracing_max_latency
6cd8a4bb
SR
180
181 (Note that kernel size and overhead increases with this option
182 enabled. This option and the irqs-off timing option can be
183 used together or separately.)
184
f06c3810
IM
185config SYSPROF_TRACER
186 bool "Sysprof Tracer"
4d2df795 187 depends on X86
5e0a0939 188 select GENERIC_TRACER
b22f4858 189 select CONTEXT_SWITCH_TRACER
f06c3810
IM
190 help
191 This tracer provides the trace needed by the 'Sysprof' userspace
192 tool.
193
352ad25a
SR
194config SCHED_TRACER
195 bool "Scheduling Latency Tracer"
5e0a0939 196 select GENERIC_TRACER
352ad25a
SR
197 select CONTEXT_SWITCH_TRACER
198 select TRACER_MAX_TRACE
199 help
200 This tracer tracks the latency of the highest priority task
201 to be scheduled in, starting from the point it has woken up.
202
897f17a6
SR
203config ENABLE_DEFAULT_TRACERS
204 bool "Trace process context switches and events"
5e0a0939 205 depends on !GENERIC_TRACER
b77e38aa
SR
206 select TRACING
207 help
208 This tracer hooks to various trace points in the kernel
209 allowing the user to pick and choose which trace point they
897f17a6 210 want to trace. It also includes the sched_switch tracer plugin.
a7abe97f 211
ee08c6ec
FW
212config FTRACE_SYSCALLS
213 bool "Trace syscalls"
214 depends on HAVE_FTRACE_SYSCALLS
5e0a0939 215 select GENERIC_TRACER
0ea1c415 216 select KALLSYMS
ee08c6ec
FW
217 help
218 Basic tracer to catch the syscall entry and exit events.
219
1f5c2abb
FW
220config BOOT_TRACER
221 bool "Trace boot initcalls"
5e0a0939 222 select GENERIC_TRACER
ea31e72d 223 select CONTEXT_SWITCH_TRACER
1f5c2abb
FW
224 help
225 This tracer helps developers to optimize boot times: it records
98d9c66a
IM
226 the timings of the initcalls and traces key events and the identity
227 of tasks that can cause boot delays, such as context-switches.
228
238a24f6 229 Its aim is to be parsed by the scripts/bootgraph.pl tool to
98d9c66a
IM
230 produce pretty graphics about boot inefficiencies, giving a visual
231 representation of the delays during initcalls - but the raw
232 /debug/tracing/trace text output is readable too.
233
238a24f6
LZ
234 You must pass in initcall_debug and ftrace=initcall to the kernel
235 command line to enable this on bootup.
1f5c2abb 236
5a165657
NH
237config SKB_SOURCES_TRACER
238 bool "Trace skb source information"
3a5209e3 239 depends on NET
5a165657
NH
240 select GENERIC_TRACER
241 help
242 This tracer helps developers/sysadmins correlate skb allocation and
243 consumption. The idea being that some processes will primarily consume data
244 that was allocated on certain numa nodes. By being able to visualize which
245 nodes the data was allocated on, a sysadmin or developer can optimize the
246 scheduling of those processes to cut back on cross node chatter.
247
2ed84eeb 248config TRACE_BRANCH_PROFILING
9ae5b879 249 bool
5e0a0939 250 select GENERIC_TRACER
9ae5b879
SR
251
252choice
253 prompt "Branch Profiling"
254 default BRANCH_PROFILE_NONE
255 help
256 The branch profiling is a software profiler. It will add hooks
257 into the C conditionals to test which path a branch takes.
258
259 The likely/unlikely profiler only looks at the conditions that
260 are annotated with a likely or unlikely macro.
261
262 The "all branch" profiler will profile every if statement in the
263 kernel. This profiler will also enable the likely/unlikely
264 profiler as well.
265
266 Either of the above profilers add a bit of overhead to the system.
267 If unsure choose "No branch profiling".
268
269config BRANCH_PROFILE_NONE
270 bool "No branch profiling"
271 help
272 No branch profiling. Branch profiling adds a bit of overhead.
273 Only enable it if you want to analyse the branching behavior.
274 Otherwise keep it disabled.
275
276config PROFILE_ANNOTATED_BRANCHES
277 bool "Trace likely/unlikely profiler"
278 select TRACE_BRANCH_PROFILING
1f0d69a9
SR
279 help
280 This tracer profiles all the the likely and unlikely macros
281 in the kernel. It will display the results in:
282
156f5a78 283 /sys/kernel/debug/tracing/profile_annotated_branch
1f0d69a9
SR
284
285 Note: this will add a significant overhead, only turn this
286 on if you need to profile the system's use of these macros.
287
2bcd521a
SR
288config PROFILE_ALL_BRANCHES
289 bool "Profile all if conditionals"
9ae5b879 290 select TRACE_BRANCH_PROFILING
2bcd521a
SR
291 help
292 This tracer profiles all branch conditions. Every if ()
293 taken in the kernel is recorded whether it hit or miss.
294 The results will be displayed in:
295
156f5a78 296 /sys/kernel/debug/tracing/profile_branch
2bcd521a 297
9ae5b879
SR
298 This option also enables the likely/unlikely profiler.
299
2bcd521a
SR
300 This configuration, when enabled, will impose a great overhead
301 on the system. This should only be enabled when the system
302 is to be analyzed
9ae5b879 303endchoice
2bcd521a 304
2ed84eeb 305config TRACING_BRANCHES
52f232cb
SR
306 bool
307 help
308 Selected by tracers that will trace the likely and unlikely
309 conditions. This prevents the tracers themselves from being
310 profiled. Profiling the tracing infrastructure can only happen
311 when the likelys and unlikelys are not being traced.
312
2ed84eeb 313config BRANCH_TRACER
52f232cb 314 bool "Trace likely/unlikely instances"
2ed84eeb
SR
315 depends on TRACE_BRANCH_PROFILING
316 select TRACING_BRANCHES
52f232cb
SR
317 help
318 This traces the events of likely and unlikely condition
319 calls in the kernel. The difference between this and the
320 "Trace likely/unlikely profiler" is that this is not a
321 histogram of the callers, but actually places the calling
322 events into a running trace buffer to see when and where the
323 events happened, as well as their results.
324
325 Say N if unsure.
326
f3f47a67
AV
327config POWER_TRACER
328 bool "Trace power consumption behavior"
f3f47a67 329 depends on X86
5e0a0939 330 select GENERIC_TRACER
f3f47a67
AV
331 help
332 This tracer helps developers to analyze and optimize the kernels
333 power management decisions, specifically the C-state and P-state
334 behavior.
335
336
e5a81b62
SR
337config STACK_TRACER
338 bool "Trace max stack"
606576ce 339 depends on HAVE_FUNCTION_TRACER
606576ce 340 select FUNCTION_TRACER
e5a81b62 341 select STACKTRACE
4d7a077c 342 select KALLSYMS
e5a81b62 343 help
4519d9e5 344 This special tracer records the maximum stack footprint of the
156f5a78 345 kernel and displays it in /sys/kernel/debug/tracing/stack_trace.
4519d9e5
IM
346
347 This tracer works by hooking into every function call that the
348 kernel executes, and keeping a maximum stack depth value and
f38f1d2a
SR
349 stack-trace saved. If this is configured with DYNAMIC_FTRACE
350 then it will not have any overhead while the stack tracer
351 is disabled.
352
353 To enable the stack tracer on bootup, pass in 'stacktrace'
354 on the kernel command line.
355
356 The stack tracer can also be enabled or disabled via the
357 sysctl kernel.stack_tracer_enabled
4519d9e5
IM
358
359 Say N if unsure.
e5a81b62 360
a93751ca 361config HW_BRANCH_TRACER
1e9b51c2 362 depends on HAVE_HW_BRANCH_TRACER
a93751ca 363 bool "Trace hw branches"
5e0a0939 364 select GENERIC_TRACER
1e9b51c2
MM
365 help
366 This tracer records all branches on the system in a circular
367 buffer giving access to the last N branches for each cpu.
368
36994e58
FW
369config KMEMTRACE
370 bool "Trace SLAB allocations"
5e0a0939 371 select GENERIC_TRACER
36994e58
FW
372 help
373 kmemtrace provides tracing for slab allocator functions, such as
374 kmalloc, kfree, kmem_cache_alloc, kmem_cache_free etc.. Collected
375 data is then fed to the userspace application in order to analyse
376 allocation hotspots, internal fragmentation and so on, making it
377 possible to see how well an allocator performs, as well as debug
378 and profile kernel code.
379
380 This requires an userspace application to use. See
4d1f4372 381 Documentation/trace/kmemtrace.txt for more information.
36994e58
FW
382
383 Saying Y will make the kernel somewhat larger and slower. However,
384 if you disable kmemtrace at run-time or boot-time, the performance
385 impact is minimal (depending on the arch the kernel is built for).
386
387 If unsure, say N.
388
e1d8aa9f
FW
389config WORKQUEUE_TRACER
390 bool "Trace workqueues"
5e0a0939 391 select GENERIC_TRACER
e1d8aa9f
FW
392 help
393 The workqueue tracer provides some statistical informations
394 about each cpu workqueue thread such as the number of the
395 works inserted and executed since their creation. It can help
396 to evaluate the amount of work each of them have to perform.
397 For example it can help a developer to decide whether he should
398 choose a per cpu workqueue instead of a singlethreaded one.
399
2db270a8
FW
400config BLK_DEV_IO_TRACE
401 bool "Support for tracing block io actions"
402 depends on SYSFS
1dfba05d 403 depends on BLOCK
2db270a8
FW
404 select RELAY
405 select DEBUG_FS
406 select TRACEPOINTS
5e0a0939 407 select GENERIC_TRACER
2db270a8
FW
408 select STACKTRACE
409 help
410 Say Y here if you want to be able to trace the block layer actions
411 on a given queue. Tracing allows you to see any traffic happening
412 on a block device queue. For more information (and the userspace
413 support tools needed), fetch the blktrace tools from:
414
415 git://git.kernel.dk/blktrace.git
416
417 Tracing also is possible using the ftrace interface, e.g.:
418
419 echo 1 > /sys/block/sda/sda1/trace/enable
420 echo blk > /sys/kernel/debug/tracing/current_tracer
421 cat /sys/kernel/debug/tracing/trace_pipe
422
423 If unsure, say N.
36994e58 424
3d083395
SR
425config DYNAMIC_FTRACE
426 bool "enable/disable ftrace tracepoints dynamically"
606576ce 427 depends on FUNCTION_TRACER
677aa9f7 428 depends on HAVE_DYNAMIC_FTRACE
3d083395
SR
429 default y
430 help
431 This option will modify all the calls to ftrace dynamically
432 (will patch them out of the binary image and replaces them
433 with a No-Op instruction) as they are called. A table is
434 created to dynamically enable them again.
435
606576ce 436 This way a CONFIG_FUNCTION_TRACER kernel is slightly larger, but otherwise
3d083395
SR
437 has native performance as long as no tracing is active.
438
439 The changes to the code are done by a kernel thread that
440 wakes up once a second and checks to see if any ftrace calls
441 were made. If so, it runs stop_machine (stops all CPUS)
442 and modifies the code to jump over the call to ftrace.
60a11774 443
bac429f0
SR
444config FUNCTION_PROFILER
445 bool "Kernel function profiler"
493762fc 446 depends on FUNCTION_TRACER
bac429f0
SR
447 default n
448 help
493762fc
SR
449 This option enables the kernel function profiler. A file is created
450 in debugfs called function_profile_enabled which defaults to zero.
bac429f0
SR
451 When a 1 is echoed into this file profiling begins, and when a
452 zero is entered, profiling stops. A file in the trace_stats
453 directory called functions, that show the list of functions that
454 have been hit and their counters.
455
bac429f0
SR
456 If in doubt, say N
457
8da3821b
SR
458config FTRACE_MCOUNT_RECORD
459 def_bool y
460 depends on DYNAMIC_FTRACE
461 depends on HAVE_FTRACE_MCOUNT_RECORD
462
60a11774
SR
463config FTRACE_SELFTEST
464 bool
465
466config FTRACE_STARTUP_TEST
467 bool "Perform a startup test on ftrace"
5e0a0939 468 depends on GENERIC_TRACER
60a11774
SR
469 select FTRACE_SELFTEST
470 help
471 This option performs a series of startup tests on ftrace. On bootup
472 a series of tests are made to verify that the tracer is
473 functioning properly. It will do tests on all the configured
474 tracers of ftrace.
17d80fd0 475
fe6f90e5
PP
476config MMIOTRACE
477 bool "Memory mapped IO tracing"
40ada30f 478 depends on HAVE_MMIOTRACE_SUPPORT && PCI
5e0a0939 479 select GENERIC_TRACER
fe6f90e5
PP
480 help
481 Mmiotrace traces Memory Mapped I/O access and is meant for
482 debugging and reverse engineering. It is called from the ioremap
483 implementation and works via page faults. Tracing is disabled by
484 default and can be enabled at run-time.
485
4d1f4372 486 See Documentation/trace/mmiotrace.txt.
fe6f90e5
PP
487 If you are not helping to develop drivers, say N.
488
489config MMIOTRACE_TEST
490 tristate "Test module for mmiotrace"
491 depends on MMIOTRACE && m
492 help
493 This is a dumb module for testing mmiotrace. It is very dangerous
494 as it will write garbage to IO memory starting at a given address.
495 However, it should be safe to use on e.g. unused portion of VRAM.
496
497 Say N, unless you absolutely know what you are doing.
498
5092dbc9
SR
499config RING_BUFFER_BENCHMARK
500 tristate "Ring buffer benchmark stress tester"
501 depends on RING_BUFFER
502 help
503 This option creates a test to stress the ring buffer and bench mark it.
504 It creates its own ring buffer such that it will not interfer with
505 any other users of the ring buffer (such as ftrace). It then creates
506 a producer and consumer that will run for 10 seconds and sleep for
507 10 seconds. Each interval it will print out the number of events
508 it recorded and give a rough estimate of how long each iteration took.
509
510 It does not disable interrupts or raise its priority, so it may be
511 affected by processes that are running.
512
513 If unsure, say N
514
4ed9f071 515endif # FTRACE
40ada30f
IM
516
517endif # TRACING_SUPPORT
518