---
name: "tplist-bpfcc"
section: "8"
platform: "linux"
package: "bpfcc-tools"
version: "0.31.0+ds-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tplist-bpfcc"
---

# tplist-bpfcc(8)

Display kernel tracepoints or USDT probes and their formats.

## NAME

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

## SYNOPSIS

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

## 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

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

- \-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

- 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 provider:

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

- Print all the USDT probes in the node executable:

  $ **tplist -l node**

## SOURCE

This is from bcc.

-

  https://github.com/iovisor/bcc

## OS

Linux

## STABILITY

Unstable - in development.

## AUTHOR

Sasha Goldshtein