tplist - Display kernel tracepoints or USDT probes and their formats.
tplist [-p PID] [-l LIB] [-v] [filter]
tplist lists all kernel tracepoints, and can optionally print out the tracepoint
format; namely, the variables that you can trace when the tracepoint is hit.
tplist can also list USDT probes embedded in a specific library or executable,
and can list USDT probes for all the libraries loaded by a specific process.
These features are usually used in conjunction with the argdist and/or trace
On a typical system, accessing the tracepoint list and format requires root.
However, accessing USDT probes does not require root.
- -p PID
- Display the USDT probes from all the libraries loaded by
the specified process.
- -l LIB
- Display the USDT probes from the specified library or
executable. If the librar or executable can be found in the standard
paths, a full path is not required.
- Increase the verbosity level. Can be used to display the
variables, locations, and arguments of tracepoints and USDT probes.
- A wildcard expression that specifies which tracepoints or
probes to print. For example, block:* will print all block tracepoints
(block:block_rq_complete, etc.). Regular expressions are not
- Print all kernel tracepoints:
- # tplist
- Print all net tracepoints with their format:
- # tplist -v 'net:*'
- Print all USDT probes in libpthread:
- $ tplist -l pthread
- Print all USDT probes in process 4717 from the libc
- $ tplist -p 4717 'libc:*'
- Print all the USDT probes in the node executable:
- $ tplist -l node
This is from bcc.
Unstable - in development.