man(1)

📦 version 1.1-11, in ubuntu jammy

✨ NAME ✨

okay so bestie, this is eztrace_convert from the eztrace_convert man page (that's man(1), section 1, we love her) — and she's here to create PAJE/OTF traces 💖

🌸 SYNOPSIS 🌸

eztrace_convert [OPTIONS] INPUT_FILES

🦋 DESCRIPTION 🦋

So basically: you point her at the INPUT_FILES that were made by the eztrace command (or by eztrace.old, she doesn't judge, both are valid 💅) and she browses through them and creates PAJE or OTF trace files for you.

That's the whole gig. She takes the raw logs and turns them into something you can actually look at. Iconic behaviour, no cap. ✨

💅 OPTIONS 💅

  • -v — turns on verbose mode, aka she tells you what she's doing instead of being mysterious about it 🫶
  • -t TRACE_FORMAT — you pick the output trace format here. The formats on the menu are PAJE and OTF. And if you say nothing at all? Default is PAJE. periodt 🎀
  • -z — enables trace compression. smaller files, we love to see it.
  • -o OUTPUT_FILENAME — saves the output trace as OUTPUT_FILENAME. And if you don't specify one, she defaults to eztrace_output.trace. she's got you. 💜
  • -h — displays this help and exits. your classic "wait what were the flags again" move 🙈

🍓 EXAMPLES 🍓

bestie here's the whole flow, look:

$ eztrace -t pthread ./application
Starting EZTrace... done
[...]
Stopping EZTrace... saving trace  /tmp/user_eztrace_log_rank_1
$ eztrace_convert /tmp/user_eztrace_log_rank_1

see how the first one runs the thing with -t pthread and dumps a trace at /tmp/user_eztrace_log_rank_1, and then eztrace_convert just eats that path for breakfast? chef's kiss. 🔥

🧚 SEE ALSO 🧚

go bother these girls next, they're all in the same friend group:

💀 REPORTING BUGS 💀

found a bug? not me being the one to find a bug 😭 okay so report those eztrace bugs to eztrace-devel@lists.gforge.inria.fr

and the EZTrace home page lives at http://eztrace.gforge.inria.fr/ — go say hi 🫶

👑 AUTHOR 👑

Francois Trahay (francois.trahay@telecom-sduparis.eu) — the main character who wrote this. bow down. 💅

✨ and that's the whole page, bestie! this was version 1.0, dated 05 September 2013, living in section man(1) of the manual. slay, go convert some traces 💖🦋🌈
📦 where this page comes from