VZTMINER(1)

✨ VZTMINER(1) — Dumpfile Data Mining ✨

okay so bestie, welcome to vztminer, the VZT file data-mining tool, and yes this is section 1 of the manual because it's a command, not a config file or a syscall. 💅 Sit down, hydrate, let's get into it.

🌸 NAME 🌸

vztminer — data mining of VZT files 🦋

🎀 SYNTAX 🎀

vztminer [option]... [VZTFILE]

💖 DESCRIPTION 💖

So basically vztminer mines VZT files looking for specific data values, and then it generates gtkwave save files and sends them straight to stdout so you can reload them later. That's the whole vibe. ✨

💅 OPTIONS 💅

• -d, --dumpfile <filename> — tell it which VZT input dumpfile you wanna use, bestie. 📁
• -m, --match <value> — this one specifies a "bitwise" match for data. And the data can be binary, real, or string, so it's giving ✨versatile✨.
• -x, --hex <value> — same energy, but for hexadecimal match data. It gets automatically converted to binary for the searches, so you don't have to do it yourself. iconic. 🔥
• -n, --namesonly — says only facnames should get printed, in a gtkwave savefile compatible format. Do this and the file can be used to specify which traces are to be imported into gtkwave. no cap, super handy. 👑
• -c, --comprehensive — this tells it not to stop after the first match. Use it to extract all the matching values in the trace. 🌈
• -h, --help — show the help screen. 🫶

🦋 EXAMPLES 🦋

vztminer dumpfile.vzt --hex 20470000 -n

Okay so what's happening here: it attempts to match the hex value 20470000 across all facilities, and when that value gets encountered, only the facname is printed to stdout — which is exactly how you generate a gtkwave compatible save file. periodt. 💅

😭 LIMITATIONS 😭

Okay bestie, listen up, this part matters:

• vztminer only prints the first time a value is encountered for a specific net. It does this to cut down on the size of output files and to help you follow data like addresses through a simulation model. 📉
• Also, heads up: the reader algorithm attempts to reconstruct bitblasted nets back into their original vectors, but this is not always successful. Specifically not when the individual bitstrands are dumped in non-sequential order. 💀 so like, don't be surprised if it doesn't always work out.

💜 AUTHORS 💜

Anthony Bybell <bybell@rocketmail.com> ✨

⭐ SEE ALSO ⭐

lxt2miner(1) vzt2vcd(1) lxt2vcd(1) vcd2lxt2(1) gtkwave(1) 🌸

okay that's the whole page bestie, you ate it up 🫶 This was VZTMINER(1) from version 3.2.1, brought to you by Anthony Bybell — go forth and mine those dumpfiles 💖✨🎀