You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
207 lines
6.9 KiB
207 lines
6.9 KiB
http://sourceware.org/ml/gdb-patches/2010-07/msg00184.html |
|
Subject: Re: [0/4] RFC: add DWARF index support |
|
|
|
Jan Kratochvil: Fixed $d -> $dir. |
|
Jan Kratochvil: Remove /dev/null redirection. |
|
|
|
>>>>> "Tom" == Tom Tromey <tromey@redhat.com> writes: |
|
|
|
Tom> This patch series adds support for a DWARF index to gdb. |
|
|
|
Roland suggested we wrap up the index-creation code into a helper |
|
script. |
|
|
|
I'm not sure if this is something people would want in gdb proper, but I |
|
figured I would send it here just in case. |
|
|
|
Tom |
|
|
|
2010-07-09 Tom Tromey <tromey@redhat.com> |
|
|
|
* Makefile.in (install-only): Install gdb-add-index. |
|
* gdb-add-index: New file. |
|
|
|
2010-07-09 Tom Tromey <tromey@redhat.com> |
|
|
|
* gdb.texinfo (Index Files): Mention gdb-add-index. |
|
|
|
>From 30714fe719e61baea03d0dc5793eb0d564faebb7 Mon Sep 17 00:00:00 2001 |
|
From: Tom Tromey <tromey@redhat.com> |
|
Date: Fri, 9 Jul 2010 11:17:54 -0600 |
|
Subject: [PATCH 4/4] add gdb-add-index |
|
Subject: [PATCH 4/4] add gdb-add-index |
|
|
|
--- |
|
gdb/ChangeLog | 5 +++++ |
|
gdb/Makefile.in | 11 ++++++++++- |
|
gdb/doc/ChangeLog | 4 ++++ |
|
gdb/doc/gdb.texinfo | 8 ++++++++ |
|
gdb/gdb-add-index | 30 ++++++++++++++++++++++++++++++ |
|
5 files changed, 57 insertions(+), 1 deletions(-) |
|
create mode 100755 gdb/gdb-add-index |
|
|
|
Index: gdb-7.6.1/gdb/Makefile.in |
|
=================================================================== |
|
--- gdb-7.6.1.orig/gdb/Makefile.in |
|
+++ gdb-7.6.1/gdb/Makefile.in |
|
@@ -1053,6 +1053,15 @@ install-only: install-gstack $(CONFIG_IN |
|
$(INSTALL_PROGRAM) gcore \ |
|
$(DESTDIR)$(bindir)/$$transformed_name; \ |
|
fi |
|
+ transformed_name=`t='$(program_transform_name)'; \ |
|
+ echo gdb-add-index | sed -e "$$t"` ; \ |
|
+ if test "x$$transformed_name" = x; then \ |
|
+ transformed_name=gdb-add-index ; \ |
|
+ else \ |
|
+ true ; \ |
|
+ fi ; \ |
|
+ $(INSTALL_PROGRAM) $(srcdir)/gdb-add-index \ |
|
+ $(DESTDIR)$(bindir)/$$transformed_name$(EXEEXT) |
|
@$(MAKE) DO=install "DODIRS=$(SUBDIRS)" $(FLAGS_TO_PASS) subdir_do |
|
|
|
install-python: |
|
Index: gdb-7.6.1/gdb/doc/gdb.texinfo |
|
=================================================================== |
|
--- gdb-7.6.1.orig/gdb/doc/gdb.texinfo |
|
+++ gdb-7.6.1/gdb/doc/gdb.texinfo |
|
@@ -17159,6 +17159,14 @@ There are currently some limitation on i |
|
for DWARF debugging information, not stabs. And, they do not |
|
currently work for programs using Ada. |
|
|
|
+@value{GDBN} comes with a program, @command{gdb-add-index}, which can |
|
+be used to add the index to a symbol file. It takes the symbol file |
|
+as its only argument: |
|
+ |
|
+@smallexample |
|
+$ gdb-add-index symfile |
|
+@end smallexample |
|
+ |
|
@node Symbol Errors |
|
@section Errors Reading Symbol Files |
|
|
|
@@ -41738,6 +41746,7 @@ switch (die->tag) |
|
* gdbserver man:: Remote Server for the GNU Debugger man page |
|
* gcore man:: Generate a core file of a running program |
|
* gdbinit man:: gdbinit scripts |
|
+* gdb-add-index man:: Add index files to speed up GDB |
|
@end menu |
|
|
|
@node gdb man |
|
@@ -42390,6 +42399,54 @@ gdb(1), @code{info -f gdb -n Startup} |
|
The full documentation for @value{GDBN} is maintained as a Texinfo manual. |
|
If the @code{info} and @code{gdb} programs and @value{GDBN}'s Texinfo |
|
documentation are properly installed at your site, the command |
|
+ |
|
+@smallexample |
|
+info gdb |
|
+@end smallexample |
|
+ |
|
+should give you access to the complete manual. |
|
+ |
|
+@cite{Using GDB: A Guide to the GNU Source-Level Debugger}, |
|
+Richard M. Stallman and Roland H. Pesch, July 1991. |
|
+@end ifset |
|
+@c man end |
|
+ |
|
+@node gdb-add-index man |
|
+@heading gdb-add-index |
|
+ |
|
+@c man title gdb-add-index Add index files to speed up GDB |
|
+ |
|
+@c man begin SYNOPSIS gdb-add-index |
|
+gdb-add-index @var{filename} |
|
+@c man end |
|
+ |
|
+@c man begin DESCRIPTION gdb-add-index |
|
+When GDB finds a symbol file, it scans the symbols in the file in order |
|
+to construct an internal symbol table. This lets most GDB operations |
|
+work quickly--at the cost of a delay early on. For large programs, |
|
+this delay can be quite lengthy, so GDB provides a way to build an |
|
+index, which speeds up startup. |
|
+ |
|
+To determine whether a file contains such an index, use the command |
|
+@command{readelf -S filename}: the index is stored in a section named |
|
+@code{.gdb_index}. Note that the index is never generated for files that do |
|
+not contain DWARF debug information (sections named @code{.debug_*}). |
|
+ |
|
+See more in |
|
+@ifset man |
|
+the @value{GDBN} manual in node @code{Index Files} |
|
+-- shell command @code{info -f gdb -n 'Index Files'}. |
|
+@end ifset |
|
+@ifclear man |
|
+@ref{Index Files}. |
|
+@end ifclear |
|
+@c man end |
|
+ |
|
+@c man begin SEEALSO gdb-add-index |
|
+@ifset man |
|
+The full documentation for @value{GDBN} is maintained as a Texinfo manual. |
|
+If the @code{info} and @code{gdb} programs and @value{GDBN}'s Texinfo |
|
+documentation are properly installed at your site, the command |
|
|
|
@smallexample |
|
info gdb |
|
Index: gdb-7.6.1/gdb/gdb-add-index |
|
=================================================================== |
|
--- /dev/null |
|
+++ gdb-7.6.1/gdb/gdb-add-index |
|
@@ -0,0 +1,31 @@ |
|
+#! /bin/sh |
|
+ |
|
+# Add a .gdb_index section to a file. |
|
+ |
|
+# Copyright (C) 2010 Free Software Foundation, Inc. |
|
+# This program is free software; you can redistribute it and/or modify |
|
+# it under the terms of the GNU General Public License as published by |
|
+# the Free Software Foundation; either version 3 of the License, or |
|
+# (at your option) any later version. |
|
+# |
|
+# This program is distributed in the hope that it will be useful, |
|
+# but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
+# GNU General Public License for more details. |
|
+# |
|
+# You should have received a copy of the GNU General Public License |
|
+# along with this program. If not, see <http://www.gnu.org/licenses/>. |
|
+ |
|
+file="$1" |
|
+dir="${file%/*}" |
|
+test "$dir" = "$file" && dir="." |
|
+ |
|
+# We don't care if gdb gives an error. |
|
+gdb -nx -iex 'set auto-load no' --batch-silent -ex "file $file" -ex "save gdb-index $dir" |
|
+ |
|
+if test -f "${file}.gdb-index"; then |
|
+ objcopy --add-section .gdb_index="${file}.gdb-index" --set-section-flags .gdb_index=readonly "$file" "$file" |
|
+ rm -f "${file}.gdb-index" |
|
+fi |
|
+ |
|
+exit 0 |
|
Index: gdb-7.6.1/gdb/doc/Makefile.in |
|
=================================================================== |
|
--- gdb-7.6.1.orig/gdb/doc/Makefile.in |
|
+++ gdb-7.6.1/gdb/doc/Makefile.in |
|
@@ -177,7 +177,7 @@ POD2MAN5 = pod2man --center="GNU Develop |
|
--release="gdb-`sed q $(srcdir)/../version.in`" --section=5 |
|
|
|
# List of man pages generated from gdb.texi |
|
-MAN1S = gdb.1 gdbserver.1 gcore.1 |
|
+MAN1S = gdb.1 gdbserver.1 gcore.1 gdb-add-index.1 |
|
MAN5S = gdbinit.5 |
|
MANS = $(MAN1S) $(MAN5S) |
|
|
|
@@ -626,6 +626,13 @@ gcore.1: $(GDB_DOC_FILES) |
|
mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) |
|
rm -f gcore.pod |
|
|
|
+gdb-add-index.1: $(GDB_DOC_FILES) |
|
+ touch $@ |
|
+ -$(TEXI2POD) $(MANCONF) -Dgdb-add-index < $(srcdir)/gdb.texinfo > gdb-add-index.pod |
|
+ -($(POD2MAN1) gdb-add-index.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ |
|
+ mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) |
|
+ rm -f gdb-add-index.pod |
|
+ |
|
gdbinit.5: $(GDB_DOC_FILES) |
|
touch $@ |
|
-$(TEXI2POD) $(MANCONF) -Dgdbinit < $(srcdir)/gdb.texinfo > gdbinit.pod
|
|
|