From 7d9992046ef57346a5d63760462b1727a4480988 Mon Sep 17 00:00:00 2001 From: dmalcolm Date: Tue, 31 Oct 2017 20:40:10 +0000 Subject: jit: add a way to preserve testsuite executables gcc/jit/ChangeLog: * docs/internals/index.rst (Running the test suite): Document PRESERVE_EXECUTABLES. (Running under valgrind): Add markup to RUN_UNDER_VALGRIND. * docs/_build/texinfo/libgccjit.texi: Regenerate. gcc/testsuite/ChangeLog: * jit.dg/jit.exp (jit-dg-test): If PRESERVE_EXECUTABLES is set in the environment, don't delete the generated executable. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@254282 138bc75d-0d04-0410-961f-82ee72b054a4 --- gcc/jit/docs/_build/texinfo/libgccjit.texi | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) (limited to 'gcc/jit/docs/_build/texinfo/libgccjit.texi') diff --git a/gcc/jit/docs/_build/texinfo/libgccjit.texi b/gcc/jit/docs/_build/texinfo/libgccjit.texi index 344c93e4ccf..a3b206f2dd4 100644 --- a/gcc/jit/docs/_build/texinfo/libgccjit.texi +++ b/gcc/jit/docs/_build/texinfo/libgccjit.texi @@ -19,7 +19,7 @@ @copying @quotation -libgccjit 8.0.0 (experimental 20171004), October 04, 2017 +libgccjit 8.0.0 (experimental 20171031), October 31, 2017 David Malcolm @@ -15016,7 +15016,12 @@ jit/build/gcc/testsuite/jit/jit.log @noindent -The test executables can be seen as: +The test executables are normally deleted after each test is run. For +debugging, they can be preserved by setting +@geindex PRESERVE_EXECUTABLES +@geindex environment variable; PRESERVE_EXECUTABLES +@code{PRESERVE_EXECUTABLES} +in the environment. If so, they can then be seen as: @example jit/build/gcc/testsuite/jit/*.exe @@ -15029,7 +15034,9 @@ which can be run independently. You can compile and run individual tests by passing "jit.exp=TESTNAME" to RUNTESTFLAGS e.g.: @example -[gcc] $ make check-jit RUNTESTFLAGS="-v -v -v jit.exp=test-factorial.c" +[gcc] $ PRESERVE_EXECUTABLES= \ + make check-jit \ + RUNTESTFLAGS="-v -v -v jit.exp=test-factorial.c" @end example @noindent @@ -15056,7 +15063,10 @@ and once a test has been compiled, you can debug it directly: @subsection Running under valgrind -The jit testsuite detects if RUN_UNDER_VALGRIND is present in the +The jit testsuite detects if +@geindex RUN_UNDER_VALGRIND +@geindex environment variable; RUN_UNDER_VALGRIND +@code{RUN_UNDER_VALGRIND} is present in the environment (with any value). If it is present, it runs the test client code under valgrind@footnote{http://valgrind.org}, specifcally, the default -- cgit v1.2.1