diff options
Diffstat (limited to 'kernel')
| -rw-r--r-- | kernel/trace/Kconfig | 112 |
1 files changed, 56 insertions, 56 deletions
diff --git a/kernel/trace/Kconfig b/kernel/trace/Kconfig index d006554888dc..6c22d8a2f289 100644 --- a/kernel/trace/Kconfig +++ b/kernel/trace/Kconfig | |||
| @@ -12,17 +12,17 @@ config NOP_TRACER | |||
| 12 | config HAVE_FTRACE_NMI_ENTER | 12 | config HAVE_FTRACE_NMI_ENTER |
| 13 | bool | 13 | bool |
| 14 | help | 14 | help |
| 15 | See Documentation/trace/ftrace-implementation.txt | 15 | See Documentation/trace/ftrace-design.txt |
| 16 | 16 | ||
| 17 | config HAVE_FUNCTION_TRACER | 17 | config HAVE_FUNCTION_TRACER |
| 18 | bool | 18 | bool |
| 19 | help | 19 | help |
| 20 | See Documentation/trace/ftrace-implementation.txt | 20 | See Documentation/trace/ftrace-design.txt |
| 21 | 21 | ||
| 22 | config HAVE_FUNCTION_GRAPH_TRACER | 22 | config HAVE_FUNCTION_GRAPH_TRACER |
| 23 | bool | 23 | bool |
| 24 | help | 24 | help |
| 25 | See Documentation/trace/ftrace-implementation.txt | 25 | See Documentation/trace/ftrace-design.txt |
| 26 | 26 | ||
| 27 | config HAVE_FUNCTION_GRAPH_FP_TEST | 27 | config HAVE_FUNCTION_GRAPH_FP_TEST |
| 28 | bool | 28 | bool |
| @@ -34,17 +34,17 @@ config HAVE_FUNCTION_GRAPH_FP_TEST | |||
| 34 | config HAVE_FUNCTION_TRACE_MCOUNT_TEST | 34 | config HAVE_FUNCTION_TRACE_MCOUNT_TEST |
| 35 | bool | 35 | bool |
| 36 | help | 36 | help |
| 37 | See Documentation/trace/ftrace-implementation.txt | 37 | See Documentation/trace/ftrace-design.txt |
| 38 | 38 | ||
| 39 | config HAVE_DYNAMIC_FTRACE | 39 | config HAVE_DYNAMIC_FTRACE |
| 40 | bool | 40 | bool |
| 41 | help | 41 | help |
| 42 | See Documentation/trace/ftrace-implementation.txt | 42 | See Documentation/trace/ftrace-design.txt |
| 43 | 43 | ||
| 44 | config HAVE_FTRACE_MCOUNT_RECORD | 44 | config HAVE_FTRACE_MCOUNT_RECORD |
| 45 | bool | 45 | bool |
| 46 | help | 46 | help |
| 47 | See Documentation/trace/ftrace-implementation.txt | 47 | See Documentation/trace/ftrace-design.txt |
| 48 | 48 | ||
| 49 | config HAVE_HW_BRANCH_TRACER | 49 | config HAVE_HW_BRANCH_TRACER |
| 50 | bool | 50 | bool |
| @@ -52,7 +52,7 @@ config HAVE_HW_BRANCH_TRACER | |||
| 52 | config HAVE_SYSCALL_TRACEPOINTS | 52 | config HAVE_SYSCALL_TRACEPOINTS |
| 53 | bool | 53 | bool |
| 54 | help | 54 | help |
| 55 | See Documentation/trace/ftrace-implementation.txt | 55 | See Documentation/trace/ftrace-design.txt |
| 56 | 56 | ||
| 57 | config TRACER_MAX_TRACE | 57 | config TRACER_MAX_TRACE |
| 58 | bool | 58 | bool |
| @@ -83,7 +83,7 @@ config RING_BUFFER_ALLOW_SWAP | |||
| 83 | # This allows those options to appear when no other tracer is selected. But the | 83 | # This allows those options to appear when no other tracer is selected. But the |
| 84 | # options do not appear when something else selects it. We need the two options | 84 | # options do not appear when something else selects it. We need the two options |
| 85 | # GENERIC_TRACER and TRACING to avoid circular dependencies to accomplish the | 85 | # GENERIC_TRACER and TRACING to avoid circular dependencies to accomplish the |
| 86 | # hidding of the automatic options. | 86 | # hiding of the automatic options. |
| 87 | 87 | ||
| 88 | config TRACING | 88 | config TRACING |
| 89 | bool | 89 | bool |
| @@ -119,7 +119,7 @@ menuconfig FTRACE | |||
| 119 | bool "Tracers" | 119 | bool "Tracers" |
| 120 | default y if DEBUG_KERNEL | 120 | default y if DEBUG_KERNEL |
| 121 | help | 121 | help |
| 122 | Enable the kernel tracing infrastructure. | 122 | Enable the kernel tracing infrastructure. |
| 123 | 123 | ||
| 124 | if FTRACE | 124 | if FTRACE |
| 125 | 125 | ||
| @@ -133,7 +133,7 @@ config FUNCTION_TRACER | |||
| 133 | help | 133 | help |
| 134 | Enable the kernel to trace every kernel function. This is done | 134 | Enable the kernel to trace every kernel function. This is done |
| 135 | by using a compiler feature to insert a small, 5-byte No-Operation | 135 | by using a compiler feature to insert a small, 5-byte No-Operation |
| 136 | instruction to the beginning of every kernel function, which NOP | 136 | instruction at the beginning of every kernel function, which NOP |
| 137 | sequence is then dynamically patched into a tracer call when | 137 | sequence is then dynamically patched into a tracer call when |
| 138 | tracing is enabled by the administrator. If it's runtime disabled | 138 | tracing is enabled by the administrator. If it's runtime disabled |
| 139 | (the bootup default), then the overhead of the instructions is very | 139 | (the bootup default), then the overhead of the instructions is very |
| @@ -150,7 +150,7 @@ config FUNCTION_GRAPH_TRACER | |||
| 150 | and its entry. | 150 | and its entry. |
| 151 | Its first purpose is to trace the duration of functions and | 151 | Its first purpose is to trace the duration of functions and |
| 152 | draw a call graph for each thread with some information like | 152 | draw a call graph for each thread with some information like |
| 153 | the return value. This is done by setting the current return | 153 | the return value. This is done by setting the current return |
| 154 | address on the current task structure into a stack of calls. | 154 | address on the current task structure into a stack of calls. |
| 155 | 155 | ||
| 156 | 156 | ||
| @@ -173,7 +173,7 @@ config IRQSOFF_TRACER | |||
| 173 | 173 | ||
| 174 | echo 0 > /sys/kernel/debug/tracing/tracing_max_latency | 174 | echo 0 > /sys/kernel/debug/tracing/tracing_max_latency |
| 175 | 175 | ||
| 176 | (Note that kernel size and overhead increases with this option | 176 | (Note that kernel size and overhead increase with this option |
| 177 | enabled. This option and the preempt-off timing option can be | 177 | enabled. This option and the preempt-off timing option can be |
| 178 | used together or separately.) | 178 | used together or separately.) |
| 179 | 179 | ||
| @@ -186,7 +186,7 @@ config PREEMPT_TRACER | |||
| 186 | select TRACER_MAX_TRACE | 186 | select TRACER_MAX_TRACE |
| 187 | select RING_BUFFER_ALLOW_SWAP | 187 | select RING_BUFFER_ALLOW_SWAP |
| 188 | help | 188 | help |
| 189 | This option measures the time spent in preemption off critical | 189 | This option measures the time spent in preemption-off critical |
| 190 | sections, with microsecond accuracy. | 190 | sections, with microsecond accuracy. |
| 191 | 191 | ||
| 192 | The default measurement method is a maximum search, which is | 192 | The default measurement method is a maximum search, which is |
| @@ -195,7 +195,7 @@ config PREEMPT_TRACER | |||
| 195 | 195 | ||
| 196 | echo 0 > /sys/kernel/debug/tracing/tracing_max_latency | 196 | echo 0 > /sys/kernel/debug/tracing/tracing_max_latency |
| 197 | 197 | ||
| 198 | (Note that kernel size and overhead increases with this option | 198 | (Note that kernel size and overhead increase with this option |
| 199 | enabled. This option and the irqs-off timing option can be | 199 | enabled. This option and the irqs-off timing option can be |
| 200 | used together or separately.) | 200 | used together or separately.) |
| 201 | 201 | ||
| @@ -222,7 +222,7 @@ config ENABLE_DEFAULT_TRACERS | |||
| 222 | depends on !GENERIC_TRACER | 222 | depends on !GENERIC_TRACER |
| 223 | select TRACING | 223 | select TRACING |
| 224 | help | 224 | help |
| 225 | This tracer hooks to various trace points in the kernel | 225 | This tracer hooks to various trace points in the kernel, |
| 226 | allowing the user to pick and choose which trace point they | 226 | allowing the user to pick and choose which trace point they |
| 227 | want to trace. It also includes the sched_switch tracer plugin. | 227 | want to trace. It also includes the sched_switch tracer plugin. |
| 228 | 228 | ||
| @@ -265,19 +265,19 @@ choice | |||
| 265 | The likely/unlikely profiler only looks at the conditions that | 265 | The likely/unlikely profiler only looks at the conditions that |
| 266 | are annotated with a likely or unlikely macro. | 266 | are annotated with a likely or unlikely macro. |
| 267 | 267 | ||
| 268 | The "all branch" profiler will profile every if statement in the | 268 | The "all branch" profiler will profile every if-statement in the |
| 269 | kernel. This profiler will also enable the likely/unlikely | 269 | kernel. This profiler will also enable the likely/unlikely |
| 270 | profiler as well. | 270 | profiler. |
| 271 | 271 | ||
| 272 | Either of the above profilers add a bit of overhead to the system. | 272 | Either of the above profilers adds a bit of overhead to the system. |
| 273 | If unsure choose "No branch profiling". | 273 | If unsure, choose "No branch profiling". |
| 274 | 274 | ||
| 275 | config BRANCH_PROFILE_NONE | 275 | config BRANCH_PROFILE_NONE |
| 276 | bool "No branch profiling" | 276 | bool "No branch profiling" |
| 277 | help | 277 | help |
| 278 | No branch profiling. Branch profiling adds a bit of overhead. | 278 | No branch profiling. Branch profiling adds a bit of overhead. |
| 279 | Only enable it if you want to analyse the branching behavior. | 279 | Only enable it if you want to analyse the branching behavior. |
| 280 | Otherwise keep it disabled. | 280 | Otherwise keep it disabled. |
| 281 | 281 | ||
| 282 | config PROFILE_ANNOTATED_BRANCHES | 282 | config PROFILE_ANNOTATED_BRANCHES |
| 283 | bool "Trace likely/unlikely profiler" | 283 | bool "Trace likely/unlikely profiler" |
| @@ -288,7 +288,7 @@ config PROFILE_ANNOTATED_BRANCHES | |||
| 288 | 288 | ||
| 289 | /sys/kernel/debug/tracing/profile_annotated_branch | 289 | /sys/kernel/debug/tracing/profile_annotated_branch |
| 290 | 290 | ||
| 291 | Note: this will add a significant overhead, only turn this | 291 | Note: this will add a significant overhead; only turn this |
| 292 | on if you need to profile the system's use of these macros. | 292 | on if you need to profile the system's use of these macros. |
| 293 | 293 | ||
| 294 | config PROFILE_ALL_BRANCHES | 294 | config PROFILE_ALL_BRANCHES |
| @@ -305,7 +305,7 @@ config PROFILE_ALL_BRANCHES | |||
| 305 | 305 | ||
| 306 | This configuration, when enabled, will impose a great overhead | 306 | This configuration, when enabled, will impose a great overhead |
| 307 | on the system. This should only be enabled when the system | 307 | on the system. This should only be enabled when the system |
| 308 | is to be analyzed | 308 | is to be analyzed in much detail. |
| 309 | endchoice | 309 | endchoice |
| 310 | 310 | ||
| 311 | config TRACING_BRANCHES | 311 | config TRACING_BRANCHES |
| @@ -335,7 +335,7 @@ config POWER_TRACER | |||
| 335 | depends on X86 | 335 | depends on X86 |
| 336 | select GENERIC_TRACER | 336 | select GENERIC_TRACER |
| 337 | help | 337 | help |
| 338 | This tracer helps developers to analyze and optimize the kernels | 338 | This tracer helps developers to analyze and optimize the kernel's |
| 339 | power management decisions, specifically the C-state and P-state | 339 | power management decisions, specifically the C-state and P-state |
| 340 | behavior. | 340 | behavior. |
| 341 | 341 | ||
| @@ -391,14 +391,14 @@ config HW_BRANCH_TRACER | |||
| 391 | select GENERIC_TRACER | 391 | select GENERIC_TRACER |
| 392 | help | 392 | help |
| 393 | This tracer records all branches on the system in a circular | 393 | This tracer records all branches on the system in a circular |
| 394 | buffer giving access to the last N branches for each cpu. | 394 | buffer, giving access to the last N branches for each cpu. |
| 395 | 395 | ||
| 396 | config KMEMTRACE | 396 | config KMEMTRACE |
| 397 | bool "Trace SLAB allocations" | 397 | bool "Trace SLAB allocations" |
| 398 | select GENERIC_TRACER | 398 | select GENERIC_TRACER |
| 399 | help | 399 | help |
| 400 | kmemtrace provides tracing for slab allocator functions, such as | 400 | kmemtrace provides tracing for slab allocator functions, such as |
| 401 | kmalloc, kfree, kmem_cache_alloc, kmem_cache_free etc.. Collected | 401 | kmalloc, kfree, kmem_cache_alloc, kmem_cache_free, etc. Collected |
| 402 | data is then fed to the userspace application in order to analyse | 402 | data is then fed to the userspace application in order to analyse |
| 403 | allocation hotspots, internal fragmentation and so on, making it | 403 | allocation hotspots, internal fragmentation and so on, making it |
| 404 | possible to see how well an allocator performs, as well as debug | 404 | possible to see how well an allocator performs, as well as debug |
| @@ -417,15 +417,15 @@ config WORKQUEUE_TRACER | |||
| 417 | bool "Trace workqueues" | 417 | bool "Trace workqueues" |
| 418 | select GENERIC_TRACER | 418 | select GENERIC_TRACER |
| 419 | help | 419 | help |
| 420 | The workqueue tracer provides some statistical informations | 420 | The workqueue tracer provides some statistical information |
| 421 | about each cpu workqueue thread such as the number of the | 421 | about each cpu workqueue thread such as the number of the |
| 422 | works inserted and executed since their creation. It can help | 422 | works inserted and executed since their creation. It can help |
| 423 | to evaluate the amount of work each of them have to perform. | 423 | to evaluate the amount of work each of them has to perform. |
| 424 | For example it can help a developer to decide whether he should | 424 | For example it can help a developer to decide whether he should |
| 425 | choose a per cpu workqueue instead of a singlethreaded one. | 425 | choose a per-cpu workqueue instead of a singlethreaded one. |
| 426 | 426 | ||
| 427 | config BLK_DEV_IO_TRACE | 427 | config BLK_DEV_IO_TRACE |
| 428 | bool "Support for tracing block io actions" | 428 | bool "Support for tracing block IO actions" |
| 429 | depends on SYSFS | 429 | depends on SYSFS |
| 430 | depends on BLOCK | 430 | depends on BLOCK |
| 431 | select RELAY | 431 | select RELAY |
| @@ -456,15 +456,15 @@ config KPROBE_EVENT | |||
| 456 | select TRACING | 456 | select TRACING |
| 457 | default y | 457 | default y |
| 458 | help | 458 | help |
| 459 | This allows the user to add tracing events (similar to tracepoints) on the fly | 459 | This allows the user to add tracing events (similar to tracepoints) |
| 460 | via the ftrace interface. See Documentation/trace/kprobetrace.txt | 460 | on the fly via the ftrace interface. See |
| 461 | for more details. | 461 | Documentation/trace/kprobetrace.txt for more details. |
| 462 | 462 | ||
| 463 | Those events can be inserted wherever kprobes can probe, and record | 463 | Those events can be inserted wherever kprobes can probe, and record |
| 464 | various register and memory values. | 464 | various register and memory values. |
| 465 | 465 | ||
| 466 | This option is also required by perf-probe subcommand of perf tools. If | 466 | This option is also required by perf-probe subcommand of perf tools. |
| 467 | you want to use perf tools, this option is strongly recommended. | 467 | If you want to use perf tools, this option is strongly recommended. |
| 468 | 468 | ||
| 469 | config DYNAMIC_FTRACE | 469 | config DYNAMIC_FTRACE |
| 470 | bool "enable/disable ftrace tracepoints dynamically" | 470 | bool "enable/disable ftrace tracepoints dynamically" |
| @@ -472,32 +472,32 @@ config DYNAMIC_FTRACE | |||
| 472 | depends on HAVE_DYNAMIC_FTRACE | 472 | depends on HAVE_DYNAMIC_FTRACE |
| 473 | default y | 473 | default y |
| 474 | help | 474 | help |
| 475 | This option will modify all the calls to ftrace dynamically | 475 | This option will modify all the calls to ftrace dynamically |
| 476 | (will patch them out of the binary image and replaces them | 476 | (will patch them out of the binary image and replace them |
| 477 | with a No-Op instruction) as they are called. A table is | 477 | with a No-Op instruction) as they are called. A table is |
| 478 | created to dynamically enable them again. | 478 | created to dynamically enable them again. |
| 479 | 479 | ||
| 480 | This way a CONFIG_FUNCTION_TRACER kernel is slightly larger, but otherwise | 480 | This way a CONFIG_FUNCTION_TRACER kernel is slightly larger, but |
| 481 | has native performance as long as no tracing is active. | 481 | otherwise has native performance as long as no tracing is active. |
| 482 | 482 | ||
| 483 | The changes to the code are done by a kernel thread that | 483 | The changes to the code are done by a kernel thread that |
| 484 | wakes up once a second and checks to see if any ftrace calls | 484 | wakes up once a second and checks to see if any ftrace calls |
| 485 | were made. If so, it runs stop_machine (stops all CPUS) | 485 | were made. If so, it runs stop_machine (stops all CPUS) |
| 486 | and modifies the code to jump over the call to ftrace. | 486 | and modifies the code to jump over the call to ftrace. |
| 487 | 487 | ||
| 488 | config FUNCTION_PROFILER | 488 | config FUNCTION_PROFILER |
| 489 | bool "Kernel function profiler" | 489 | bool "Kernel function profiler" |
| 490 | depends on FUNCTION_TRACER | 490 | depends on FUNCTION_TRACER |
| 491 | default n | 491 | default n |
| 492 | help | 492 | help |
| 493 | This option enables the kernel function profiler. A file is created | 493 | This option enables the kernel function profiler. A file is created |
| 494 | in debugfs called function_profile_enabled which defaults to zero. | 494 | in debugfs called function_profile_enabled which defaults to zero. |
| 495 | When a 1 is echoed into this file profiling begins, and when a | 495 | When a 1 is echoed into this file profiling begins, and when a |
| 496 | zero is entered, profiling stops. A file in the trace_stats | 496 | zero is entered, profiling stops. A "functions" file is created in |
| 497 | directory called functions, that show the list of functions that | 497 | the trace_stats directory; this file shows the list of functions that |
| 498 | have been hit and their counters. | 498 | have been hit and their counters. |
| 499 | 499 | ||
| 500 | If in doubt, say N | 500 | If in doubt, say N. |
| 501 | 501 | ||
| 502 | config FTRACE_MCOUNT_RECORD | 502 | config FTRACE_MCOUNT_RECORD |
| 503 | def_bool y | 503 | def_bool y |
| @@ -556,8 +556,8 @@ config RING_BUFFER_BENCHMARK | |||
| 556 | tristate "Ring buffer benchmark stress tester" | 556 | tristate "Ring buffer benchmark stress tester" |
| 557 | depends on RING_BUFFER | 557 | depends on RING_BUFFER |
| 558 | help | 558 | help |
| 559 | This option creates a test to stress the ring buffer and bench mark it. | 559 | This option creates a test to stress the ring buffer and benchmark it. |
| 560 | It creates its own ring buffer such that it will not interfer with | 560 | It creates its own ring buffer such that it will not interfere with |
| 561 | any other users of the ring buffer (such as ftrace). It then creates | 561 | any other users of the ring buffer (such as ftrace). It then creates |
| 562 | a producer and consumer that will run for 10 seconds and sleep for | 562 | a producer and consumer that will run for 10 seconds and sleep for |
| 563 | 10 seconds. Each interval it will print out the number of events | 563 | 10 seconds. Each interval it will print out the number of events |
| @@ -566,7 +566,7 @@ config RING_BUFFER_BENCHMARK | |||
| 566 | It does not disable interrupts or raise its priority, so it may be | 566 | It does not disable interrupts or raise its priority, so it may be |
| 567 | affected by processes that are running. | 567 | affected by processes that are running. |
| 568 | 568 | ||
| 569 | If unsure, say N | 569 | If unsure, say N. |
| 570 | 570 | ||
| 571 | endif # FTRACE | 571 | endif # FTRACE |
| 572 | 572 | ||
