NAME

       go - tool for managing Go source code

DESCRIPTION

       The 'go test' command takes both flags that apply to 'go test' itself and flags that apply
       to the resulting test binary.

       The test binary, called pkg.test, where pkg is the name of the  directory  containing  the
       package sources, has its own flags:

       -test.v
              Verbose output: log all tests as they are run.

       -test.run pattern
              Run only those tests and examples matching the regular expression.

       -test.bench pattern
              Run benchmarks matching the regular expression.  By default, no benchmarks run.

       -test.cpuprofile cpu.out
              Write a CPU profile to the specified file before exiting.

       -test.memprofile mem.out
              Write a memory profile to the specified file when all tests are complete.

       -test.memprofilerate n
              Enable    more    precise    (and    expensive)    memory   profiles   by   setting
              runtime.MemProfileRate.  See 'godoc runtime MemProfileRate'.  To profile all memory
              allocations,  use  -test.memprofilerate=1 and set the environment variable GOGC=off
              to disable the garbage collector, provided the test can run in the available memory
              without garbage collection.

       -test.parallel n
              Allow parallel execution of test functions that call t.Parallel.  The value of this
              flag is the maximum number of tests to run simultaneously; by default, it is set to
              the value of GOMAXPROCS.

       -test.short
              Tell  long-running  tests  to shorten their run time.  It is off by default but set
              during all.bash so that installing the Go tree can run a sanity check but not spend
              time running exhaustive tests.

       -test.timeout t
              If a test runs longer than t, panic.

       -test.benchtime n
              Run  enough  iterations  of  each  benchmark  to  take n seconds.  The default is 1
              second.

       -test.cpu 1,2,4
              Specify a list of GOMAXPROCS values for which the tests  or  benchmarks  should  be
              executed.  The default is the current value of GOMAXPROCS.

       For  convenience,  each of these -test.X flags of the test binary is also available as the
       flag -X in 'go test' itself.  Flags not listed here are  passed  through  unaltered.   For
       instance, the command

             go test -x -v -cpuprofile=prof.out -dir=testdata -update

       will compile the test binary and then run it as

             pkg.test -test.v -test.cpuprofile=prof.out -dir=testdata -update

AUTHOR

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

                                            2012-05-13                             GO-TESTFLAG(7)