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 7352ad25aSSteven Rostedtconfig TRACER_MAX_TRACE 8352ad25aSSteven Rostedt bool 9352ad25aSSteven Rostedt 10bc0c38d1SSteven Rostedtconfig TRACING 11bc0c38d1SSteven Rostedt bool 12bc0c38d1SSteven Rostedt select DEBUG_FS 1386387f7eSIngo Molnar select STACKTRACE 14bc0c38d1SSteven Rostedt 151b29b018SSteven Rostedtconfig FTRACE 161b29b018SSteven Rostedt bool "Kernel Function Tracer" 17694379e9SIngo Molnar depends on HAVE_FTRACE 181b29b018SSteven Rostedt select FRAME_POINTER 191b29b018SSteven Rostedt select TRACING 2035e8e302SSteven Rostedt select CONTEXT_SWITCH_TRACER 211b29b018SSteven Rostedt help 221b29b018SSteven Rostedt Enable the kernel to trace every kernel function. This is done 231b29b018SSteven Rostedt by using a compiler feature to insert a small, 5-byte No-Operation 241b29b018SSteven Rostedt instruction to the beginning of every kernel function, which NOP 251b29b018SSteven Rostedt sequence is then dynamically patched into a tracer call when 261b29b018SSteven Rostedt tracing is enabled by the administrator. If it's runtime disabled 271b29b018SSteven Rostedt (the bootup default), then the overhead of the instructions is very 281b29b018SSteven Rostedt small and not measurable even in micro-benchmarks. 2935e8e302SSteven Rostedt 3081d68a96SSteven Rostedtconfig IRQSOFF_TRACER 3181d68a96SSteven Rostedt bool "Interrupts-off Latency Tracer" 3281d68a96SSteven Rostedt default n 3381d68a96SSteven Rostedt depends on TRACE_IRQFLAGS_SUPPORT 3481d68a96SSteven Rostedt depends on GENERIC_TIME 35*c1d2327bSIngo Molnar depends on HAVE_FTRACE 3681d68a96SSteven Rostedt select TRACE_IRQFLAGS 3781d68a96SSteven Rostedt select TRACING 3881d68a96SSteven Rostedt select TRACER_MAX_TRACE 3981d68a96SSteven Rostedt help 4081d68a96SSteven Rostedt This option measures the time spent in irqs-off critical 4181d68a96SSteven Rostedt sections, with microsecond accuracy. 4281d68a96SSteven Rostedt 4381d68a96SSteven Rostedt The default measurement method is a maximum search, which is 4481d68a96SSteven Rostedt disabled by default and can be runtime (re-)started 4581d68a96SSteven Rostedt via: 4681d68a96SSteven Rostedt 4781d68a96SSteven Rostedt echo 0 > /debugfs/tracing/tracing_max_latency 4881d68a96SSteven Rostedt 496cd8a4bbSSteven Rostedt (Note that kernel size and overhead increases with this option 506cd8a4bbSSteven Rostedt enabled. This option and the preempt-off timing option can be 516cd8a4bbSSteven Rostedt used together or separately.) 526cd8a4bbSSteven Rostedt 536cd8a4bbSSteven Rostedtconfig PREEMPT_TRACER 546cd8a4bbSSteven Rostedt bool "Preemption-off Latency Tracer" 556cd8a4bbSSteven Rostedt default n 566cd8a4bbSSteven Rostedt depends on GENERIC_TIME 576cd8a4bbSSteven Rostedt depends on PREEMPT 58*c1d2327bSIngo Molnar depends on HAVE_FTRACE 596cd8a4bbSSteven Rostedt select TRACING 606cd8a4bbSSteven Rostedt select TRACER_MAX_TRACE 616cd8a4bbSSteven Rostedt help 626cd8a4bbSSteven Rostedt This option measures the time spent in preemption off critical 636cd8a4bbSSteven Rostedt sections, with microsecond accuracy. 646cd8a4bbSSteven Rostedt 656cd8a4bbSSteven Rostedt The default measurement method is a maximum search, which is 666cd8a4bbSSteven Rostedt disabled by default and can be runtime (re-)started 676cd8a4bbSSteven Rostedt via: 686cd8a4bbSSteven Rostedt 696cd8a4bbSSteven Rostedt echo 0 > /debugfs/tracing/tracing_max_latency 706cd8a4bbSSteven Rostedt 716cd8a4bbSSteven Rostedt (Note that kernel size and overhead increases with this option 726cd8a4bbSSteven Rostedt enabled. This option and the irqs-off timing option can be 736cd8a4bbSSteven Rostedt used together or separately.) 746cd8a4bbSSteven Rostedt 75352ad25aSSteven Rostedtconfig SCHED_TRACER 76352ad25aSSteven Rostedt bool "Scheduling Latency Tracer" 77*c1d2327bSIngo Molnar depends on HAVE_FTRACE 78352ad25aSSteven Rostedt select TRACING 79352ad25aSSteven Rostedt select CONTEXT_SWITCH_TRACER 80352ad25aSSteven Rostedt select TRACER_MAX_TRACE 81352ad25aSSteven Rostedt help 82352ad25aSSteven Rostedt This tracer tracks the latency of the highest priority task 83352ad25aSSteven Rostedt to be scheduled in, starting from the point it has woken up. 84352ad25aSSteven Rostedt 8535e8e302SSteven Rostedtconfig CONTEXT_SWITCH_TRACER 8635e8e302SSteven Rostedt bool "Trace process context switches" 87*c1d2327bSIngo Molnar depends on HAVE_FTRACE 8835e8e302SSteven Rostedt select TRACING 8935e8e302SSteven Rostedt select MARKERS 9035e8e302SSteven Rostedt help 9135e8e302SSteven Rostedt This tracer gets called from the context switch and records 9235e8e302SSteven Rostedt all switching of tasks. 9335e8e302SSteven Rostedt 943d083395SSteven Rostedtconfig DYNAMIC_FTRACE 953d083395SSteven Rostedt bool "enable/disable ftrace tracepoints dynamically" 963d083395SSteven Rostedt depends on FTRACE 973d083395SSteven Rostedt default y 983d083395SSteven Rostedt help 993d083395SSteven Rostedt This option will modify all the calls to ftrace dynamically 1003d083395SSteven Rostedt (will patch them out of the binary image and replaces them 1013d083395SSteven Rostedt with a No-Op instruction) as they are called. A table is 1023d083395SSteven Rostedt created to dynamically enable them again. 1033d083395SSteven Rostedt 1043d083395SSteven Rostedt This way a CONFIG_FTRACE kernel is slightly larger, but otherwise 1053d083395SSteven Rostedt has native performance as long as no tracing is active. 1063d083395SSteven Rostedt 1073d083395SSteven Rostedt The changes to the code are done by a kernel thread that 1083d083395SSteven Rostedt wakes up once a second and checks to see if any ftrace calls 1093d083395SSteven Rostedt were made. If so, it runs stop_machine (stops all CPUS) 1103d083395SSteven Rostedt and modifies the code to jump over the call to ftrace. 11160a11774SSteven Rostedt 11260a11774SSteven Rostedtconfig FTRACE_SELFTEST 11360a11774SSteven Rostedt bool 11460a11774SSteven Rostedt 11560a11774SSteven Rostedtconfig FTRACE_STARTUP_TEST 11660a11774SSteven Rostedt bool "Perform a startup test on ftrace" 11760a11774SSteven Rostedt depends on TRACING 11860a11774SSteven Rostedt select FTRACE_SELFTEST 11960a11774SSteven Rostedt help 12060a11774SSteven Rostedt This option performs a series of startup tests on ftrace. On bootup 12160a11774SSteven Rostedt a series of tests are made to verify that the tracer is 12260a11774SSteven Rostedt functioning properly. It will do tests on all the configured 12360a11774SSteven Rostedt tracers of ftrace. 124