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