From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29217 invoked by alias); 21 May 2013 09:25:29 -0000 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 Received: (qmail 29195 invoked by uid 89); 21 May 2013 09:25:28 -0000 X-Spam-SWARE-Status: No, score=-2.5 required=5.0 tests=AWL,BAYES_00,RCVD_IN_HOSTKARMA_NO,RP_MATCHES_RCVD,SPF_PASS,TW_DB autolearn=ham version=3.3.1 Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Tue, 21 May 2013 09:24:58 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 471BF2ECFB for ; Tue, 21 May 2013 05:24:56 -0400 (EDT) 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 dtfNcH0O1TkQ for ; Tue, 21 May 2013 05:24:56 -0400 (EDT) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id D3FDF2ECF8 for ; Tue, 21 May 2013 05:24:55 -0400 (EDT) Received: by joel.gnat.com (Postfix, from userid 1000) id BAEB4C376B; Tue, 21 May 2013 13:24:49 +0400 (RET) From: Joel Brobecker To: gdb-patches@sourceware.org Subject: [RFA/Doco] Document new /system-gdbinit area Date: Tue, 21 May 2013 09:25:00 -0000 Message-Id: <1369128288-3495-1-git-send-email-brobecker@adacore.com> X-SW-Source: 2013-05/txt/msg00763.txt.bz2 This documents the introduction of new scripts provided in a GDB install. Ref: http://www.sourceware.org/ml/gdb-patches/2013-05/msg00382.html gdb/doc/ChangeLog: * gdb.texinfo (System-wide configuration): Add subsection describing the scripts now available under the data-dir's system-gdbbinit subdirectory. OK to apply? Should I also add a NEWS entry for this? Thank you, -- Joel --- gdb/doc/gdb.texinfo | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 43b0104..111e352 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -36332,6 +36332,32 @@ initialization. If the data-directory is changed after @value{GDBN} has started with the @code{set data-directory} command, the file will not be reread. +@subsection System-wide configuration scripts provided by @value{GDBN} + +The @file{system-gdbinit} directory, located inside the data-directory +(as specified by @option{--with-gdb-datadir} at configure time) contains +a number of scripts which can be used as system-wide init files. To +automatically source those scripts at startup, @value{GDBN} should be +configured with @option{-with-system-gdbinit}. Otherwise, any user +should be able to source them by hand as needed. + +The following scripts are currently available: +@itemize @bullet + +@item @file{elinos.py} +This script is useful when debugging a program on an ELinOS target. +It takes advantage of the environment variables defined in a standard +ELinOS environment in order to determine the location of the system +shared libraries, and then sets the @samp{solib-absolute-prefix} +and @samp{solib-search-path} variables appropriately. + +@item @file{wrs-linux.py} +This script is useful when debugging a program on a target running +Wind River Linux. It expects the @env{ENV_PREFIX} to be set to +the host-side sysroot used by the target system. + +@end itemize + @node Maintenance Commands @appendix Maintenance Commands @cindex maintenance commands -- 1.7.10.4