man(1)

📦 version 1.1-11, in ubuntu jammy

✨ eztrace.old — the manual page, bestie edition ✨

okay so this is the manual for eztrace.old, straight out of the eztrace.old man page (yes that's the manual name, we're keeping it cute but we're keeping it). it's a performance analysis tool and honestly? iconic. let's get into it 🫶

💖 NAME 💖

eztrace.old — a performance analysis tool. that's the whole vibe. it analyzes performance. it's a tool. slay.

🌸 SYNOPSIS 🌸

eztrace [OPTION] COMMAND_LINE

so you give it some options, then you give it a COMMAND_LINE, and it does its thing. that's the shape of it, no cap.

🦋 DESCRIPTION 🦋

Run COMMAND_LINE and generate an execution trace.

that's it. that's the whole deal. you hand it a command, it runs that command, and it makes a trace of what went down while it ran. lowkey the most useful thing ever when you're trying to figure out why your program is being weird. ✨

💅 OPTIONS 💅

okay bestie here's the full menu, every single one, no skips:

  • -d — Run eztrace.old with gdb. debugger mode activated, we're going in with the magnifying glass 🔍
  • -e — Show environment. it spills the environment, all of it.
  • -p — PadicoTM mode. yes, PadicoTM. that's the mode. 🎀
  • -m — MPI mode. for when you're doing the whole parallel MPI thing, main character energy.
  • -t [plugin1 plugin2 ... pluginN] — Select a list of plugins. you pick which plugins you want, and you list them all out. as many as you want, up to pluginN. the list is the moment. 👑
  • -o DIRECTORY — Select the output DIRECTORY. this is where the trace goes. pick a good one, don't just dump it in your home dir like a gremlin 🙈
  • -l DIRECTORY — Add DIRECTORY to the list of directories in which eztrace searches for plugins. basically "hey, also look here for plugins". more places = more plugins found, iykyk.
  • -f — Enable EZTRACE_FLUSH. flush enabled. periodt.
  • -? — Display this help and exit. the "help me bestie" button. press it, read it, leave. 💖

🌈 EXAMPLES 🌈

okay these are the real ones, verbatim, don't @ me:

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

and for the MPI girlies:

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

see how it's nested in there with the backticks? that's the move. that's the whole move. 🔥

⭐ SEE ALSO ⭐

go read these too, they're the friend group:

eztrace(1), eztrace_convert(1), eztrace_stats(1), eztrace_cc(1), eztrace_avail(1), eztrace_loaded(1), eztrace_create_plugin(1)

💀 BUGS 💀

okay this part is important, listen up:

eztrace.old is a fallback launcher for eztrace. It relies on LD_PRELOAD for interception function calls.

Thus, it only works for shared libraries.

like. only shared libraries. if you're on static libraries this is not going to work for you and that's not a vibe, that's just the truth. 😭

🍓 REPORTING BUGS 🍓

found a bug? don't suffer in silence, tell the devs:

Report eztrace bugs to eztrace-devel@lists.gforge.inria.fr

EZTrace home page: <http://eztrace.gforge.inria.fr/>

they want to hear from you fr fr. 🫶

💜 AUTHOR 💜

Francois Trahay (francois.trahay@telecom-sduparis.eu)

put some respect on the name, they built this. 🧚

and that's the page bestie!! this was version 1.0, dated 05 September 2013, and it lives in section man(1). yes, 2013, we're honoring the elders. mwah. 💅✨

📦 where this page comes from