diff options
author | Tom Tromey <tromey@redhat.com> | 2009-07-10 18:48:41 +0000 |
---|---|---|
committer | Tom Tromey <tromey@redhat.com> | 2009-07-10 18:48:41 +0000 |
commit | 812f73424775824b59fe27c6e87f183c72571c80 (patch) | |
tree | cd8ff25033084da40beabea2151b2513264ec7a5 /gdb/doc/gdbint.texinfo | |
parent | f07749bbae83adb37c54f7c6079c1999af292724 (diff) | |
download | gdb-812f73424775824b59fe27c6e87f183c72571c80.zip gdb-812f73424775824b59fe27c6e87f183c72571c80.tar.gz gdb-812f73424775824b59fe27c6e87f183c72571c80.tar.bz2 |
gdb/doc
* gdbint.texinfo (Testsuite): Document test transcripts.
gdb/testsuite
* lib/gdb.exp: Handle TRANSCRIPT.
(remote_spawn, remote_close, send_gdb): New procs.
Diffstat (limited to 'gdb/doc/gdbint.texinfo')
-rw-r--r-- | gdb/doc/gdbint.texinfo | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index a51f077..3351a15 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -7560,6 +7560,27 @@ will give a result of ``UNRESOLVED'', like this: UNRESOLVED: gdb.base/example.exp: This test script does not work on a remote host. @end smallexample +Sometimes it is convenient to get a transcript of the commands which +the testsuite sends to @value{GDBN}. For example, if @value{GDBN} +crashes during testing, a transcript can be used to more easily +reconstruct the failure when running @value{GDBN} under @value{GDBN}. + +You can instruct the @value{GDBN} testsuite to write transcripts by +setting the DejaGNU variable @code{TRANSCRIPT} (to any value) +before invoking @code{runtest} or @kbd{make check}. The transcripts +will be written into DejaGNU's output directory. One transcript will +be made for each invocation of @value{GDBN}; they will be named +@file{transcript.@var{n}}, where @var{n} is an integer. The first +line of the transcript file will show how @value{GDBN} was invoked; +each subsequent line is a command sent as input to @value{GDBN}. + +@smallexample +make check RUNTESTFLAGS=TRANSCRIPT=y +@end smallexample + +Note that the transcript is not always complete. In particular, tests +of completion can yield partial command lines. + @section Testsuite Organization @cindex test suite organization |