OTFAUX(1)

💖 NAME 💖

otfaux — appends snapshots and statistics to an OTF trace, no cap 🫶

---

✨ DESCRIPTION ✨

hii bestie so listen 👑 otfaux takes an OTF trace that already exists and appends snapshots and statistics to it, at whatever 'break' time stamps you tell it to. that's the whole main character energy of this tool, periodt.

here's the syntax, copy it exactly pls:

otfaux [options] <input file name>

🎀 options 🎀

• -h, --help — shows you this help message. the classic cry for help, but make it helpful 💅
• -V — shows the OTF version. vibe check on your install ✨
• -b <size> — buffer size for read and write operations. bigger buffer, bigger slay.
• -n <n> — number of breaks, distributed regularly. so here's the tea: if -p and -t are not set, the default for -n is 200 breaks. two hundred. iconic.
• -p <p> — creates a break every p ticks. and if both -n and -p are specified? the one producing more breaks wins. it's giving competitive, honestly 😭
• -t <t> — defines an (additional) break at the given time stamp. yes, additional — you can stack these 🍓
• -F — force overwrite old snapshots and statistics. no take-backsies, it's literally overwriting, be careful bestie 💀
• -R — delete existing snapshots and statistics only. just the deletion, nothing new added.
• -f <n> — max number of filehandles output.
• --funcgroups — creates functiongroup summaries instead of function summaries. group chat but for functions ✨
• --filegroups — creates file group summaries instead of file summaries.
• -v — verbose mode, it prints the break time stamps. she's talkative and we love that for her 🗣️
• -a — shows advancing progress while it's operating. a lil progress moment 🦋
• -o <namestub> — makes a copy of the input trace. it does not touch the original, she's gentle like that.
• --thumbnail-procs <n> — upper bound for the number of processes in the thumbnail.
• --thumbnail-samples <n> — upper bound for the number of sampling points in the thumbnail.
• --inline-snapshots — produces inline snapshots. ⚠️ requires the -o option, so don't come for me when it yells at you.
• --match-messages — attaches receive time information to send events. also ⚠️ requires the -o option. bestie, read the fine print 🙈
• --snapshots — writes snapshots and a thumbnail but NO statistics. this is the default mode, fyi. iykyk.
• --thumbnail — writes ONLY a thumbnail. that's it. that's the whole job.
• --statistics — writes ONLY statistics but NO snapshots or a thumbnail.
• --all — writes snapshots, a thumbnail, and statistics. the full set, the whole wardrobe, ate 💅
• -s a[,b]* — regards the given streams only when computing statistics. it expects a single token or a comma separated list. and heads up: this implies the --statistics option! so you don't gotta say it twice, it's already invited.
• -l — lists the existing stream tokens. shopping for stream tokens? start here 🛍️

ok real talk for a sec: -F will force overwrite your old snapshots and statistics, so make sure that's actually what you want before you send it, queen. 🙏

---

that's the whole page, bestie!! you just read otfaux from otfaux 1.12.5, dated February 2026 — go forth and append those snapshots, you absolute legend 💜✨🌸