SSADUMP(1)

💖 SSADUMP 💖

ok so bestie, meet ssadump — she's a whole tool for showing you and interpreting the SSA form of Go programs. yes. the SSA form. the ✨vibes✨ version of your code. she lives in the General Commands Manual, section 1, and she is so iconic for it.

✨ SYNOPSIS ✨

ssadump [flags] args ...

🦋 DESCRIPTION 🦋

She's an SSA builder and interpreter, periodt. like that's the job, that's the whole thing, and she ate.

When -run is specified, ssadump will find the first package that defines a main function and run it in the interpreter 🏃♀️💨. If none is found, the tests of each package will be run instead. no main? no problem, we're running tests, we move 🎀

👑 OPTIONS 👑

• -build — options controlling the SSA builder. the value is a sequence of zero or more of these letters, and you just vibe them together:
  • C — perform sanity [C]hecking of the SSA form ✅
  • D — include [D]ebug info for every function 🐛
  • P — log [P]ackage inventory 📦
  • F — log [F]unction SSA code 🧾
  • S — log [S]ource locations as the SSA builder progresses 📍
  • G — use binary object files from gc to provide imports (no code) 🔥
  • L — build distinct packages seria[L]ly instead of in parallel 🐌
  • N — build [N]aive SSA form: don't replace local loads/stores with registers 🙈
• -cpuprofile — write cpu profile to file 📊
• -interp — options controlling the SSA test interpreter. the value is a sequence of zero or more of these letters (yes the original says "zero or more more", she's a little chaotic, we love her):
  • R — disable [R]ecover()` from panic; show interpreter crash instead 💀
  • T — [T]race execution of the program. Best for single-threaded programs! 🧵
• -run — invokes the SSA interpreter on the program 🏃♀️

🌈 EXAMPLES 🌈

Quickly dump SSA form of a single package, no thoughts head empty:

ssadump -build=FPG hello.go

Interpret a program, with tracing, because we're nosy 👀:

ssadump -run -interp=T hello.go

Interpret the unicode package's tests, verbosely, main character energy only:

ssadump -run unicode -- -test.v

🫶 AUTHOR 🫶

This manual page was written by Michael Stapelberg <stapelberg@debian.org>, for the Debian project (and may be used by others). shoutout to Michael, fr fr 💜

ok that's the whole page bestie, you're officially an SSA girlie now 💅

and that's a wrap!! this one's from the General Commands Manual, dated 2013-12-02 — oldie but a goodie, still serving looks, mwah 😘✨🌸