From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 11681 invoked by alias); 4 Feb 2010 21:37:24 -0000 Received: (qmail 11663 invoked by uid 22791); 4 Feb 2010 21:37:23 -0000 X-SWARE-Spam-Status: No, hits=-2.2 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS X-Spam-Check-By: sourceware.org Received: from smtp-out.google.com (HELO smtp-out.google.com) (216.239.33.17) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 04 Feb 2010 21:37:18 +0000 Received: from spaceape13.eur.corp.google.com (spaceape13.eur.corp.google.com [172.28.16.147]) by smtp-out.google.com with ESMTP id o14LbBGJ029638; Thu, 4 Feb 2010 21:37:11 GMT Received: from ruffy.mtv.corp.google.com (ruffy.mtv.corp.google.com [172.18.118.116]) by spaceape13.eur.corp.google.com with ESMTP id o14LbAZf019237; Thu, 4 Feb 2010 13:37:10 -0800 Received: by ruffy.mtv.corp.google.com (Postfix, from userid 67641) id C7D4884414; Thu, 4 Feb 2010 13:37:09 -0800 (PST) To: gdb-patches@sourceware.org, eliz@gnu.org Subject: [RFA] doc addition to gdbint.texinfo Message-Id: <20100204213709.C7D4884414@ruffy.mtv.corp.google.com> Date: Thu, 04 Feb 2010 21:37:00 -0000 From: dje@google.com (Doug Evans) X-System-Of-Record: true X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2010-02/txt/msg00138.txt.bz2 Hi. The Testsuite section of gdbint.texinfo is missing docs on at least two more DejaGnu variables that are available to be overridden: GDB, GDBSERVER. Since there's at least three of them (those two plus TRANSCRIPT), with more to come, it seemed appropriate to create a new section to document them all. Ok to check in? 2010-02-04 Doug Evans * gdbint.texinfo (Testsuite): Add a new section to document the various DejaGnu variables that may be overridden. Index: gdbint.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v retrieving revision 1.316 diff -u -p -r1.316 gdbint.texinfo --- gdbint.texinfo 1 Jan 2010 11:38:33 -0000 1.316 +++ gdbint.texinfo 4 Feb 2010 21:32:09 -0000 @@ -7599,6 +7599,14 @@ will give a result of ``UNRESOLVED'', li 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 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 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 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 +@kbd{runtest} command directly. + +@smallexample +cd testsuite +make site.exp +runtest TRANSCRIPT=y +@end smallexample + @section Testsuite Organization @cindex test suite organization