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

                                            2013-12-02                                 SSADUMP(1)