libgo: add Debugging section to README

Reviewed-on: https://go-review.googlesource.com/c/gofrontend/+/176001

From-SVN: r271019
This commit is contained in:
Ian Lance Taylor 2019-05-08 22:07:40 +00:00
parent 6328ce1f83
commit 8238b660fb
2 changed files with 26 additions and 1 deletions

View file

@ -1,4 +1,4 @@
859e8ed3d632d9fe43d03fb81f6abefecf5fe3a6
f813c670deb8e0454c3f64de74bedb5dcedd10b4
The first line of this file holds the git revision number of the last
merge done from the gofrontend repository.

View file

@ -42,3 +42,28 @@ http://code.google.com/legal/corporate-cla-v1.0.html.
If the copyright holder for your code has already completed the
agreement in connection with another Google open source project, it
does not need to be completed again.
Debugging
=========
This describes how to test libgo when built as part of gccgo.
To test a specific package, cd to the libgo build directory
(TARGET/libgo) and run `make PKG/check`. For example, `make
bytes/check`.
To see the exact commands that it runs, including how the compiler is
invoked, run `make GOTESTFLAGS=--trace bytes/check`. This will
display the commands if the test fails. If the test passes, the
commands and other output will be visible in a file named
check-testlog in a subdirectory with the name of the package being
checked. In the case of bytes/check, this will create
bytes/check-testlog.
To leave the test program behind, run `make GOTESTFLAGS=--keep
bytes/check`. That will leave a gotestNNNN/test directory in the
libgo build directory. In that directory you can run
`LD_LIBRARY_PATH=../../.libs ./a.out -test.short` to run the tests.
You can run specific failing tests using a -test.run option. You can
see the tests being run with the -test.v option. You can run the
program under a debugger such as gdb.