FSTMINER(1)

👑 fstminer — okay bestie, let's go mining 💎

So like, this is fstminer from the Dumpfile Data Mining corner of the manual-verse, and its NAME section literally calls it fst2miner — yes, two different names, iconic behavior, we don't question it, we just vibe. Its whole deal: data mining of FST files. 🦋

✨ SYNTAX ✨

fstminer [option]... [FSTFILE]

That's it. That's the whole shape of it. Options, then maybe a file. 🎀

🌸 DESCRIPTION 🌸

Okay so here's the tea: fstminer mines FST files for specific data values 🔥 and then it generates gtkwave save files straight to stdout, so you can reload all that goodness later. It's giving "find the thing, write the receipt, come back to it whenever." 💅

🎀 OPTIONS 🎀

• -d, --dumpfile <filename> — bestie, this is where you tell it which FST input dumpfile to read. 📂
• -m, --match <value> — here's where you drop the "bitwise" match data you want to hunt for. And when we say data, we mean it: binary, real, or string, all welcome. 🔍
• -x, --hex <value> — same energy as --match but you're handing it hexadecimal match data, which it will auto-convert to binary for the search. No manual conversion labor required, we love a self-sufficient icon. ✨
• -n, --namesonly — this one says: print only facnames, in a gtkwave savefile compatible format. Why would you want that? Because then the file doubles as a shopping list of which traces you wanna import into gtkwave. Efficiency queen. 👑
• -c, --comprehensive — this says do NOT stop after the first match, keep going. Use it when you want to extract all the matching values in the trace. Go off, collect everything. 💀
• -h, --help — shows the help screen. The classic. The reliable. 🫶

🍓 EXAMPLES 🍓

fstminer dumpfile.fst --hex 20470000 -n

So what's happening here: it tries to match the hex value 20470000 across all facilities, and the moment that value shows up, only the facname gets printed to stdout — specifically so you end up with a gtkwave compatible save file. Chef's kiss, exactly as intended. 😭💖

💀 LIMITATIONS 💀

Real talk, no cap: fstminer only prints the first time a value is encountered for a specific net. That's not a bug, it's a choice — it keeps the output files from getting thicc and it helps you actually follow data like addresses as they travel through a simulation model. So if you were expecting every single occurrence, this is your heads-up. 🙈

💜 AUTHORS 💜

Anthony Bybell <bybell@rocketmail.com> — the legend themselves. 🌈

🦋 SEE ALSO 🦋

vztminer(1) lxt2miner(1) fst2vcd(1) vcd2fst(1) gtkwave(1)

Like, the whole friend group. Go say hi. ⭐

Sign-off time, bestie: this lil masterpiece was brought to you by Anthony Bybell, version 3.3.38 of the FSTMINER(1) manual — and yeah, the original footer dates it and versions it, so here we are, mwah, go mine some data, periodt. 💅✨