man(1)

📦 version 2.2.1, in debian bookworm, debian trixie, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

okay bestie, welcome to the man(1) page for eztrace.preload 💖 — a performance analysis tool. that's literally the whole vibe. it runs your program and traces it. slay.

🌸 SYNOPSIS 🌸

eztrace.preload [OPTION] COMMAND_LINE

🦋 DESCRIPTION 🦋

Run COMMAND_LINE and generate an execution trace. that's it, that's the whole job 💅 you hand it a command, it hands you back a trace of what went down. main character energy fr fr.

✨ OPTIONS ✨

  • -d — Run eztrace.old with gdb. debugging hours, but make it iconic 🐛
  • -e — Show environment. let's see what you're working with, bestie 🌈
  • -p — PadicoTM mode
  • -m — MPI mode. for when your program is running the multiverse edition 👑
  • -t [plugin1 plugin2 ... pluginN] — Select a list of plugins. pick your faves, no cap 🎀
  • -o DIRECTORY — Select the output DIRECTORY. tell it where to drop the goods 📁
  • -l DIRECTORY — Add DIRECTORY to the list of directories in which eztrace search for plugins
  • -f — Enable EZTRACE_FLUSH
  • -? — Display this help and exit. the classic escape hatch, we love her 🙈

💜 EXAMPLES 💜

like, here's how you actually do it:

$ eztrace.preload -t "memory pthread" ./my_program param1 param2

For MPI programs:

$ mpirun -np 2 `eztrace.preload -m ./my_program` param1 param2

periodt. 💅

🌟 SEE ALSO 🌟

eztrace(1), eztrace_cc(1), eztrace_avail(1) — go read those too, they're part of the friend group 🫶

💀 BUGS 💀

ngl, here's the tea: eztrace.preload is a fallback launcher for eztrace. It relies on LD_PRELOAD for interception function calls. Thus, it only works for shared libraries. so if your thing isn't a shared library... it's giving nothing, bestie 😭

📢 REPORTING BUGS 📢

found a bug? don't gatekeep, report eztrace bugs to https://gitlab.com/eztrace/eztrace

EZTrace home page: https://eztrace.gitlab.io/eztrace

👑 AUTHOR 👑

Francois Trahay (francois.trahay@telecom-sudparis.eu) — the icon who made all this happen ⭐

okay that's the whole page, you're all caught up 🧚 version 2.0, dated 13 january 2022, straight from the man(1) manual section. go trace something gorgeous. bye bestie!! 💖✨🎀

📦 where this page comes from