From 0201faace78ad7fb4eb26e405a95e62db267543e Mon Sep 17 00:00:00 2001 From: Joel Brobecker Date: Thu, 23 May 2013 06:00:53 +0000 Subject: [PATCH] Document new /system-gdbinit area gdb/doc/ChangeLog: * gdb.texinfo (Installed System-wide Configuration Scripts): Add subsection describing the scripts now available under the data-dir's system-gdbbinit subdirectory. * NEWS: Add entry announcing the availability of system-wide configuration scripts for ElinOS and Wind River Linux. --- gdb/NEWS | 6 ++++++ gdb/doc/ChangeLog | 8 ++++++++ gdb/doc/gdb.texinfo | 32 ++++++++++++++++++++++++++++++++ 3 files changed, 46 insertions(+) diff --git a/gdb/NEWS b/gdb/NEWS index e09907c..c6a5e5d 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -72,6 +72,12 @@ show debug nios2 ** The new command -dprintf-insert sets a dynamic printf breakpoint. +* New system-wide configuration scripts + A GDB installation now provides scripts suitable for use as system-wide + configuration scripts for the following systems: + ** ElinOS + ** Wind River Linux + *** Changes in GDB 7.6 * Target record has been renamed to record-full. diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 41e08b8..ddc766a 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,11 @@ +2013-05-23 Joel Brobecker + + * gdb.texinfo (Installed System-wide Configuration Scripts): + Add subsection describing the scripts now available under + the data-dir's system-gdbbinit subdirectory. + * NEWS: Add entry announcing the availability of system-wide + configuration scripts for ElinOS and Wind River Linux. + 2013-05-21 Hui Zhu * gdb.texinfo (GDB/MI Breakpoint Commands): Describe the diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 43b0104..b68d2f8 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -36332,6 +36332,38 @@ 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. +@node Installed System-wide Configuration Scripts +@subsection Installed System-wide Configuration Scripts +@cindex system-wide configuration scripts + +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} +@pindex elinos.py +@cindex ELinOS system-wide configuration script +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} +@pindex wrs-linux.py +@cindex Wind River Linux system-wide configuration script +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 -- 2.7.4