tplist(8) System Manager's Manual tplist(8)

# [NAME](#NAME)

tplist - Display kernel tracepoints or USDT probes and their formats.

# [SYNOPSIS](#SYNOPSIS)

**tplist \[-p PID] \[-l LIB] \[-v] \[filter]**

# [DESCRIPTION](#DESCRIPTION)

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 tools.

On a typical system, accessing the tracepoint list and format requires root. However, accessing USDT probes does not require root.

# [OPTIONS](#OPTIONS)

[-p PID](#p)

Display the USDT probes from all the libraries loaded by the specified process.

[-l LIB](#l)

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.

[-v](#v)

Increase the verbosity level. Can be used to display the variables, locations, and arguments of tracepoints and USDT probes.

\[filter]

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 supported.

# [EXAMPLES](#EXAMPLES)

[Print all kernel tracepoints:](#Print)

\# **tplist**

[Print all net tracepoints with their format:](#Print~2)

\# **tplist -v 'net:\*'**

[Print all USDT probes in libpthread:](#Print~3)

$ **tplist -l pthread**

[Print all USDT probes in process 4717 from the libc provider:](#Print~4)

$ **tplist -p 4717 'libc:\*'**

[Print all the USDT probes in the node executable:](#Print~5)

$ **tplist -l node**

# [SOURCE](#SOURCE)

This is from bcc.

https://github.com/iovisor/bcc

# [OS](#OS)

Linux

# [STABILITY](#STABILITY)

Unstable - in development.

# [AUTHOR](#AUTHOR)

Sasha Goldshtein

2016-03-20 USER COMMANDS

---

Document: tplist(8) from bcc 0.37.0-r3 (Chainguard OS)
Source: https://github.com/iovisor/bcc