trace-cmd-list1
List available plugins, events or options for ftrace.
Usage
trace-cmd list
[OPTIONS]
Overview
The trace-cmd(1) list displays the available plugins, events or Ftrace options that are configured on the current machine. If no option is given, then it lists all plugins, event systems, events and Ftrace options to standard output.
Options
-
-e [regex] -
This option will list the available events that are enabled on the local system.
It takes an optional argument that uses 'regcomp(3)' expressions to seach.
trace-cmd list -e '^sys.*'
-
-F -
Used with
-eregex to show the fields of the event.
-
--full -
Used with
-Fwhich will show the "print fmt" of the event along with the fields.
-
-l -
Used with
-eregex to show those events filters.
-
-R -
Used with
-eregex to show those events triggers.
-
-s -
This option will list the available event systems.
-
-t -
This option will list the available tracers that are enabled on the local system.
-
-p -
Same as
-tand only for legacy purposes.
-
-o -
This option will list the available Ftrace options that are configured on the local system.
-
-f [regex] -
This option will list the available filter functions. These are the list of functions on the system that you can trace, or filter on. It takes an optional argument that uses regcomp(3) expressions to seach.
trace-cmd list -f '^sched.*'
If *--proto* is also added to the command line, the functions will also have show their prototypes if BTF is available.
-
--proto -
If BTF is available on the running kernel, it will also show the function parameters with
-f.
-
-P -
List the plugin files that get loaded on trace-cmd report.
-
-O -
List plugin options that can be used by trace-cmd report
-Ooption.
-
-B -
List defined buffer instances (sub buffers).
-
-C -
List defined clocks that can be used with trace-cmd record -C. The one in brackets ([]) is the active clock.
-
-c -
List the available trace file compression algorithms.
Resources
https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
Copying
Copyright (C) 2010 Red Hat, Inc. Free use of this software is granted under the terms of the GNU Public License (GPL).
Notes
- 1.
-
mailto:[email protected]
Releases
7 releases since Debian 8 (Jessie); the text changed 6 times.
--full since Debian 12 (Bookworm);
--proto since Arch Linux 2026-11-01;
-C since Debian 9 (Stretch);
-c since Debian 12 (Bookworm);
-s since Debian 11 (Bullseye).