tplist(8)

💖 NAME 💖

tplist — display kernel tracepoints or USDT probes and their formats. fr fr, this is the tplist(8) page from the System Manager's Manual, and it’s giving “let me show you every tracepoint/probe vibe” energy ✨

🦋 SYNOPSIS 🦋

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

💅 DESCRIPTION 💅

okay so tplist lists all kernel tracepoints, and it can optionally print out the tracepoint format too — namely, the variables that you can trace when the tracepoint is hit. iconic behavior, honestly.

tplist can also list USDT probes embedded in a specific library or executable, and it 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. iykyk 🫶

root check, bestie 👑: 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 (yes, literally that spelling in the original 💀) 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.

filter tea ☕: wildcard expression only, bestie. regular expressions are not supported. periodt.

🌸 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

---

okay bye bestie 💖 — this page lives in USER COMMANDS, dated 2016-03-20, and it’s the tplist(8) manual. slay and stay curious 🌈✨