xref: /linux/kernel/trace/Kconfig (revision d8a953ddde5ec30a36810d0a892c3949b50849e9)
1ec8f24b7SThomas Gleixner# SPDX-License-Identifier: GPL-2.0-only
216444a8aSArnaldo Carvalho de Melo#
3606576ceSSteven Rostedt# Architectures that offer an FUNCTION_TRACER implementation should
4606576ceSSteven Rostedt#  select HAVE_FUNCTION_TRACER:
516444a8aSArnaldo Carvalho de Melo#
62a3a4f66SFrédéric Weisbecker
78d26487fSTörök Edwinconfig USER_STACKTRACE_SUPPORT
88d26487fSTörök Edwin	bool
98d26487fSTörök Edwin
102a3a4f66SFrédéric Weisbeckerconfig NOP_TRACER
112a3a4f66SFrédéric Weisbecker	bool
122a3a4f66SFrédéric Weisbecker
1378d904b4SSteven Rostedtconfig HAVE_FTRACE_NMI_ENTER
1478d904b4SSteven Rostedt	bool
15555f386cSMike Frysinger	help
165fb94e9cSMauro Carvalho Chehab	  See Documentation/trace/ftrace-design.rst
1778d904b4SSteven Rostedt
18606576ceSSteven Rostedtconfig HAVE_FUNCTION_TRACER
1916444a8aSArnaldo Carvalho de Melo	bool
20555f386cSMike Frysinger	help
215fb94e9cSMauro Carvalho Chehab	  See Documentation/trace/ftrace-design.rst
22bc0c38d1SSteven Rostedt
23fb52607aSFrederic Weisbeckerconfig HAVE_FUNCTION_GRAPH_TRACER
2415e6cb36SFrederic Weisbecker	bool
25555f386cSMike Frysinger	help
265fb94e9cSMauro Carvalho Chehab	  See Documentation/trace/ftrace-design.rst
2715e6cb36SFrederic Weisbecker
28677aa9f7SSteven Rostedtconfig HAVE_DYNAMIC_FTRACE
29677aa9f7SSteven Rostedt	bool
30555f386cSMike Frysinger	help
315fb94e9cSMauro Carvalho Chehab	  See Documentation/trace/ftrace-design.rst
32677aa9f7SSteven Rostedt
3306aeaaeaSMasami Hiramatsuconfig HAVE_DYNAMIC_FTRACE_WITH_REGS
3406aeaaeaSMasami Hiramatsu	bool
3506aeaaeaSMasami Hiramatsu
36763e34e7SSteven Rostedt (VMware)config HAVE_DYNAMIC_FTRACE_WITH_DIRECT_CALLS
37763e34e7SSteven Rostedt (VMware)	bool
38763e34e7SSteven Rostedt (VMware)
398da3821bSSteven Rostedtconfig HAVE_FTRACE_MCOUNT_RECORD
408da3821bSSteven Rostedt	bool
41555f386cSMike Frysinger	help
425fb94e9cSMauro Carvalho Chehab	  See Documentation/trace/ftrace-design.rst
438da3821bSSteven Rostedt
4466700001SJosh Stoneconfig HAVE_SYSCALL_TRACEPOINTS
45ee08c6ecSFrederic Weisbecker	bool
46555f386cSMike Frysinger	help
475fb94e9cSMauro Carvalho Chehab	  See Documentation/trace/ftrace-design.rst
48ee08c6ecSFrederic Weisbecker
49a2546faeSSteven Rostedtconfig HAVE_FENTRY
50a2546faeSSteven Rostedt	bool
51a2546faeSSteven Rostedt	help
52a2546faeSSteven Rostedt	  Arch supports the gcc options -pg with -mfentry
53a2546faeSSteven Rostedt
542f4df001SVasily Gorbikconfig HAVE_NOP_MCOUNT
552f4df001SVasily Gorbik	bool
562f4df001SVasily Gorbik	help
572f4df001SVasily Gorbik	  Arch supports the gcc options -pg with -mrecord-mcount and -nop-mcount
582f4df001SVasily Gorbik
59cf4db259SSteven Rostedtconfig HAVE_C_RECORDMCOUNT
6072441cb1SSteven Rostedt	bool
6172441cb1SSteven Rostedt	help
6272441cb1SSteven Rostedt	  C version of recordmcount available?
6372441cb1SSteven Rostedt
64352ad25aSSteven Rostedtconfig TRACER_MAX_TRACE
65352ad25aSSteven Rostedt	bool
66352ad25aSSteven Rostedt
67ea632e9fSJosh Triplettconfig TRACE_CLOCK
68ea632e9fSJosh Triplett	bool
69ea632e9fSJosh Triplett
707a8e76a3SSteven Rostedtconfig RING_BUFFER
717a8e76a3SSteven Rostedt	bool
72ea632e9fSJosh Triplett	select TRACE_CLOCK
7322287688SSteven Rostedt (Red Hat)	select IRQ_WORK
747a8e76a3SSteven Rostedt
7578d904b4SSteven Rostedtconfig FTRACE_NMI_ENTER
7678d904b4SSteven Rostedt       bool
7778d904b4SSteven Rostedt       depends on HAVE_FTRACE_NMI_ENTER
7878d904b4SSteven Rostedt       default y
7978d904b4SSteven Rostedt
805f77a88bSTom Zanussiconfig EVENT_TRACING
81b11c53e1SZhaolei	select CONTEXT_SWITCH_TRACER
8260f1d5e3SMasami Hiramatsu	select GLOB
83b11c53e1SZhaolei	bool
84b11c53e1SZhaolei
85b11c53e1SZhaoleiconfig CONTEXT_SWITCH_TRACER
865f77a88bSTom Zanussi	bool
875f77a88bSTom Zanussi
8885bac32cSSteven Rostedtconfig RING_BUFFER_ALLOW_SWAP
8985bac32cSSteven Rostedt	bool
9085bac32cSSteven Rostedt	help
9185bac32cSSteven Rostedt	 Allow the use of ring_buffer_swap_cpu.
9285bac32cSSteven Rostedt	 Adds a very slight overhead to tracing when enabled.
9385bac32cSSteven Rostedt
94c3bc8fd6SJoel Fernandes (Google)config PREEMPTIRQ_TRACEPOINTS
95c3bc8fd6SJoel Fernandes (Google)	bool
96c3bc8fd6SJoel Fernandes (Google)	depends on TRACE_PREEMPT_TOGGLE || TRACE_IRQFLAGS
97c3bc8fd6SJoel Fernandes (Google)	select TRACING
98c3bc8fd6SJoel Fernandes (Google)	default y
99c3bc8fd6SJoel Fernandes (Google)	help
100c3bc8fd6SJoel Fernandes (Google)	  Create preempt/irq toggle tracepoints if needed, so that other parts
101c3bc8fd6SJoel Fernandes (Google)	  of the kernel can use them to generate or add hooks to them.
102c3bc8fd6SJoel Fernandes (Google)
1035e0a0939SSteven Rostedt# All tracer options should select GENERIC_TRACER. For those options that are
1045e0a0939SSteven Rostedt# enabled by all tracers (context switch and event tracer) they select TRACING.
1055e0a0939SSteven Rostedt# This allows those options to appear when no other tracer is selected. But the
1065e0a0939SSteven Rostedt# options do not appear when something else selects it. We need the two options
1075e0a0939SSteven Rostedt# GENERIC_TRACER and TRACING to avoid circular dependencies to accomplish the
10840892367SRandy Dunlap# hiding of the automatic options.
1095e0a0939SSteven Rostedt
110bc0c38d1SSteven Rostedtconfig TRACING
111bc0c38d1SSteven Rostedt	bool
1127a8e76a3SSteven Rostedt	select RING_BUFFER
113c2c80529SAl Viro	select STACKTRACE if STACKTRACE_SUPPORT
1145f87f112SIngo Molnar	select TRACEPOINTS
115f3384b28SSteven Rostedt	select NOP_TRACER
116769b0441SFrederic Weisbecker	select BINARY_PRINTF
1175f77a88bSTom Zanussi	select EVENT_TRACING
118ea632e9fSJosh Triplett	select TRACE_CLOCK
119bc0c38d1SSteven Rostedt
1205e0a0939SSteven Rostedtconfig GENERIC_TRACER
1215e0a0939SSteven Rostedt	bool
1225e0a0939SSteven Rostedt	select TRACING
1235e0a0939SSteven Rostedt
12440ada30fSIngo Molnar#
12540ada30fSIngo Molnar# Minimum requirements an architecture has to meet for us to
12640ada30fSIngo Molnar# be able to offer generic tracing facilities:
12740ada30fSIngo Molnar#
12840ada30fSIngo Molnarconfig TRACING_SUPPORT
12940ada30fSIngo Molnar	bool
1300ea5ee03SMichael Ellerman	depends on TRACE_IRQFLAGS_SUPPORT
13140ada30fSIngo Molnar	depends on STACKTRACE_SUPPORT
132422d3c7aSKOSAKI Motohiro	default y
13340ada30fSIngo Molnar
13440ada30fSIngo Molnarif TRACING_SUPPORT
13540ada30fSIngo Molnar
1364ed9f071SSteven Rostedtmenuconfig FTRACE
1374ed9f071SSteven Rostedt	bool "Tracers"
13865b77242SSteven Rostedt	default y if DEBUG_KERNEL
1394ed9f071SSteven Rostedt	help
1404ed9f071SSteven Rostedt	  Enable the kernel tracing infrastructure.
1414ed9f071SSteven Rostedt
1424ed9f071SSteven Rostedtif FTRACE
14317d80fd0SPeter Zijlstra
1441e837945SSteven Rostedt (VMware)config BOOTTIME_TRACING
1451e837945SSteven Rostedt (VMware)	bool "Boot-time Tracing support"
146*d8a953ddSMasami Hiramatsu	depends on TRACING
147*d8a953ddSMasami Hiramatsu	select BOOT_CONFIG
1481e837945SSteven Rostedt (VMware)	default y
1491e837945SSteven Rostedt (VMware)	help
1501e837945SSteven Rostedt (VMware)	  Enable developer to setup ftrace subsystem via supplemental
1511e837945SSteven Rostedt (VMware)	  kernel cmdline at boot time for debugging (tracing) driver
1521e837945SSteven Rostedt (VMware)	  initialization and boot process.
1531e837945SSteven Rostedt (VMware)
154606576ceSSteven Rostedtconfig FUNCTION_TRACER
1551b29b018SSteven Rostedt	bool "Kernel Function Tracer"
156606576ceSSteven Rostedt	depends on HAVE_FUNCTION_TRACER
1574d7a077cSSteven Rostedt	select KALLSYMS
1585e0a0939SSteven Rostedt	select GENERIC_TRACER
15935e8e302SSteven Rostedt	select CONTEXT_SWITCH_TRACER
16060f1d5e3SMasami Hiramatsu	select GLOB
16101b1d88bSThomas Gleixner	select TASKS_RCU if PREEMPTION
1621b29b018SSteven Rostedt	help
1631b29b018SSteven Rostedt	  Enable the kernel to trace every kernel function. This is done
1641b29b018SSteven Rostedt	  by using a compiler feature to insert a small, 5-byte No-Operation
16540892367SRandy Dunlap	  instruction at the beginning of every kernel function, which NOP
1661b29b018SSteven Rostedt	  sequence is then dynamically patched into a tracer call when
1671b29b018SSteven Rostedt	  tracing is enabled by the administrator. If it's runtime disabled
1681b29b018SSteven Rostedt	  (the bootup default), then the overhead of the instructions is very
1691b29b018SSteven Rostedt	  small and not measurable even in micro-benchmarks.
17035e8e302SSteven Rostedt
171fb52607aSFrederic Weisbeckerconfig FUNCTION_GRAPH_TRACER
172fb52607aSFrederic Weisbecker	bool "Kernel Function Graph Tracer"
173fb52607aSFrederic Weisbecker	depends on HAVE_FUNCTION_GRAPH_TRACER
17415e6cb36SFrederic Weisbecker	depends on FUNCTION_TRACER
175eb4a0378SSteven Rostedt	depends on !X86_32 || !CC_OPTIMIZE_FOR_SIZE
176764f3b95SIngo Molnar	default y
17715e6cb36SFrederic Weisbecker	help
178fb52607aSFrederic Weisbecker	  Enable the kernel to trace a function at both its return
179fb52607aSFrederic Weisbecker	  and its entry.
180692105b8SMatt LaPlante	  Its first purpose is to trace the duration of functions and
181692105b8SMatt LaPlante	  draw a call graph for each thread with some information like
182692105b8SMatt LaPlante	  the return value. This is done by setting the current return
183692105b8SMatt LaPlante	  address on the current task structure into a stack of calls.
18415e6cb36SFrederic Weisbecker
18561778cd7SSteven Rostedt (VMware)config DYNAMIC_FTRACE
18661778cd7SSteven Rostedt (VMware)	bool "enable/disable function tracing dynamically"
18761778cd7SSteven Rostedt (VMware)	depends on FUNCTION_TRACER
18861778cd7SSteven Rostedt (VMware)	depends on HAVE_DYNAMIC_FTRACE
18961778cd7SSteven Rostedt (VMware)	default y
19061778cd7SSteven Rostedt (VMware)	help
19161778cd7SSteven Rostedt (VMware)	  This option will modify all the calls to function tracing
19261778cd7SSteven Rostedt (VMware)	  dynamically (will patch them out of the binary image and
19361778cd7SSteven Rostedt (VMware)	  replace them with a No-Op instruction) on boot up. During
19461778cd7SSteven Rostedt (VMware)	  compile time, a table is made of all the locations that ftrace
19561778cd7SSteven Rostedt (VMware)	  can function trace, and this table is linked into the kernel
19661778cd7SSteven Rostedt (VMware)	  image. When this is enabled, functions can be individually
19761778cd7SSteven Rostedt (VMware)	  enabled, and the functions not enabled will not affect
19861778cd7SSteven Rostedt (VMware)	  performance of the system.
19961778cd7SSteven Rostedt (VMware)
20061778cd7SSteven Rostedt (VMware)	  See the files in /sys/kernel/debug/tracing:
20161778cd7SSteven Rostedt (VMware)	    available_filter_functions
20261778cd7SSteven Rostedt (VMware)	    set_ftrace_filter
20361778cd7SSteven Rostedt (VMware)	    set_ftrace_notrace
20461778cd7SSteven Rostedt (VMware)
20561778cd7SSteven Rostedt (VMware)	  This way a CONFIG_FUNCTION_TRACER kernel is slightly larger, but
20661778cd7SSteven Rostedt (VMware)	  otherwise has native performance as long as no tracing is active.
20761778cd7SSteven Rostedt (VMware)
20861778cd7SSteven Rostedt (VMware)config DYNAMIC_FTRACE_WITH_REGS
20961778cd7SSteven Rostedt (VMware)	def_bool y
21061778cd7SSteven Rostedt (VMware)	depends on DYNAMIC_FTRACE
21161778cd7SSteven Rostedt (VMware)	depends on HAVE_DYNAMIC_FTRACE_WITH_REGS
21261778cd7SSteven Rostedt (VMware)
21361778cd7SSteven Rostedt (VMware)config DYNAMIC_FTRACE_WITH_DIRECT_CALLS
21461778cd7SSteven Rostedt (VMware)	def_bool y
21561778cd7SSteven Rostedt (VMware)	depends on DYNAMIC_FTRACE
21661778cd7SSteven Rostedt (VMware)	depends on HAVE_DYNAMIC_FTRACE_WITH_DIRECT_CALLS
21761778cd7SSteven Rostedt (VMware)
21861778cd7SSteven Rostedt (VMware)config FUNCTION_PROFILER
21961778cd7SSteven Rostedt (VMware)	bool "Kernel function profiler"
22061778cd7SSteven Rostedt (VMware)	depends on FUNCTION_TRACER
22161778cd7SSteven Rostedt (VMware)	default n
22261778cd7SSteven Rostedt (VMware)	help
22361778cd7SSteven Rostedt (VMware)	  This option enables the kernel function profiler. A file is created
22461778cd7SSteven Rostedt (VMware)	  in debugfs called function_profile_enabled which defaults to zero.
22561778cd7SSteven Rostedt (VMware)	  When a 1 is echoed into this file profiling begins, and when a
22661778cd7SSteven Rostedt (VMware)	  zero is entered, profiling stops. A "functions" file is created in
22761778cd7SSteven Rostedt (VMware)	  the trace_stat directory; this file shows the list of functions that
22861778cd7SSteven Rostedt (VMware)	  have been hit and their counters.
22961778cd7SSteven Rostedt (VMware)
23061778cd7SSteven Rostedt (VMware)	  If in doubt, say N.
23161778cd7SSteven Rostedt (VMware)
23261778cd7SSteven Rostedt (VMware)config STACK_TRACER
23361778cd7SSteven Rostedt (VMware)	bool "Trace max stack"
23461778cd7SSteven Rostedt (VMware)	depends on HAVE_FUNCTION_TRACER
23561778cd7SSteven Rostedt (VMware)	select FUNCTION_TRACER
23661778cd7SSteven Rostedt (VMware)	select STACKTRACE
23761778cd7SSteven Rostedt (VMware)	select KALLSYMS
23861778cd7SSteven Rostedt (VMware)	help
23961778cd7SSteven Rostedt (VMware)	  This special tracer records the maximum stack footprint of the
24061778cd7SSteven Rostedt (VMware)	  kernel and displays it in /sys/kernel/debug/tracing/stack_trace.
24161778cd7SSteven Rostedt (VMware)
24261778cd7SSteven Rostedt (VMware)	  This tracer works by hooking into every function call that the
24361778cd7SSteven Rostedt (VMware)	  kernel executes, and keeping a maximum stack depth value and
24461778cd7SSteven Rostedt (VMware)	  stack-trace saved.  If this is configured with DYNAMIC_FTRACE
24561778cd7SSteven Rostedt (VMware)	  then it will not have any overhead while the stack tracer
24661778cd7SSteven Rostedt (VMware)	  is disabled.
24761778cd7SSteven Rostedt (VMware)
24861778cd7SSteven Rostedt (VMware)	  To enable the stack tracer on bootup, pass in 'stacktrace'
24961778cd7SSteven Rostedt (VMware)	  on the kernel command line.
25061778cd7SSteven Rostedt (VMware)
25161778cd7SSteven Rostedt (VMware)	  The stack tracer can also be enabled or disabled via the
25261778cd7SSteven Rostedt (VMware)	  sysctl kernel.stack_tracer_enabled
25361778cd7SSteven Rostedt (VMware)
25461778cd7SSteven Rostedt (VMware)	  Say N if unsure.
25561778cd7SSteven Rostedt (VMware)
256c3bc8fd6SJoel Fernandes (Google)config TRACE_PREEMPT_TOGGLE
257c3bc8fd6SJoel Fernandes (Google)	bool
258c3bc8fd6SJoel Fernandes (Google)	help
259c3bc8fd6SJoel Fernandes (Google)	  Enables hooks which will be called when preemption is first disabled,
260c3bc8fd6SJoel Fernandes (Google)	  and last enabled.
261bac429f0SSteven Rostedt
262d5915816SJoel Fernandesconfig PREEMPTIRQ_EVENTS
263d5915816SJoel Fernandes	bool "Enable trace events for preempt and irq disable/enable"
264d5915816SJoel Fernandes	select TRACE_IRQFLAGS
26530c93704SThomas Gleixner	select TRACE_PREEMPT_TOGGLE if PREEMPTION
266c3bc8fd6SJoel Fernandes (Google)	select GENERIC_TRACER
267d5915816SJoel Fernandes	default n
268d5915816SJoel Fernandes	help
269d5915816SJoel Fernandes	  Enable tracing of disable and enable events for preemption and irqs.
270d5915816SJoel Fernandes
27181d68a96SSteven Rostedtconfig IRQSOFF_TRACER
27281d68a96SSteven Rostedt	bool "Interrupts-off Latency Tracer"
27381d68a96SSteven Rostedt	default n
27481d68a96SSteven Rostedt	depends on TRACE_IRQFLAGS_SUPPORT
275592913ecSJohn Stultz	depends on !ARCH_USES_GETTIMEOFFSET
27681d68a96SSteven Rostedt	select TRACE_IRQFLAGS
2775e0a0939SSteven Rostedt	select GENERIC_TRACER
27881d68a96SSteven Rostedt	select TRACER_MAX_TRACE
27985bac32cSSteven Rostedt	select RING_BUFFER_ALLOW_SWAP
28022cffc2bSSteven Rostedt (Red Hat)	select TRACER_SNAPSHOT
2810b85ffc2SSteven Rostedt (Red Hat)	select TRACER_SNAPSHOT_PER_CPU_SWAP
28281d68a96SSteven Rostedt	help
28381d68a96SSteven Rostedt	  This option measures the time spent in irqs-off critical
28481d68a96SSteven Rostedt	  sections, with microsecond accuracy.
28581d68a96SSteven Rostedt
28681d68a96SSteven Rostedt	  The default measurement method is a maximum search, which is
28781d68a96SSteven Rostedt	  disabled by default and can be runtime (re-)started
28881d68a96SSteven Rostedt	  via:
28981d68a96SSteven Rostedt
290156f5a78SGeunSik Lim	      echo 0 > /sys/kernel/debug/tracing/tracing_max_latency
29181d68a96SSteven Rostedt
29240892367SRandy Dunlap	  (Note that kernel size and overhead increase with this option
2936cd8a4bbSSteven Rostedt	  enabled. This option and the preempt-off timing option can be
2946cd8a4bbSSteven Rostedt	  used together or separately.)
2956cd8a4bbSSteven Rostedt
2966cd8a4bbSSteven Rostedtconfig PREEMPT_TRACER
2976cd8a4bbSSteven Rostedt	bool "Preemption-off Latency Tracer"
2986cd8a4bbSSteven Rostedt	default n
299592913ecSJohn Stultz	depends on !ARCH_USES_GETTIMEOFFSET
30030c93704SThomas Gleixner	depends on PREEMPTION
3015e0a0939SSteven Rostedt	select GENERIC_TRACER
3026cd8a4bbSSteven Rostedt	select TRACER_MAX_TRACE
30385bac32cSSteven Rostedt	select RING_BUFFER_ALLOW_SWAP
30422cffc2bSSteven Rostedt (Red Hat)	select TRACER_SNAPSHOT
3050b85ffc2SSteven Rostedt (Red Hat)	select TRACER_SNAPSHOT_PER_CPU_SWAP
306c3bc8fd6SJoel Fernandes (Google)	select TRACE_PREEMPT_TOGGLE
3076cd8a4bbSSteven Rostedt	help
30840892367SRandy Dunlap	  This option measures the time spent in preemption-off critical
3096cd8a4bbSSteven Rostedt	  sections, with microsecond accuracy.
3106cd8a4bbSSteven Rostedt
3116cd8a4bbSSteven Rostedt	  The default measurement method is a maximum search, which is
3126cd8a4bbSSteven Rostedt	  disabled by default and can be runtime (re-)started
3136cd8a4bbSSteven Rostedt	  via:
3146cd8a4bbSSteven Rostedt
315156f5a78SGeunSik Lim	      echo 0 > /sys/kernel/debug/tracing/tracing_max_latency
3166cd8a4bbSSteven Rostedt
31740892367SRandy Dunlap	  (Note that kernel size and overhead increase with this option
3186cd8a4bbSSteven Rostedt	  enabled. This option and the irqs-off timing option can be
3196cd8a4bbSSteven Rostedt	  used together or separately.)
3206cd8a4bbSSteven Rostedt
321352ad25aSSteven Rostedtconfig SCHED_TRACER
322352ad25aSSteven Rostedt	bool "Scheduling Latency Tracer"
3235e0a0939SSteven Rostedt	select GENERIC_TRACER
324352ad25aSSteven Rostedt	select CONTEXT_SWITCH_TRACER
325352ad25aSSteven Rostedt	select TRACER_MAX_TRACE
32622cffc2bSSteven Rostedt (Red Hat)	select TRACER_SNAPSHOT
327352ad25aSSteven Rostedt	help
328352ad25aSSteven Rostedt	  This tracer tracks the latency of the highest priority task
329352ad25aSSteven Rostedt	  to be scheduled in, starting from the point it has woken up.
330352ad25aSSteven Rostedt
331e7c15cd8SSteven Rostedt (Red Hat)config HWLAT_TRACER
332e7c15cd8SSteven Rostedt (Red Hat)	bool "Tracer to detect hardware latencies (like SMIs)"
333e7c15cd8SSteven Rostedt (Red Hat)	select GENERIC_TRACER
334e7c15cd8SSteven Rostedt (Red Hat)	help
335e7c15cd8SSteven Rostedt (Red Hat)	 This tracer, when enabled will create one or more kernel threads,
336c5c1ea75SJesper Dangaard Brouer	 depending on what the cpumask file is set to, which each thread
337e7c15cd8SSteven Rostedt (Red Hat)	 spinning in a loop looking for interruptions caused by
338e7c15cd8SSteven Rostedt (Red Hat)	 something other than the kernel. For example, if a
339e7c15cd8SSteven Rostedt (Red Hat)	 System Management Interrupt (SMI) takes a noticeable amount of
340e7c15cd8SSteven Rostedt (Red Hat)	 time, this tracer will detect it. This is useful for testing
341e7c15cd8SSteven Rostedt (Red Hat)	 if a system is reliable for Real Time tasks.
342e7c15cd8SSteven Rostedt (Red Hat)
343e7c15cd8SSteven Rostedt (Red Hat)	 Some files are created in the tracing directory when this
344e7c15cd8SSteven Rostedt (Red Hat)	 is enabled:
345e7c15cd8SSteven Rostedt (Red Hat)
346e7c15cd8SSteven Rostedt (Red Hat)	   hwlat_detector/width   - time in usecs for how long to spin for
347e7c15cd8SSteven Rostedt (Red Hat)	   hwlat_detector/window  - time in usecs between the start of each
348e7c15cd8SSteven Rostedt (Red Hat)				     iteration
349e7c15cd8SSteven Rostedt (Red Hat)
350e7c15cd8SSteven Rostedt (Red Hat)	 A kernel thread is created that will spin with interrupts disabled
351c5c1ea75SJesper Dangaard Brouer	 for "width" microseconds in every "window" cycle. It will not spin
352e7c15cd8SSteven Rostedt (Red Hat)	 for "window - width" microseconds, where the system can
353e7c15cd8SSteven Rostedt (Red Hat)	 continue to operate.
354e7c15cd8SSteven Rostedt (Red Hat)
355e7c15cd8SSteven Rostedt (Red Hat)	 The output will appear in the trace and trace_pipe files.
356e7c15cd8SSteven Rostedt (Red Hat)
357e7c15cd8SSteven Rostedt (Red Hat)	 When the tracer is not running, it has no affect on the system,
358e7c15cd8SSteven Rostedt (Red Hat)	 but when it is running, it can cause the system to be
359e7c15cd8SSteven Rostedt (Red Hat)	 periodically non responsive. Do not run this tracer on a
360e7c15cd8SSteven Rostedt (Red Hat)	 production system.
361e7c15cd8SSteven Rostedt (Red Hat)
362e7c15cd8SSteven Rostedt (Red Hat)	 To enable this tracer, echo in "hwlat" into the current_tracer
363e7c15cd8SSteven Rostedt (Red Hat)	 file. Every time a latency is greater than tracing_thresh, it will
364e7c15cd8SSteven Rostedt (Red Hat)	 be recorded into the ring buffer.
365e7c15cd8SSteven Rostedt (Red Hat)
36621b3ce30SSteven Rostedt (VMware)config MMIOTRACE
36721b3ce30SSteven Rostedt (VMware)	bool "Memory mapped IO tracing"
36821b3ce30SSteven Rostedt (VMware)	depends on HAVE_MMIOTRACE_SUPPORT && PCI
36921b3ce30SSteven Rostedt (VMware)	select GENERIC_TRACER
37021b3ce30SSteven Rostedt (VMware)	help
37121b3ce30SSteven Rostedt (VMware)	  Mmiotrace traces Memory Mapped I/O access and is meant for
37221b3ce30SSteven Rostedt (VMware)	  debugging and reverse engineering. It is called from the ioremap
37321b3ce30SSteven Rostedt (VMware)	  implementation and works via page faults. Tracing is disabled by
37421b3ce30SSteven Rostedt (VMware)	  default and can be enabled at run-time.
37521b3ce30SSteven Rostedt (VMware)
37621b3ce30SSteven Rostedt (VMware)	  See Documentation/trace/mmiotrace.rst.
37721b3ce30SSteven Rostedt (VMware)	  If you are not helping to develop drivers, say N.
37821b3ce30SSteven Rostedt (VMware)
379897f17a6SSteven Rostedtconfig ENABLE_DEFAULT_TRACERS
380897f17a6SSteven Rostedt	bool "Trace process context switches and events"
3815e0a0939SSteven Rostedt	depends on !GENERIC_TRACER
382b77e38aaSSteven Rostedt	select TRACING
383b77e38aaSSteven Rostedt	help
38440892367SRandy Dunlap	  This tracer hooks to various trace points in the kernel,
385b77e38aaSSteven Rostedt	  allowing the user to pick and choose which trace point they
386897f17a6SSteven Rostedt	  want to trace. It also includes the sched_switch tracer plugin.
387a7abe97fSSteven Rostedt
388ee08c6ecSFrederic Weisbeckerconfig FTRACE_SYSCALLS
389ee08c6ecSFrederic Weisbecker	bool "Trace syscalls"
39066700001SJosh Stone	depends on HAVE_SYSCALL_TRACEPOINTS
3915e0a0939SSteven Rostedt	select GENERIC_TRACER
3920ea1c415SFrederic Weisbecker	select KALLSYMS
393ee08c6ecSFrederic Weisbecker	help
394ee08c6ecSFrederic Weisbecker	  Basic tracer to catch the syscall entry and exit events.
395ee08c6ecSFrederic Weisbecker
396debdd57fSHiraku Toyookaconfig TRACER_SNAPSHOT
397debdd57fSHiraku Toyooka	bool "Create a snapshot trace buffer"
398debdd57fSHiraku Toyooka	select TRACER_MAX_TRACE
399debdd57fSHiraku Toyooka	help
400debdd57fSHiraku Toyooka	  Allow tracing users to take snapshot of the current buffer using the
401debdd57fSHiraku Toyooka	  ftrace interface, e.g.:
402debdd57fSHiraku Toyooka
403debdd57fSHiraku Toyooka	      echo 1 > /sys/kernel/debug/tracing/snapshot
404debdd57fSHiraku Toyooka	      cat snapshot
405debdd57fSHiraku Toyooka
4060b85ffc2SSteven Rostedt (Red Hat)config TRACER_SNAPSHOT_PER_CPU_SWAP
4070b85ffc2SSteven Rostedt (Red Hat)	bool "Allow snapshot to swap per CPU"
4080b85ffc2SSteven Rostedt (Red Hat)	depends on TRACER_SNAPSHOT
4090b85ffc2SSteven Rostedt (Red Hat)	select RING_BUFFER_ALLOW_SWAP
4100b85ffc2SSteven Rostedt (Red Hat)	help
4110b85ffc2SSteven Rostedt (Red Hat)	  Allow doing a snapshot of a single CPU buffer instead of a
4120b85ffc2SSteven Rostedt (Red Hat)	  full swap (all buffers). If this is set, then the following is
4130b85ffc2SSteven Rostedt (Red Hat)	  allowed:
4140b85ffc2SSteven Rostedt (Red Hat)
4150b85ffc2SSteven Rostedt (Red Hat)	      echo 1 > /sys/kernel/debug/tracing/per_cpu/cpu2/snapshot
4160b85ffc2SSteven Rostedt (Red Hat)
4170b85ffc2SSteven Rostedt (Red Hat)	  After which, only the tracing buffer for CPU 2 was swapped with
4180b85ffc2SSteven Rostedt (Red Hat)	  the main tracing buffer, and the other CPU buffers remain the same.
4190b85ffc2SSteven Rostedt (Red Hat)
4200b85ffc2SSteven Rostedt (Red Hat)	  When this is enabled, this adds a little more overhead to the
4210b85ffc2SSteven Rostedt (Red Hat)	  trace recording, as it needs to add some checks to synchronize
4220b85ffc2SSteven Rostedt (Red Hat)	  recording with swaps. But this does not affect the performance
4230b85ffc2SSteven Rostedt (Red Hat)	  of the overall system. This is enabled by default when the preempt
4240b85ffc2SSteven Rostedt (Red Hat)	  or irq latency tracers are enabled, as those need to swap as well
4250b85ffc2SSteven Rostedt (Red Hat)	  and already adds the overhead (plus a lot more).
4260b85ffc2SSteven Rostedt (Red Hat)
4272ed84eebSSteven Rostedtconfig TRACE_BRANCH_PROFILING
4289ae5b879SSteven Rostedt	bool
4295e0a0939SSteven Rostedt	select GENERIC_TRACER
4309ae5b879SSteven Rostedt
4319ae5b879SSteven Rostedtchoice
4329ae5b879SSteven Rostedt	prompt "Branch Profiling"
4339ae5b879SSteven Rostedt	default BRANCH_PROFILE_NONE
4349ae5b879SSteven Rostedt	help
4359ae5b879SSteven Rostedt	 The branch profiling is a software profiler. It will add hooks
4369ae5b879SSteven Rostedt	 into the C conditionals to test which path a branch takes.
4379ae5b879SSteven Rostedt
4389ae5b879SSteven Rostedt	 The likely/unlikely profiler only looks at the conditions that
4399ae5b879SSteven Rostedt	 are annotated with a likely or unlikely macro.
4409ae5b879SSteven Rostedt
44140892367SRandy Dunlap	 The "all branch" profiler will profile every if-statement in the
4429ae5b879SSteven Rostedt	 kernel. This profiler will also enable the likely/unlikely
44340892367SRandy Dunlap	 profiler.
4449ae5b879SSteven Rostedt
44540892367SRandy Dunlap	 Either of the above profilers adds a bit of overhead to the system.
44640892367SRandy Dunlap	 If unsure, choose "No branch profiling".
4479ae5b879SSteven Rostedt
4489ae5b879SSteven Rostedtconfig BRANCH_PROFILE_NONE
4499ae5b879SSteven Rostedt	bool "No branch profiling"
4509ae5b879SSteven Rostedt	help
4519ae5b879SSteven Rostedt	  No branch profiling. Branch profiling adds a bit of overhead.
4529ae5b879SSteven Rostedt	  Only enable it if you want to analyse the branching behavior.
4539ae5b879SSteven Rostedt	  Otherwise keep it disabled.
4549ae5b879SSteven Rostedt
4559ae5b879SSteven Rostedtconfig PROFILE_ANNOTATED_BRANCHES
4569ae5b879SSteven Rostedt	bool "Trace likely/unlikely profiler"
4579ae5b879SSteven Rostedt	select TRACE_BRANCH_PROFILING
4581f0d69a9SSteven Rostedt	help
45959bf8964SMasanari Iida	  This tracer profiles all likely and unlikely macros
4601f0d69a9SSteven Rostedt	  in the kernel. It will display the results in:
4611f0d69a9SSteven Rostedt
46213e5befaSDavid Rientjes	  /sys/kernel/debug/tracing/trace_stat/branch_annotated
4631f0d69a9SSteven Rostedt
46440892367SRandy Dunlap	  Note: this will add a significant overhead; only turn this
4651f0d69a9SSteven Rostedt	  on if you need to profile the system's use of these macros.
4661f0d69a9SSteven Rostedt
4672bcd521aSSteven Rostedtconfig PROFILE_ALL_BRANCHES
46868e76e03SRandy Dunlap	bool "Profile all if conditionals" if !FORTIFY_SOURCE
4699ae5b879SSteven Rostedt	select TRACE_BRANCH_PROFILING
470b303c6dfSMasahiro Yamada	imply CC_DISABLE_WARN_MAYBE_UNINITIALIZED  # avoid false positives
4712bcd521aSSteven Rostedt	help
4722bcd521aSSteven Rostedt	  This tracer profiles all branch conditions. Every if ()
4732bcd521aSSteven Rostedt	  taken in the kernel is recorded whether it hit or miss.
4742bcd521aSSteven Rostedt	  The results will be displayed in:
4752bcd521aSSteven Rostedt
47613e5befaSDavid Rientjes	  /sys/kernel/debug/tracing/trace_stat/branch_all
4772bcd521aSSteven Rostedt
4789ae5b879SSteven Rostedt	  This option also enables the likely/unlikely profiler.
4799ae5b879SSteven Rostedt
4802bcd521aSSteven Rostedt	  This configuration, when enabled, will impose a great overhead
4812bcd521aSSteven Rostedt	  on the system. This should only be enabled when the system
48240892367SRandy Dunlap	  is to be analyzed in much detail.
4839ae5b879SSteven Rostedtendchoice
4842bcd521aSSteven Rostedt
4852ed84eebSSteven Rostedtconfig TRACING_BRANCHES
48652f232cbSSteven Rostedt	bool
48752f232cbSSteven Rostedt	help
48852f232cbSSteven Rostedt	  Selected by tracers that will trace the likely and unlikely
48952f232cbSSteven Rostedt	  conditions. This prevents the tracers themselves from being
49052f232cbSSteven Rostedt	  profiled. Profiling the tracing infrastructure can only happen
49152f232cbSSteven Rostedt	  when the likelys and unlikelys are not being traced.
49252f232cbSSteven Rostedt
4932ed84eebSSteven Rostedtconfig BRANCH_TRACER
49452f232cbSSteven Rostedt	bool "Trace likely/unlikely instances"
4952ed84eebSSteven Rostedt	depends on TRACE_BRANCH_PROFILING
4962ed84eebSSteven Rostedt	select TRACING_BRANCHES
49752f232cbSSteven Rostedt	help
49852f232cbSSteven Rostedt	  This traces the events of likely and unlikely condition
49952f232cbSSteven Rostedt	  calls in the kernel.  The difference between this and the
50052f232cbSSteven Rostedt	  "Trace likely/unlikely profiler" is that this is not a
50152f232cbSSteven Rostedt	  histogram of the callers, but actually places the calling
50252f232cbSSteven Rostedt	  events into a running trace buffer to see when and where the
50352f232cbSSteven Rostedt	  events happened, as well as their results.
50452f232cbSSteven Rostedt
50552f232cbSSteven Rostedt	  Say N if unsure.
50652f232cbSSteven Rostedt
5072db270a8SFrederic Weisbeckerconfig BLK_DEV_IO_TRACE
50840892367SRandy Dunlap	bool "Support for tracing block IO actions"
5092db270a8SFrederic Weisbecker	depends on SYSFS
5101dfba05dSIngo Molnar	depends on BLOCK
5112db270a8SFrederic Weisbecker	select RELAY
5122db270a8SFrederic Weisbecker	select DEBUG_FS
5132db270a8SFrederic Weisbecker	select TRACEPOINTS
5145e0a0939SSteven Rostedt	select GENERIC_TRACER
5152db270a8SFrederic Weisbecker	select STACKTRACE
5162db270a8SFrederic Weisbecker	help
5172db270a8SFrederic Weisbecker	  Say Y here if you want to be able to trace the block layer actions
5182db270a8SFrederic Weisbecker	  on a given queue. Tracing allows you to see any traffic happening
5192db270a8SFrederic Weisbecker	  on a block device queue. For more information (and the userspace
5202db270a8SFrederic Weisbecker	  support tools needed), fetch the blktrace tools from:
5212db270a8SFrederic Weisbecker
5222db270a8SFrederic Weisbecker	  git://git.kernel.dk/blktrace.git
5232db270a8SFrederic Weisbecker
5242db270a8SFrederic Weisbecker	  Tracing also is possible using the ftrace interface, e.g.:
5252db270a8SFrederic Weisbecker
5262db270a8SFrederic Weisbecker	    echo 1 > /sys/block/sda/sda1/trace/enable
5272db270a8SFrederic Weisbecker	    echo blk > /sys/kernel/debug/tracing/current_tracer
5282db270a8SFrederic Weisbecker	    cat /sys/kernel/debug/tracing/trace_pipe
5292db270a8SFrederic Weisbecker
5302db270a8SFrederic Weisbecker	  If unsure, say N.
53136994e58SFrederic Weisbecker
5326b0b7551SAnton Blanchardconfig KPROBE_EVENTS
533413d37d1SMasami Hiramatsu	depends on KPROBES
534f850c30cSHeiko Carstens	depends on HAVE_REGS_AND_STACK_ACCESS_API
53577b44d1bSMasami Hiramatsu	bool "Enable kprobes-based dynamic events"
536413d37d1SMasami Hiramatsu	select TRACING
5378ab83f56SSrikar Dronamraju	select PROBE_EVENTS
5386212dd29SMasami Hiramatsu	select DYNAMIC_EVENTS
53977b44d1bSMasami Hiramatsu	default y
540413d37d1SMasami Hiramatsu	help
54140892367SRandy Dunlap	  This allows the user to add tracing events (similar to tracepoints)
54240892367SRandy Dunlap	  on the fly via the ftrace interface. See
5435fb94e9cSMauro Carvalho Chehab	  Documentation/trace/kprobetrace.rst for more details.
54477b44d1bSMasami Hiramatsu
54577b44d1bSMasami Hiramatsu	  Those events can be inserted wherever kprobes can probe, and record
54677b44d1bSMasami Hiramatsu	  various register and memory values.
54777b44d1bSMasami Hiramatsu
54840892367SRandy Dunlap	  This option is also required by perf-probe subcommand of perf tools.
54940892367SRandy Dunlap	  If you want to use perf tools, this option is strongly recommended.
550413d37d1SMasami Hiramatsu
55145408c4fSMasami Hiramatsuconfig KPROBE_EVENTS_ON_NOTRACE
55245408c4fSMasami Hiramatsu	bool "Do NOT protect notrace function from kprobe events"
55345408c4fSMasami Hiramatsu	depends on KPROBE_EVENTS
55445408c4fSMasami Hiramatsu	depends on KPROBES_ON_FTRACE
55545408c4fSMasami Hiramatsu	default n
55645408c4fSMasami Hiramatsu	help
55745408c4fSMasami Hiramatsu	  This is only for the developers who want to debug ftrace itself
55845408c4fSMasami Hiramatsu	  using kprobe events.
55945408c4fSMasami Hiramatsu
56045408c4fSMasami Hiramatsu	  If kprobes can use ftrace instead of breakpoint, ftrace related
56145408c4fSMasami Hiramatsu	  functions are protected from kprobe-events to prevent an infinit
56245408c4fSMasami Hiramatsu	  recursion or any unexpected execution path which leads to a kernel
56345408c4fSMasami Hiramatsu	  crash.
56445408c4fSMasami Hiramatsu
56545408c4fSMasami Hiramatsu	  This option disables such protection and allows you to put kprobe
56645408c4fSMasami Hiramatsu	  events on ftrace functions for debugging ftrace by itself.
56745408c4fSMasami Hiramatsu	  Note that this might let you shoot yourself in the foot.
56845408c4fSMasami Hiramatsu
56945408c4fSMasami Hiramatsu	  If unsure, say N.
57045408c4fSMasami Hiramatsu
5716b0b7551SAnton Blanchardconfig UPROBE_EVENTS
572f3f096cfSSrikar Dronamraju	bool "Enable uprobes-based dynamic events"
573f3f096cfSSrikar Dronamraju	depends on ARCH_SUPPORTS_UPROBES
574f3f096cfSSrikar Dronamraju	depends on MMU
57509294e31SDavid A. Long	depends on PERF_EVENTS
576f3f096cfSSrikar Dronamraju	select UPROBES
577f3f096cfSSrikar Dronamraju	select PROBE_EVENTS
5780597c49cSMasami Hiramatsu	select DYNAMIC_EVENTS
579f3f096cfSSrikar Dronamraju	select TRACING
58061f35d75SArnaldo Carvalho de Melo	default y
581f3f096cfSSrikar Dronamraju	help
582f3f096cfSSrikar Dronamraju	  This allows the user to add tracing events on top of userspace
583f3f096cfSSrikar Dronamraju	  dynamic events (similar to tracepoints) on the fly via the trace
584f3f096cfSSrikar Dronamraju	  events interface. Those events can be inserted wherever uprobes
585f3f096cfSSrikar Dronamraju	  can probe, and record various registers.
586f3f096cfSSrikar Dronamraju	  This option is required if you plan to use perf-probe subcommand
587f3f096cfSSrikar Dronamraju	  of perf tools on user space applications.
588f3f096cfSSrikar Dronamraju
589e1abf2ccSIngo Molnarconfig BPF_EVENTS
590e1abf2ccSIngo Molnar	depends on BPF_SYSCALL
5916b0b7551SAnton Blanchard	depends on (KPROBE_EVENTS || UPROBE_EVENTS) && PERF_EVENTS
592e1abf2ccSIngo Molnar	bool
593e1abf2ccSIngo Molnar	default y
594e1abf2ccSIngo Molnar	help
5955cbd22c1SPeter Wu	  This allows the user to attach BPF programs to kprobe, uprobe, and
5965cbd22c1SPeter Wu	  tracepoint events.
597e1abf2ccSIngo Molnar
5985448d44cSMasami Hiramatsuconfig DYNAMIC_EVENTS
5995448d44cSMasami Hiramatsu	def_bool n
6005448d44cSMasami Hiramatsu
6018ab83f56SSrikar Dronamrajuconfig PROBE_EVENTS
6028ab83f56SSrikar Dronamraju	def_bool n
6038ab83f56SSrikar Dronamraju
6049802d865SJosef Bacikconfig BPF_KPROBE_OVERRIDE
6059802d865SJosef Bacik	bool "Enable BPF programs to override a kprobed function"
6069802d865SJosef Bacik	depends on BPF_EVENTS
607540adea3SMasami Hiramatsu	depends on FUNCTION_ERROR_INJECTION
6089802d865SJosef Bacik	default n
6099802d865SJosef Bacik	help
6109802d865SJosef Bacik	 Allows BPF to override the execution of a probed function and
6119802d865SJosef Bacik	 set a different return value.  This is used for error injection.
6129802d865SJosef Bacik
6138da3821bSSteven Rostedtconfig FTRACE_MCOUNT_RECORD
6148da3821bSSteven Rostedt	def_bool y
6158da3821bSSteven Rostedt	depends on DYNAMIC_FTRACE
6168da3821bSSteven Rostedt	depends on HAVE_FTRACE_MCOUNT_RECORD
6178da3821bSSteven Rostedt
61808d43a5fSTom Zanussiconfig TRACING_MAP
61908d43a5fSTom Zanussi	bool
62008d43a5fSTom Zanussi	depends on ARCH_HAVE_NMI_SAFE_CMPXCHG
62108d43a5fSTom Zanussi	help
62208d43a5fSTom Zanussi	  tracing_map is a special-purpose lock-free map for tracing,
62308d43a5fSTom Zanussi	  separated out as a stand-alone facility in order to allow it
62408d43a5fSTom Zanussi	  to be shared between multiple tracers.  It isn't meant to be
62508d43a5fSTom Zanussi	  generally used outside of that context, and is normally
62608d43a5fSTom Zanussi	  selected by tracers that use it.
62708d43a5fSTom Zanussi
6287ef224d1STom Zanussiconfig HIST_TRIGGERS
6297ef224d1STom Zanussi	bool "Histogram triggers"
6307ef224d1STom Zanussi	depends on ARCH_HAVE_NMI_SAFE_CMPXCHG
6317ef224d1STom Zanussi	select TRACING_MAP
6327ad8fb61STom Zanussi	select TRACING
6337bbab38dSMasami Hiramatsu	select DYNAMIC_EVENTS
6347ef224d1STom Zanussi	default n
6357ef224d1STom Zanussi	help
6367ef224d1STom Zanussi	  Hist triggers allow one or more arbitrary trace event fields
6377ef224d1STom Zanussi	  to be aggregated into hash tables and dumped to stdout by
6387ef224d1STom Zanussi	  reading a debugfs/tracefs file.  They're useful for
6397ef224d1STom Zanussi	  gathering quick and dirty (though precise) summaries of
6407ef224d1STom Zanussi	  event activity as an initial guide for further investigation
6417ef224d1STom Zanussi	  using more advanced tools.
6427ef224d1STom Zanussi
64389e270c1STom Zanussi	  Inter-event tracing of quantities such as latencies is also
64489e270c1STom Zanussi	  supported using hist triggers under this option.
64589e270c1STom Zanussi
646ea272257SMauro Carvalho Chehab	  See Documentation/trace/histogram.rst.
6477ef224d1STom Zanussi	  If in doubt, say N.
6487ef224d1STom Zanussi
6496c3edaf9SCong Wangconfig TRACE_EVENT_INJECT
6506c3edaf9SCong Wang	bool "Trace event injection"
6516c3edaf9SCong Wang	depends on TRACING
6526c3edaf9SCong Wang	help
6536c3edaf9SCong Wang	  Allow user-space to inject a specific trace event into the ring
6546c3edaf9SCong Wang	  buffer. This is mainly used for testing purpose.
6556c3edaf9SCong Wang
6566c3edaf9SCong Wang	  If unsure, say N.
6576c3edaf9SCong Wang
65881dc9f0eSSteven Rostedt (Red Hat)config TRACEPOINT_BENCHMARK
65981dc9f0eSSteven Rostedt (Red Hat)	bool "Add tracepoint that benchmarks tracepoints"
66081dc9f0eSSteven Rostedt (Red Hat)	help
66181dc9f0eSSteven Rostedt (Red Hat)	 This option creates the tracepoint "benchmark:benchmark_event".
66281dc9f0eSSteven Rostedt (Red Hat)	 When the tracepoint is enabled, it kicks off a kernel thread that
66381dc9f0eSSteven Rostedt (Red Hat)	 goes into an infinite loop (calling cond_sched() to let other tasks
66481dc9f0eSSteven Rostedt (Red Hat)	 run), and calls the tracepoint. Each iteration will record the time
66581dc9f0eSSteven Rostedt (Red Hat)	 it took to write to the tracepoint and the next iteration that
66681dc9f0eSSteven Rostedt (Red Hat)	 data will be passed to the tracepoint itself. That is, the tracepoint
66781dc9f0eSSteven Rostedt (Red Hat)	 will report the time it took to do the previous tracepoint.
66881dc9f0eSSteven Rostedt (Red Hat)	 The string written to the tracepoint is a static string of 128 bytes
66981dc9f0eSSteven Rostedt (Red Hat)	 to keep the time the same. The initial string is simply a write of
67081dc9f0eSSteven Rostedt (Red Hat)	 "START". The second string records the cold cache time of the first
67181dc9f0eSSteven Rostedt (Red Hat)	 write which is not added to the rest of the calculations.
67281dc9f0eSSteven Rostedt (Red Hat)
67381dc9f0eSSteven Rostedt (Red Hat)	 As it is a tight loop, it benchmarks as hot cache. That's fine because
67481dc9f0eSSteven Rostedt (Red Hat)	 we care most about hot paths that are probably in cache already.
67581dc9f0eSSteven Rostedt (Red Hat)
67681dc9f0eSSteven Rostedt (Red Hat)	 An example of the output:
67781dc9f0eSSteven Rostedt (Red Hat)
67881dc9f0eSSteven Rostedt (Red Hat)	      START
67981dc9f0eSSteven Rostedt (Red Hat)	      first=3672 [COLD CACHED]
68081dc9f0eSSteven Rostedt (Red Hat)	      last=632 first=3672 max=632 min=632 avg=316 std=446 std^2=199712
68181dc9f0eSSteven Rostedt (Red Hat)	      last=278 first=3672 max=632 min=278 avg=303 std=316 std^2=100337
68281dc9f0eSSteven Rostedt (Red Hat)	      last=277 first=3672 max=632 min=277 avg=296 std=258 std^2=67064
68381dc9f0eSSteven Rostedt (Red Hat)	      last=273 first=3672 max=632 min=273 avg=292 std=224 std^2=50411
68481dc9f0eSSteven Rostedt (Red Hat)	      last=273 first=3672 max=632 min=273 avg=288 std=200 std^2=40389
68581dc9f0eSSteven Rostedt (Red Hat)	      last=281 first=3672 max=632 min=273 avg=287 std=183 std^2=33666
68681dc9f0eSSteven Rostedt (Red Hat)
68781dc9f0eSSteven Rostedt (Red Hat)
6885092dbc9SSteven Rostedtconfig RING_BUFFER_BENCHMARK
6895092dbc9SSteven Rostedt	tristate "Ring buffer benchmark stress tester"
6905092dbc9SSteven Rostedt	depends on RING_BUFFER
6915092dbc9SSteven Rostedt	help
6925092dbc9SSteven Rostedt	  This option creates a test to stress the ring buffer and benchmark it.
69340892367SRandy Dunlap	  It creates its own ring buffer such that it will not interfere with
6945092dbc9SSteven Rostedt	  any other users of the ring buffer (such as ftrace). It then creates
6955092dbc9SSteven Rostedt	  a producer and consumer that will run for 10 seconds and sleep for
6965092dbc9SSteven Rostedt	  10 seconds. Each interval it will print out the number of events
6975092dbc9SSteven Rostedt	  it recorded and give a rough estimate of how long each iteration took.
6985092dbc9SSteven Rostedt
6995092dbc9SSteven Rostedt	  It does not disable interrupts or raise its priority, so it may be
7005092dbc9SSteven Rostedt	  affected by processes that are running.
7015092dbc9SSteven Rostedt
70240892367SRandy Dunlap	  If unsure, say N.
7035092dbc9SSteven Rostedt
7041e837945SSteven Rostedt (VMware)config TRACE_EVAL_MAP_FILE
7051e837945SSteven Rostedt (VMware)       bool "Show eval mappings for trace events"
7061e837945SSteven Rostedt (VMware)       depends on TRACING
7071e837945SSteven Rostedt (VMware)       help
7081e837945SSteven Rostedt (VMware)	The "print fmt" of the trace events will show the enum/sizeof names
7091e837945SSteven Rostedt (VMware)	instead of their values. This can cause problems for user space tools
7101e837945SSteven Rostedt (VMware)	that use this string to parse the raw data as user space does not know
7111e837945SSteven Rostedt (VMware)	how to convert the string to its value.
7121e837945SSteven Rostedt (VMware)
7131e837945SSteven Rostedt (VMware)	To fix this, there's a special macro in the kernel that can be used
7141e837945SSteven Rostedt (VMware)	to convert an enum/sizeof into its value. If this macro is used, then
7151e837945SSteven Rostedt (VMware)	the print fmt strings will be converted to their values.
7161e837945SSteven Rostedt (VMware)
7171e837945SSteven Rostedt (VMware)	If something does not get converted properly, this option can be
7181e837945SSteven Rostedt (VMware)	used to show what enums/sizeof the kernel tried to convert.
7191e837945SSteven Rostedt (VMware)
7201e837945SSteven Rostedt (VMware)	This option is for debugging the conversions. A file is created
7211e837945SSteven Rostedt (VMware)	in the tracing directory called "eval_map" that will show the
7221e837945SSteven Rostedt (VMware)	names matched with their values and what trace event system they
7231e837945SSteven Rostedt (VMware)	belong too.
7241e837945SSteven Rostedt (VMware)
7251e837945SSteven Rostedt (VMware)	Normally, the mapping of the strings to values will be freed after
7261e837945SSteven Rostedt (VMware)	boot up or module load. With this option, they will not be freed, as
7271e837945SSteven Rostedt (VMware)	they are needed for the "eval_map" file. Enabling this option will
7281e837945SSteven Rostedt (VMware)	increase the memory footprint of the running kernel.
7291e837945SSteven Rostedt (VMware)
7301e837945SSteven Rostedt (VMware)	If unsure, say N.
7311e837945SSteven Rostedt (VMware)
7321e837945SSteven Rostedt (VMware)config GCOV_PROFILE_FTRACE
7331e837945SSteven Rostedt (VMware)	bool "Enable GCOV profiling on ftrace subsystem"
7341e837945SSteven Rostedt (VMware)	depends on GCOV_KERNEL
7351e837945SSteven Rostedt (VMware)	help
7361e837945SSteven Rostedt (VMware)	  Enable GCOV profiling on ftrace subsystem for checking
7371e837945SSteven Rostedt (VMware)	  which functions/lines are tested.
7381e837945SSteven Rostedt (VMware)
7391e837945SSteven Rostedt (VMware)	  If unsure, say N.
7401e837945SSteven Rostedt (VMware)
7411e837945SSteven Rostedt (VMware)	  Note that on a kernel compiled with this config, ftrace will
7421e837945SSteven Rostedt (VMware)	  run significantly slower.
7431e837945SSteven Rostedt (VMware)
7441e837945SSteven Rostedt (VMware)config FTRACE_SELFTEST
7451e837945SSteven Rostedt (VMware)	bool
7461e837945SSteven Rostedt (VMware)
7471e837945SSteven Rostedt (VMware)config FTRACE_STARTUP_TEST
7481e837945SSteven Rostedt (VMware)	bool "Perform a startup test on ftrace"
7491e837945SSteven Rostedt (VMware)	depends on GENERIC_TRACER
7501e837945SSteven Rostedt (VMware)	select FTRACE_SELFTEST
7511e837945SSteven Rostedt (VMware)	help
7521e837945SSteven Rostedt (VMware)	  This option performs a series of startup tests on ftrace. On bootup
7531e837945SSteven Rostedt (VMware)	  a series of tests are made to verify that the tracer is
7541e837945SSteven Rostedt (VMware)	  functioning properly. It will do tests on all the configured
7551e837945SSteven Rostedt (VMware)	  tracers of ftrace.
7561e837945SSteven Rostedt (VMware)
7571e837945SSteven Rostedt (VMware)config EVENT_TRACE_STARTUP_TEST
7581e837945SSteven Rostedt (VMware)	bool "Run selftest on trace events"
7591e837945SSteven Rostedt (VMware)	depends on FTRACE_STARTUP_TEST
7601e837945SSteven Rostedt (VMware)	default y
7611e837945SSteven Rostedt (VMware)	help
7621e837945SSteven Rostedt (VMware)	  This option performs a test on all trace events in the system.
7631e837945SSteven Rostedt (VMware)	  It basically just enables each event and runs some code that
7641e837945SSteven Rostedt (VMware)	  will trigger events (not necessarily the event it enables)
7651e837945SSteven Rostedt (VMware)	  This may take some time run as there are a lot of events.
7661e837945SSteven Rostedt (VMware)
7671e837945SSteven Rostedt (VMware)config EVENT_TRACE_TEST_SYSCALLS
7681e837945SSteven Rostedt (VMware)	bool "Run selftest on syscall events"
7691e837945SSteven Rostedt (VMware)	depends on EVENT_TRACE_STARTUP_TEST
7701e837945SSteven Rostedt (VMware)	help
7711e837945SSteven Rostedt (VMware)	 This option will also enable testing every syscall event.
7721e837945SSteven Rostedt (VMware)	 It only enables the event and disables it and runs various loads
7731e837945SSteven Rostedt (VMware)	 with the event enabled. This adds a bit more time for kernel boot
7741e837945SSteven Rostedt (VMware)	 up since it runs this on every system call defined.
7751e837945SSteven Rostedt (VMware)
7761e837945SSteven Rostedt (VMware)	 TBD - enable a way to actually call the syscalls as we test their
7771e837945SSteven Rostedt (VMware)	       events
7781e837945SSteven Rostedt (VMware)
7796c43e554SSteven Rostedt (Red Hat)config RING_BUFFER_STARTUP_TEST
7806c43e554SSteven Rostedt (Red Hat)       bool "Ring buffer startup self test"
7816c43e554SSteven Rostedt (Red Hat)       depends on RING_BUFFER
7826c43e554SSteven Rostedt (Red Hat)       help
7836c43e554SSteven Rostedt (Red Hat)	 Run a simple self test on the ring buffer on boot up. Late in the
7846c43e554SSteven Rostedt (Red Hat)	 kernel boot sequence, the test will start that kicks off
7856c43e554SSteven Rostedt (Red Hat)	 a thread per cpu. Each thread will write various size events
7866c43e554SSteven Rostedt (Red Hat)	 into the ring buffer. Another thread is created to send IPIs
7876c43e554SSteven Rostedt (Red Hat)	 to each of the threads, where the IPI handler will also write
7886c43e554SSteven Rostedt (Red Hat)	 to the ring buffer, to test/stress the nesting ability.
7896c43e554SSteven Rostedt (Red Hat)	 If any anomalies are discovered, a warning will be displayed
7906c43e554SSteven Rostedt (Red Hat)	 and all ring buffers will be disabled.
7916c43e554SSteven Rostedt (Red Hat)
7926c43e554SSteven Rostedt (Red Hat)	 The test runs for 10 seconds. This will slow your boot time
7936c43e554SSteven Rostedt (Red Hat)	 by at least 10 more seconds.
7946c43e554SSteven Rostedt (Red Hat)
7956c43e554SSteven Rostedt (Red Hat)	 At the end of the test, statics and more checks are done.
7966c43e554SSteven Rostedt (Red Hat)	 It will output the stats of each per cpu buffer. What
7976c43e554SSteven Rostedt (Red Hat)	 was written, the sizes, what was read, what was lost, and
7986c43e554SSteven Rostedt (Red Hat)	 other similar details.
7996c43e554SSteven Rostedt (Red Hat)
8006c43e554SSteven Rostedt (Red Hat)	 If unsure, say N
8016c43e554SSteven Rostedt (Red Hat)
802a48fc4f5SSteven Rostedt (VMware)config MMIOTRACE_TEST
803a48fc4f5SSteven Rostedt (VMware)	tristate "Test module for mmiotrace"
804a48fc4f5SSteven Rostedt (VMware)	depends on MMIOTRACE && m
805a48fc4f5SSteven Rostedt (VMware)	help
806a48fc4f5SSteven Rostedt (VMware)	  This is a dumb module for testing mmiotrace. It is very dangerous
807a48fc4f5SSteven Rostedt (VMware)	  as it will write garbage to IO memory starting at a given address.
808a48fc4f5SSteven Rostedt (VMware)	  However, it should be safe to use on e.g. unused portion of VRAM.
809a48fc4f5SSteven Rostedt (VMware)
810a48fc4f5SSteven Rostedt (VMware)	  Say N, unless you absolutely know what you are doing.
811a48fc4f5SSteven Rostedt (VMware)
812f96e8577SJoel Fernandes (Google)config PREEMPTIRQ_DELAY_TEST
813a48fc4f5SSteven Rostedt (VMware)	tristate "Test module to create a preempt / IRQ disable delay thread to test latency tracers"
814f96e8577SJoel Fernandes (Google)	depends on m
815f96e8577SJoel Fernandes (Google)	help
816f96e8577SJoel Fernandes (Google)	  Select this option to build a test module that can help test latency
817f96e8577SJoel Fernandes (Google)	  tracers by executing a preempt or irq disable section with a user
818f96e8577SJoel Fernandes (Google)	  configurable delay. The module busy waits for the duration of the
819f96e8577SJoel Fernandes (Google)	  critical section.
820f96e8577SJoel Fernandes (Google)
82179393723SViktor Rosendahl (BMW)	  For example, the following invocation generates a burst of three
82279393723SViktor Rosendahl (BMW)	  irq-disabled critical sections for 500us:
82379393723SViktor Rosendahl (BMW)	  modprobe preemptirq_delay_test test_mode=irq delay=500 burst_size=3
824f96e8577SJoel Fernandes (Google)
825f96e8577SJoel Fernandes (Google)	  If unsure, say N
826f96e8577SJoel Fernandes (Google)
8279fe41efaSTom Zanussiconfig SYNTH_EVENT_GEN_TEST
8289fe41efaSTom Zanussi	tristate "Test module for in-kernel synthetic event generation"
8299fe41efaSTom Zanussi	depends on HIST_TRIGGERS
8309fe41efaSTom Zanussi	help
8319fe41efaSTom Zanussi          This option creates a test module to check the base
8329fe41efaSTom Zanussi          functionality of in-kernel synthetic event definition and
8339fe41efaSTom Zanussi          generation.
8349fe41efaSTom Zanussi
8359fe41efaSTom Zanussi          To test, insert the module, and then check the trace buffer
8369fe41efaSTom Zanussi	  for the generated sample events.
8379fe41efaSTom Zanussi
8389fe41efaSTom Zanussi	  If unsure, say N.
8399fe41efaSTom Zanussi
84064836248STom Zanussiconfig KPROBE_EVENT_GEN_TEST
84164836248STom Zanussi	tristate "Test module for in-kernel kprobe event generation"
84264836248STom Zanussi	depends on KPROBE_EVENTS
84364836248STom Zanussi	help
84464836248STom Zanussi          This option creates a test module to check the base
84564836248STom Zanussi          functionality of in-kernel kprobe event definition.
84664836248STom Zanussi
84764836248STom Zanussi          To test, insert the module, and then check the trace buffer
84864836248STom Zanussi	  for the generated kprobe events.
84964836248STom Zanussi
85064836248STom Zanussi	  If unsure, say N.
85164836248STom Zanussi
8524ed9f071SSteven Rostedtendif # FTRACE
85340ada30fSIngo Molnar
85440ada30fSIngo Molnarendif # TRACING_SUPPORT
85540ada30fSIngo Molnar
856