SSADUMP(1)

NAME
ssadump - a tool for displaying and interpreting the SSA form of Go programs

SYNOPSIS
ssadump [flags] args ...

DESCRIPTION

SSA builder and interpreter.

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.

OPTIONS

-build
    Options controlling the SSA builder. The value is a sequence of zero or more of these letters:

    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 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 more of these letters:
    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:

      ssadump -build=FPG hello.go

Interpret a program, with tracing:

      ssadump -run -interp=T hello.go

Interpret the unicode package's tests, verbosely:

      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).