From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10340 invoked by alias); 8 Feb 2010 12:17:58 -0000 Received: (qmail 10331 invoked by uid 22791); 8 Feb 2010 12:17:58 -0000 X-SWARE-Spam-Status: No, hits=-2.4 required=5.0 tests=AWL,BAYES_00,SPF_PASS X-Spam-Check-By: sourceware.org Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Mon, 08 Feb 2010 12:17:51 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 0AD222BAB91 for ; Mon, 8 Feb 2010 07:17:50 -0500 (EST) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 0-69eMqLsCjk for ; Mon, 8 Feb 2010 07:17:49 -0500 (EST) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 67BD02BAB38 for ; Mon, 8 Feb 2010 07:17:49 -0500 (EST) Received: by joel.gnat.com (Postfix, from userid 1000) id D97B0F59A2; Mon, 8 Feb 2010 16:17:37 +0400 (RET) From: Joel Brobecker To: gdb-patches@sourceware.org Subject: [RFA/doco/testsuite] Document new gdb_test_timeout global variable. Date: Mon, 08 Feb 2010 12:17:00 -0000 Message-Id: <1265631452-2476-1-git-send-email-brobecker@adacore.com> 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/msg00203.txt.bz2 Hello, This patch documents a new testsuite variable introduced to allow the user to configure the timeout duration used while running the testsuite. http://www.sourceware.org/ml/gdb-patches/2010-02/msg00101.html gdb/doc/ChangeLog: * gdbint.texinfo (Testsuite): New section "Testsuite Configuration", documenting the gdb_test_timeout variable. This patch was tested on x86_64-linux by rebuilding the PDF, PS and HTML documentation. OK to apply? Thanks, -- Joel --- gdb/doc/gdbint.texinfo | 28 ++++++++++++++++++++++++++++ 1 files changed, 28 insertions(+), 0 deletions(-) diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index c90af05..b97d0e1 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -7693,6 +7693,34 @@ make site.exp runtest TRANSCRIPT=y @end smallexample +@section Testsuite Configuration + +It is possible to adjust the behavior of the testsuite by defining +the global variables listed below, either in a @file{site.exp} file, +or in a @code{board} file. + +@itemize @bullet + +@item @code{gdb_test_timeout} + +Defining this variable changes the default timeout duration used during +communication with @value{GDBN}. More specifically, the global variable +used during testing is @code{timeout}, but this variable gets reset to +@code{gdb_test_timeout} at the beginning of each testcase, making sure +that any local change to @code{timeout} in a testcase does not affect +subsequent testcases. + +If not specifically defined, this variable gets automatically defined +to the same value as @code{timeout} during the testsuite initialization +(the actual value depends on the exact running parameters). + +This global variable is usually used when the debugger is slower than +normal due to the testing environment, triggering unexpected @code{TIMEOUT} +test failures. For instance, when testing on a remote machine, or against +a system where communications are slow. + +@end itemize + @section Testsuite Organization @cindex test suite organization -- 1.6.3.3