SSADUMP

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 AT debian DOT org>, for the Debian project (and may be used by others).

pdf