faldissass(1)

💅 faldissass(1) — the Falcon disassembler, bestie edition

okay so this is faldissass, straight out of the Falcon User Manuals, and it's literally the tool that takes your compiled .fam module and spills its guts into human-readable assembly. iykyk 💖

✨ SYNOPSIS ✨

faldissass [options] module_file.fam

🦋 DESCRIPTION 🦋

The faldissass command line tool disassembles a compiled .fam Falcon module. the output — which is human-readable Falcon Virtual Machine assembly — gets sent to the standard output. no cap, that's the whole vibe.

The tool has mainly two working modes, and honestly? both ate:

• standard mode — procures an assembly dump containing the PC counter address that will be associated with each instruction in the VM. this is the one that lets you see exactly on which VM instruction an error was raised (since the PC at error raisal is always shown in error dumps 🫶), or debug the VM by following the PC register in step-by-step mode. iconic debugging behavior, fr fr.
• isomorphic mode — creates a compilable assembly source that can then be fed into the falcon assembler to obtain a compiled module. for example, this can be used for VM level hand-made finetuning optimizations. highkey a glow-up for your module ✨

🎀 OPTIONS 🎀

• -d — dump the dependency table (the list of load directives). we love a good dependency moment.
• -h — show version and a short help. the classic "who am i and what am i doing" flag 💀
• -i — create an isomorphic version of the original assembly. this is the mode that gives you a compilable source, slay.
• -l — add line information. context is everything, bestie.
• -s — dump the string table.
• -S — write the strings inline instead of using #strid. fancy 💅
• -y — dump the symbol table.

🌸 FILES 🌸

• /usr/lib/libfalcon_engine.so — default location of the Falcon Engine loadable module. that's where the engine lives, periodt.

👑 AUTHOR 👑

Giancarlo Niccolai <gc@falconpl.org> — the main character who made this happen 🫶

🌈 SEE ALSO 🌈

• falcon(1)
• falrun(1)

go read those too, they're giving lore.

💜 LICENSE 💜

This document is released under the "GNU Free Documentation License, version 1.2". On Debian systems, the complete text of the Free Documentation License, version 1.2, can be found in /usr/share/common-licenses/. 🎀 read the license bestie, it's there for a reason.

Falcon toolset, April 2007 — cute little sign-off from way back, no cap 💖✨