diff options
| author | Thomas Weißschuh <thomas.weissschuh@linutronix.de> | 2026-09-08 08:22:21 +0200 |
|---|---|---|
| committer | Steven Rostedt <rostedt@goodmis.org> | 2026-10-15 18:23:35 -0400 |
| commit | 084100a1b579e6e08085dfc33caa4df31bb25696 (patch) | |
| tree | 212d2235c6ea320666264a02f627625dcf1b195a /Documentation | |
| parent | d30778dee467f2a54759f90b29019f5aec69abd3 (diff) | |
tracing: Parse filter from boot event string
Make it possible to specify a trace event filter from the
kernel command line.
Example:
trace_event=syscalls:sys_enter_clock_nanosleep:filter:which_clock==0
Link: https://patch.msgid.link/20260908-tracing-cli-event-filter-v2-7-05396a3fb663@linutronix.de
Signed-off-by: Thomas Weißschuh <thomas.weissschuh@linutronix.de>
Signed-off-by: Steven Rostedt <rostedt@goodmis.org>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/admin-guide/kernel-parameters.txt | 9 | ||||
| -rw-r--r-- | Documentation/trace/events.rst | 5 |
2 files changed, 12 insertions, 2 deletions
diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt index e75344f4e0cd..524cad368767 100644 --- a/Documentation/admin-guide/kernel-parameters.txt +++ b/Documentation/admin-guide/kernel-parameters.txt @@ -7733,8 +7733,13 @@ Kernel parameters trace_event=:mod:<module> The value before :mod: will only enable specific events - that are part of the module. See the above mentioned - document for more information. + that are part of the module. + + To apply a filter, use the :filter: keyword: + + trace_event=...:filter:<filter> + + See the above mentioned document for more information. trace_instance=[instance-info] [FTRACE] Create a ring buffer instance early in boot up. diff --git a/Documentation/trace/events.rst b/Documentation/trace/events.rst index a1a219208ecc..88a9099f1688 100644 --- a/Documentation/trace/events.rst +++ b/Documentation/trace/events.rst @@ -118,6 +118,11 @@ In order to facilitate early boot debugging, use boot option:: event-list is a comma separated list of events. See section 2.1 for event format. +The boot option also supports the ``:filter:`` keyword to apply a filter. +The ``:filter:`` keyword needs to be at the end of the event specification:: + + <system>:<event>:mod:<module>:filter:<filter> + 3. Defining an event-enabled tracepoint ======================================= |