diff options
author | Doug Evans <dje@google.com> | 2010-02-05 18:30:44 +0000 |
---|---|---|
committer | Doug Evans <dje@google.com> | 2010-02-05 18:30:44 +0000 |
commit | c5f80513ff040272aefa49ca3437cb51b51f1240 (patch) | |
tree | c46a665d9c781f6677bf64ade5bf9d3679bc209a /gdb | |
parent | 4c34844242617e154e98ef479fb740d4fc57f562 (diff) | |
download | gdb-c5f80513ff040272aefa49ca3437cb51b51f1240.zip gdb-c5f80513ff040272aefa49ca3437cb51b51f1240.tar.gz gdb-c5f80513ff040272aefa49ca3437cb51b51f1240.tar.bz2 |
* gdbint.texinfo (Testsuite): Add a new section to document the
various DejaGnu variables that may be overridden.
Diffstat (limited to 'gdb')
-rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdbint.texinfo | 46 |
2 files changed, 51 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index b90906a..20c8b39 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2010-02-05 Doug Evans <dje@google.com> + + * gdbint.texinfo (Testsuite): Add a new section to document the + various DejaGnu variables that may be overridden. + 2010-02-04 Tom Tromey <tromey@redhat.com> PR cli/8830: diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 347c860..44e652a 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -7599,6 +7599,14 @@ 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 +@section Testsuite Parameters + +Several variables exist to modify the behavior of the testsuite. + +@itemize @bullet + +@item @code{TRANSCRIPT} + 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 @@ -7620,6 +7628,44 @@ make check RUNTESTFLAGS=TRANSCRIPT=y Note that the transcript is not always complete. In particular, tests of completion can yield partial command lines. +@item @code{GDB} + +Sometimes one wishes to test a different @value{GDBN} than the one in the build +directory. For example, one may wish to run the testsuite on +@file{/usr/bin/gdb}. + +@smallexample +make check RUNTESTFLAGS=GDB=/usr/bin/gdb +@end smallexample + +@item @code{GDBSERVER} + +When testing a different @value{GDBN}, it is often useful to also test a +different gdbserver. + +@smallexample +make check RUNTESTFLAGS="GDB=/usr/bin/gdb GDBSERVER=/usr/bin/gdbserver" +@end smallexample + +@end itemize + +There are two ways to run the testsuite and pass additional parameters +to DejaGnu. The first is with @kbd{make check} and specifying the +makefile variable @samp{RUNTESTFLAGS}. + +@smallexample +make check RUNTESTFLAGS=TRANSCRIPT=y +@end smallexample + +The second is to cd to the @file{testsuite} directory and invoke the DejaGnu +@command{runtest} command directly. + +@smallexample +cd testsuite +make site.exp +runtest TRANSCRIPT=y +@end smallexample + @section Testsuite Organization @cindex test suite organization |