116444a8aSArnaldo Carvalho de Melo# 216444a8aSArnaldo Carvalho de Melo# Architectures that offer an FTRACE implementation should select HAVE_FTRACE: 316444a8aSArnaldo Carvalho de Melo# 416444a8aSArnaldo Carvalho de Meloconfig HAVE_FTRACE 516444a8aSArnaldo Carvalho de Melo bool 6bc0c38d1SSteven Rostedt 7677aa9f7SSteven Rostedtconfig HAVE_DYNAMIC_FTRACE 8677aa9f7SSteven Rostedt bool 9677aa9f7SSteven Rostedt 108da3821bSSteven Rostedtconfig HAVE_FTRACE_MCOUNT_RECORD 118da3821bSSteven Rostedt bool 128da3821bSSteven Rostedt 13352ad25aSSteven Rostedtconfig TRACER_MAX_TRACE 14352ad25aSSteven Rostedt bool 15352ad25aSSteven Rostedt 16bc0c38d1SSteven Rostedtconfig TRACING 17bc0c38d1SSteven Rostedt bool 18bc0c38d1SSteven Rostedt select DEBUG_FS 1986387f7eSIngo Molnar select STACKTRACE 205f87f112SIngo Molnar select TRACEPOINTS 21bc0c38d1SSteven Rostedt 221b29b018SSteven Rostedtconfig FTRACE 231b29b018SSteven Rostedt bool "Kernel Function Tracer" 24694379e9SIngo Molnar depends on HAVE_FTRACE 25*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 261b29b018SSteven Rostedt select FRAME_POINTER 271b29b018SSteven Rostedt select TRACING 2835e8e302SSteven Rostedt select CONTEXT_SWITCH_TRACER 291b29b018SSteven Rostedt help 301b29b018SSteven Rostedt Enable the kernel to trace every kernel function. This is done 311b29b018SSteven Rostedt by using a compiler feature to insert a small, 5-byte No-Operation 321b29b018SSteven Rostedt instruction to the beginning of every kernel function, which NOP 331b29b018SSteven Rostedt sequence is then dynamically patched into a tracer call when 341b29b018SSteven Rostedt tracing is enabled by the administrator. If it's runtime disabled 351b29b018SSteven Rostedt (the bootup default), then the overhead of the instructions is very 361b29b018SSteven Rostedt small and not measurable even in micro-benchmarks. 3735e8e302SSteven Rostedt 3881d68a96SSteven Rostedtconfig IRQSOFF_TRACER 3981d68a96SSteven Rostedt bool "Interrupts-off Latency Tracer" 4081d68a96SSteven Rostedt default n 4181d68a96SSteven Rostedt depends on TRACE_IRQFLAGS_SUPPORT 4281d68a96SSteven Rostedt depends on GENERIC_TIME 43c1d2327bSIngo Molnar depends on HAVE_FTRACE 44*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 4581d68a96SSteven Rostedt select TRACE_IRQFLAGS 4681d68a96SSteven Rostedt select TRACING 4781d68a96SSteven Rostedt select TRACER_MAX_TRACE 4881d68a96SSteven Rostedt help 4981d68a96SSteven Rostedt This option measures the time spent in irqs-off critical 5081d68a96SSteven Rostedt sections, with microsecond accuracy. 5181d68a96SSteven Rostedt 5281d68a96SSteven Rostedt The default measurement method is a maximum search, which is 5381d68a96SSteven Rostedt disabled by default and can be runtime (re-)started 5481d68a96SSteven Rostedt via: 5581d68a96SSteven Rostedt 5681d68a96SSteven Rostedt echo 0 > /debugfs/tracing/tracing_max_latency 5781d68a96SSteven Rostedt 586cd8a4bbSSteven Rostedt (Note that kernel size and overhead increases with this option 596cd8a4bbSSteven Rostedt enabled. This option and the preempt-off timing option can be 606cd8a4bbSSteven Rostedt used together or separately.) 616cd8a4bbSSteven Rostedt 626cd8a4bbSSteven Rostedtconfig PREEMPT_TRACER 636cd8a4bbSSteven Rostedt bool "Preemption-off Latency Tracer" 646cd8a4bbSSteven Rostedt default n 656cd8a4bbSSteven Rostedt depends on GENERIC_TIME 666cd8a4bbSSteven Rostedt depends on PREEMPT 67c1d2327bSIngo Molnar depends on HAVE_FTRACE 68*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 696cd8a4bbSSteven Rostedt select TRACING 706cd8a4bbSSteven Rostedt select TRACER_MAX_TRACE 716cd8a4bbSSteven Rostedt help 726cd8a4bbSSteven Rostedt This option measures the time spent in preemption off critical 736cd8a4bbSSteven Rostedt sections, with microsecond accuracy. 746cd8a4bbSSteven Rostedt 756cd8a4bbSSteven Rostedt The default measurement method is a maximum search, which is 766cd8a4bbSSteven Rostedt disabled by default and can be runtime (re-)started 776cd8a4bbSSteven Rostedt via: 786cd8a4bbSSteven Rostedt 796cd8a4bbSSteven Rostedt echo 0 > /debugfs/tracing/tracing_max_latency 806cd8a4bbSSteven Rostedt 816cd8a4bbSSteven Rostedt (Note that kernel size and overhead increases with this option 826cd8a4bbSSteven Rostedt enabled. This option and the irqs-off timing option can be 836cd8a4bbSSteven Rostedt used together or separately.) 846cd8a4bbSSteven Rostedt 85f06c3810SIngo Molnarconfig SYSPROF_TRACER 86f06c3810SIngo Molnar bool "Sysprof Tracer" 874d2df795SThomas Gleixner depends on X86 88f06c3810SIngo Molnar select TRACING 89f06c3810SIngo Molnar help 90f06c3810SIngo Molnar This tracer provides the trace needed by the 'Sysprof' userspace 91f06c3810SIngo Molnar tool. 92f06c3810SIngo Molnar 93352ad25aSSteven Rostedtconfig SCHED_TRACER 94352ad25aSSteven Rostedt bool "Scheduling Latency Tracer" 95c1d2327bSIngo Molnar depends on HAVE_FTRACE 96*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 97352ad25aSSteven Rostedt select TRACING 98352ad25aSSteven Rostedt select CONTEXT_SWITCH_TRACER 99352ad25aSSteven Rostedt select TRACER_MAX_TRACE 100352ad25aSSteven Rostedt help 101352ad25aSSteven Rostedt This tracer tracks the latency of the highest priority task 102352ad25aSSteven Rostedt to be scheduled in, starting from the point it has woken up. 103352ad25aSSteven Rostedt 10435e8e302SSteven Rostedtconfig CONTEXT_SWITCH_TRACER 10535e8e302SSteven Rostedt bool "Trace process context switches" 106c1d2327bSIngo Molnar depends on HAVE_FTRACE 107*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 10835e8e302SSteven Rostedt select TRACING 10935e8e302SSteven Rostedt select MARKERS 11035e8e302SSteven Rostedt help 11135e8e302SSteven Rostedt This tracer gets called from the context switch and records 11235e8e302SSteven Rostedt all switching of tasks. 11335e8e302SSteven Rostedt 114e5a81b62SSteven Rostedtconfig STACK_TRACER 115e5a81b62SSteven Rostedt bool "Trace max stack" 116e5a81b62SSteven Rostedt depends on HAVE_FTRACE 1172ff01c6aSIngo Molnar depends on DEBUG_KERNEL 118e5a81b62SSteven Rostedt select FTRACE 119e5a81b62SSteven Rostedt select STACKTRACE 120e5a81b62SSteven Rostedt help 121e5a81b62SSteven Rostedt This tracer records the max stack of the kernel, and displays 122e5a81b62SSteven Rostedt it in debugfs/tracing/stack_trace 123e5a81b62SSteven Rostedt 1243d083395SSteven Rostedtconfig DYNAMIC_FTRACE 1253d083395SSteven Rostedt bool "enable/disable ftrace tracepoints dynamically" 1263d083395SSteven Rostedt depends on FTRACE 127677aa9f7SSteven Rostedt depends on HAVE_DYNAMIC_FTRACE 128*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 1293d083395SSteven Rostedt default y 1303d083395SSteven Rostedt help 1313d083395SSteven Rostedt This option will modify all the calls to ftrace dynamically 1323d083395SSteven Rostedt (will patch them out of the binary image and replaces them 1333d083395SSteven Rostedt with a No-Op instruction) as they are called. A table is 1343d083395SSteven Rostedt created to dynamically enable them again. 1353d083395SSteven Rostedt 1363d083395SSteven Rostedt This way a CONFIG_FTRACE kernel is slightly larger, but otherwise 1373d083395SSteven Rostedt has native performance as long as no tracing is active. 1383d083395SSteven Rostedt 1393d083395SSteven Rostedt The changes to the code are done by a kernel thread that 1403d083395SSteven Rostedt wakes up once a second and checks to see if any ftrace calls 1413d083395SSteven Rostedt were made. If so, it runs stop_machine (stops all CPUS) 1423d083395SSteven Rostedt and modifies the code to jump over the call to ftrace. 14360a11774SSteven Rostedt 1448da3821bSSteven Rostedtconfig FTRACE_MCOUNT_RECORD 1458da3821bSSteven Rostedt def_bool y 1468da3821bSSteven Rostedt depends on DYNAMIC_FTRACE 1478da3821bSSteven Rostedt depends on HAVE_FTRACE_MCOUNT_RECORD 1488da3821bSSteven Rostedt 14960a11774SSteven Rostedtconfig FTRACE_SELFTEST 15060a11774SSteven Rostedt bool 15160a11774SSteven Rostedt 15260a11774SSteven Rostedtconfig FTRACE_STARTUP_TEST 15360a11774SSteven Rostedt bool "Perform a startup test on ftrace" 15460a11774SSteven Rostedt depends on TRACING 155*d3ee6d99SIngo Molnar depends on DEBUG_KERNEL 15660a11774SSteven Rostedt select FTRACE_SELFTEST 15760a11774SSteven Rostedt help 15860a11774SSteven Rostedt This option performs a series of startup tests on ftrace. On bootup 15960a11774SSteven Rostedt a series of tests are made to verify that the tracer is 16060a11774SSteven Rostedt functioning properly. It will do tests on all the configured 16160a11774SSteven Rostedt tracers of ftrace. 162