Arnaldo Carvalho de Melo | 16444a8 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 1 | # |
| 2 | # Architectures that offer an FTRACE implementation should select HAVE_FTRACE: |
| 3 | # |
Frédéric Weisbecker | 2a3a4f6 | 2008-09-21 20:12:14 +0200 | [diff] [blame] | 4 | |
| 5 | config NOP_TRACER |
| 6 | bool |
| 7 | |
Arnaldo Carvalho de Melo | 16444a8 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 8 | config HAVE_FTRACE |
| 9 | bool |
Frédéric Weisbecker | 2a3a4f6 | 2008-09-21 20:12:14 +0200 | [diff] [blame] | 10 | select NOP_TRACER |
Steven Rostedt | bc0c38d | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 11 | |
Steven Rostedt | 677aa9f | 2008-05-17 00:01:36 -0400 | [diff] [blame] | 12 | config HAVE_DYNAMIC_FTRACE |
| 13 | bool |
| 14 | |
Steven Rostedt | 8da3821 | 2008-08-14 15:45:07 -0400 | [diff] [blame] | 15 | config HAVE_FTRACE_MCOUNT_RECORD |
| 16 | bool |
| 17 | |
Steven Rostedt | 352ad25 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 18 | config TRACER_MAX_TRACE |
| 19 | bool |
| 20 | |
Steven Rostedt | 7a8e76a | 2008-09-29 23:02:38 -0400 | [diff] [blame] | 21 | config RING_BUFFER |
| 22 | bool |
| 23 | |
Steven Rostedt | bc0c38d | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 24 | config TRACING |
| 25 | bool |
| 26 | select DEBUG_FS |
Steven Rostedt | 7a8e76a | 2008-09-29 23:02:38 -0400 | [diff] [blame] | 27 | select RING_BUFFER |
Ingo Molnar | 86387f7 | 2008-05-12 21:20:51 +0200 | [diff] [blame] | 28 | select STACKTRACE |
Ingo Molnar | 5f87f11 | 2008-07-23 14:15:22 +0200 | [diff] [blame] | 29 | select TRACEPOINTS |
Steven Rostedt | bc0c38d | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 30 | |
Steven Rostedt | 1b29b01 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 31 | config FTRACE |
| 32 | bool "Kernel Function Tracer" |
Ingo Molnar | 694379e | 2008-05-12 21:20:54 +0200 | [diff] [blame] | 33 | depends on HAVE_FTRACE |
Ingo Molnar | d3ee6d9 | 2008-09-04 14:04:51 +0200 | [diff] [blame] | 34 | depends on DEBUG_KERNEL |
Steven Rostedt | 1b29b01 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 35 | select FRAME_POINTER |
| 36 | select TRACING |
Steven Rostedt | 35e8e30 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 37 | select CONTEXT_SWITCH_TRACER |
Steven Rostedt | 1b29b01 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 38 | help |
| 39 | Enable the kernel to trace every kernel function. This is done |
| 40 | by using a compiler feature to insert a small, 5-byte No-Operation |
| 41 | instruction to the beginning of every kernel function, which NOP |
| 42 | sequence is then dynamically patched into a tracer call when |
| 43 | tracing is enabled by the administrator. If it's runtime disabled |
| 44 | (the bootup default), then the overhead of the instructions is very |
| 45 | small and not measurable even in micro-benchmarks. |
Steven Rostedt | 35e8e30 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 46 | |
Steven Rostedt | 81d68a9 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 47 | config IRQSOFF_TRACER |
| 48 | bool "Interrupts-off Latency Tracer" |
| 49 | default n |
| 50 | depends on TRACE_IRQFLAGS_SUPPORT |
| 51 | depends on GENERIC_TIME |
Ingo Molnar | c1d2327 | 2008-05-12 21:20:55 +0200 | [diff] [blame] | 52 | depends on HAVE_FTRACE |
Ingo Molnar | d3ee6d9 | 2008-09-04 14:04:51 +0200 | [diff] [blame] | 53 | depends on DEBUG_KERNEL |
Steven Rostedt | 81d68a9 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 54 | select TRACE_IRQFLAGS |
| 55 | select TRACING |
| 56 | select TRACER_MAX_TRACE |
| 57 | help |
| 58 | This option measures the time spent in irqs-off critical |
| 59 | sections, with microsecond accuracy. |
| 60 | |
| 61 | The default measurement method is a maximum search, which is |
| 62 | disabled by default and can be runtime (re-)started |
| 63 | via: |
| 64 | |
| 65 | echo 0 > /debugfs/tracing/tracing_max_latency |
| 66 | |
Steven Rostedt | 6cd8a4b | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 67 | (Note that kernel size and overhead increases with this option |
| 68 | enabled. This option and the preempt-off timing option can be |
| 69 | used together or separately.) |
| 70 | |
| 71 | config PREEMPT_TRACER |
| 72 | bool "Preemption-off Latency Tracer" |
| 73 | default n |
| 74 | depends on GENERIC_TIME |
| 75 | depends on PREEMPT |
Ingo Molnar | c1d2327 | 2008-05-12 21:20:55 +0200 | [diff] [blame] | 76 | depends on HAVE_FTRACE |
Ingo Molnar | d3ee6d9 | 2008-09-04 14:04:51 +0200 | [diff] [blame] | 77 | depends on DEBUG_KERNEL |
Steven Rostedt | 6cd8a4b | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 78 | select TRACING |
| 79 | select TRACER_MAX_TRACE |
| 80 | help |
| 81 | This option measures the time spent in preemption off critical |
| 82 | sections, with microsecond accuracy. |
| 83 | |
| 84 | The default measurement method is a maximum search, which is |
| 85 | disabled by default and can be runtime (re-)started |
| 86 | via: |
| 87 | |
| 88 | echo 0 > /debugfs/tracing/tracing_max_latency |
| 89 | |
| 90 | (Note that kernel size and overhead increases with this option |
| 91 | enabled. This option and the irqs-off timing option can be |
| 92 | used together or separately.) |
| 93 | |
Ingo Molnar | f06c381 | 2008-05-12 21:20:47 +0200 | [diff] [blame] | 94 | config SYSPROF_TRACER |
| 95 | bool "Sysprof Tracer" |
Thomas Gleixner | 4d2df79 | 2008-05-24 15:00:46 +0200 | [diff] [blame] | 96 | depends on X86 |
Ingo Molnar | f06c381 | 2008-05-12 21:20:47 +0200 | [diff] [blame] | 97 | select TRACING |
| 98 | help |
| 99 | This tracer provides the trace needed by the 'Sysprof' userspace |
| 100 | tool. |
| 101 | |
Steven Rostedt | 352ad25 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 102 | config SCHED_TRACER |
| 103 | bool "Scheduling Latency Tracer" |
Ingo Molnar | c1d2327 | 2008-05-12 21:20:55 +0200 | [diff] [blame] | 104 | depends on HAVE_FTRACE |
Ingo Molnar | d3ee6d9 | 2008-09-04 14:04:51 +0200 | [diff] [blame] | 105 | depends on DEBUG_KERNEL |
Steven Rostedt | 352ad25 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 106 | select TRACING |
| 107 | select CONTEXT_SWITCH_TRACER |
| 108 | select TRACER_MAX_TRACE |
| 109 | help |
| 110 | This tracer tracks the latency of the highest priority task |
| 111 | to be scheduled in, starting from the point it has woken up. |
| 112 | |
Steven Rostedt | 35e8e30 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 113 | config CONTEXT_SWITCH_TRACER |
| 114 | bool "Trace process context switches" |
Ingo Molnar | c1d2327 | 2008-05-12 21:20:55 +0200 | [diff] [blame] | 115 | depends on HAVE_FTRACE |
Ingo Molnar | d3ee6d9 | 2008-09-04 14:04:51 +0200 | [diff] [blame] | 116 | depends on DEBUG_KERNEL |
Steven Rostedt | 35e8e30 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 117 | select TRACING |
| 118 | select MARKERS |
| 119 | help |
| 120 | This tracer gets called from the context switch and records |
| 121 | all switching of tasks. |
| 122 | |
Frédéric Weisbecker | 1f5c2ab | 2008-09-23 11:36:20 +0100 | [diff] [blame] | 123 | config BOOT_TRACER |
| 124 | bool "Trace boot initcalls" |
| 125 | depends on HAVE_FTRACE |
| 126 | depends on DEBUG_KERNEL |
| 127 | select TRACING |
| 128 | help |
| 129 | This tracer helps developers to optimize boot times: it records |
| 130 | the timings of the initcalls. Its aim is to be parsed by the |
| 131 | /scripts/bootgraph.pl tool to produce pretty graphics about |
| 132 | boot inefficiencies, giving a visual representation of the |
Frédéric Weisbecker | 3ce2b92 | 2008-09-24 10:36:09 +0100 | [diff] [blame] | 133 | delays during initcalls. Note that tracers self tests can't |
| 134 | be enabled if this tracer is selected since only one tracer |
| 135 | should touch the tracing buffer at a time. |
Frédéric Weisbecker | 1f5c2ab | 2008-09-23 11:36:20 +0100 | [diff] [blame] | 136 | |
Steven Rostedt | e5a81b6 | 2008-08-27 23:31:01 -0400 | [diff] [blame] | 137 | config STACK_TRACER |
| 138 | bool "Trace max stack" |
| 139 | depends on HAVE_FTRACE |
Ingo Molnar | 2ff01c6 | 2008-09-04 15:04:37 +0200 | [diff] [blame] | 140 | depends on DEBUG_KERNEL |
Steven Rostedt | e5a81b6 | 2008-08-27 23:31:01 -0400 | [diff] [blame] | 141 | select FTRACE |
| 142 | select STACKTRACE |
| 143 | help |
Ingo Molnar | 4519d9e | 2008-10-14 14:15:43 +0200 | [diff] [blame^] | 144 | This special tracer records the maximum stack footprint of the |
| 145 | kernel and displays it in debugfs/tracing/stack_trace. |
| 146 | |
| 147 | This tracer works by hooking into every function call that the |
| 148 | kernel executes, and keeping a maximum stack depth value and |
| 149 | stack-trace saved. Because this logic has to execute in every |
| 150 | kernel function, all the time, this option can slow down the |
| 151 | kernel measurably and is generally intended for kernel |
| 152 | developers only. |
| 153 | |
| 154 | Say N if unsure. |
Steven Rostedt | e5a81b6 | 2008-08-27 23:31:01 -0400 | [diff] [blame] | 155 | |
Steven Rostedt | 3d08339 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 156 | config DYNAMIC_FTRACE |
| 157 | bool "enable/disable ftrace tracepoints dynamically" |
| 158 | depends on FTRACE |
Steven Rostedt | 677aa9f | 2008-05-17 00:01:36 -0400 | [diff] [blame] | 159 | depends on HAVE_DYNAMIC_FTRACE |
Ingo Molnar | d3ee6d9 | 2008-09-04 14:04:51 +0200 | [diff] [blame] | 160 | depends on DEBUG_KERNEL |
Steven Rostedt | 3d08339 | 2008-05-12 21:20:42 +0200 | [diff] [blame] | 161 | default y |
| 162 | help |
| 163 | This option will modify all the calls to ftrace dynamically |
| 164 | (will patch them out of the binary image and replaces them |
| 165 | with a No-Op instruction) as they are called. A table is |
| 166 | created to dynamically enable them again. |
| 167 | |
| 168 | This way a CONFIG_FTRACE kernel is slightly larger, but otherwise |
| 169 | has native performance as long as no tracing is active. |
| 170 | |
| 171 | The changes to the code are done by a kernel thread that |
| 172 | wakes up once a second and checks to see if any ftrace calls |
| 173 | were made. If so, it runs stop_machine (stops all CPUS) |
| 174 | and modifies the code to jump over the call to ftrace. |
Steven Rostedt | 60a1177 | 2008-05-12 21:20:44 +0200 | [diff] [blame] | 175 | |
Steven Rostedt | 8da3821 | 2008-08-14 15:45:07 -0400 | [diff] [blame] | 176 | config FTRACE_MCOUNT_RECORD |
| 177 | def_bool y |
| 178 | depends on DYNAMIC_FTRACE |
| 179 | depends on HAVE_FTRACE_MCOUNT_RECORD |
| 180 | |
Steven Rostedt | 60a1177 | 2008-05-12 21:20:44 +0200 | [diff] [blame] | 181 | config FTRACE_SELFTEST |
| 182 | bool |
| 183 | |
| 184 | config FTRACE_STARTUP_TEST |
| 185 | bool "Perform a startup test on ftrace" |
Frédéric Weisbecker | 3ce2b92 | 2008-09-24 10:36:09 +0100 | [diff] [blame] | 186 | depends on TRACING && DEBUG_KERNEL && !BOOT_TRACER |
Steven Rostedt | 60a1177 | 2008-05-12 21:20:44 +0200 | [diff] [blame] | 187 | select FTRACE_SELFTEST |
| 188 | help |
| 189 | This option performs a series of startup tests on ftrace. On bootup |
| 190 | a series of tests are made to verify that the tracer is |
| 191 | functioning properly. It will do tests on all the configured |
| 192 | tracers of ftrace. |