tplist(8)

📦 version 0.35.0, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 tplist(8) 💖

System Manager's Manual 🌸

✨ NAME ✨

okay so tplist is the tool that lists kernel tracepoints or USDT probes, and it can show their formats too 🦋

🎀 SYNOPSIS 🎀

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

💅 DESCRIPTION 💅

okay so tplist lists all the kernel tracepoints, and if you ask nicely it'll also print each tracepoint's format 🧚 that's the list of variables you can grab whenever the tracepoint gets hit. it can also list USDT probes baked into a specific library or executable, and it can list the USDT probes for every library a specific process has loaded 🔥 these features are usually used together with the argdist and/or trace tools, so they're basically a team 🫶

ngl this is giving main character energy: on a typical system, reading the tracepoint list and format needs root 👑 but USDT probes? no root needed, bestie 💜

🌈 OPTIONS 🌈

  • -p PID — shows the USDT probes from every library that the process with that PID has loaded 🦋
  • -l LIB — shows the USDT probes from the library or executable you name 💖 if it lives in one of the standard paths, you don't need to type the full path, so lowkey easy 🌸
  • -v — turns the verbosity up a notch ✨ this is how you see the variables, locations, and arguments for tracepoints and USDT probes 👀
  • [filter] — a wildcard expression that picks which tracepoints or probes get printed 🎀 for example, block:* prints all the block tracepoints (like block:block_rq_complete, etc.) 🍓 heads up though: regular expressions are not supported, so no fancy regex era here 🙅‍♀️

🧚 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 one is from bcc, iykyk 💀

https://github.com/iovisor/bcc

🌸 OS 🌸

Linux 🐧

🙈 STABILITY 🙈

Unstable - in development. it's still cooking, so expect some changes 🍳

💜 AUTHOR 💜

Sasha Goldshtein 🫶

okay bestie, that's the whole tea ☕✨ this page is from the USER COMMANDS section, it was last updated on 2016-03-20, and it's all about tplist(8) 🦋💅 periodt 🌈

📦 where this page comes from