tracing: Add hist_debug trace event files for histogram debugging
authorTom Zanussi <zanussi@kernel.org>
Fri, 3 Apr 2020 19:31:21 +0000 (14:31 -0500)
committerSteven Rostedt (VMware) <rostedt@goodmis.org>
Mon, 1 Jun 2020 12:22:30 +0000 (08:22 -0400)
commit2d19bd79ae6509858582a9cade739c2e9a4fdca8
tree7612f1c6d4821e70b8b69d91a0608ae68c4d3413
parent16b585fe71924b3aebaef5548a291021efaf7c7f
tracing: Add hist_debug trace event files for histogram debugging

Add a new "hist_debug" file for each trace event, which when read will
dump out a bunch of internal details about the hist triggers defined
on that event.

This is normally off but can be enabled by saying 'y' to the new
CONFIG_HIST_TRIGGERS_DEBUG config option.

This is in support of the new Documentation file describing histogram
internals, Documentation/trace/histogram-design.rst, which was
requested by developers trying to understand the internals when
extending or making use of the hist triggers for higher-level tools.

The histogram-design.rst documentation refers to the hist_debug files
and demonstrates their use with output in the test examples.

Link: http://lkml.kernel.org/r/77914c22b0ba493d9783c53bbfbc6087d6a7e1b1.1585941485.git.zanussi@kernel.org
Signed-off-by: Tom Zanussi <zanussi@kernel.org>
Signed-off-by: Steven Rostedt (VMware) <rostedt@goodmis.org>
kernel/trace/Kconfig
kernel/trace/trace.h
kernel/trace/trace_events.c
kernel/trace/trace_events_hist.c