This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [patch] build-id .debug files load (like .gnu_debuglink)
- From: Jan Kratochvil <jan dot kratochvil at redhat dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: gdb-patches at sourceware dot org, roland at redhat dot com
- Date: Sat, 1 Sep 2007 15:12:12 +0200
- Subject: Re: [patch] build-id .debug files load (like .gnu_debuglink)
- References: <20070824180450.GA4216@host0.dyn.jankratochvil.net> <20070824182028.GA19512@caradoc.them.org> <20070825224914.GA11255@host0.dyn.jankratochvil.net> <20070825235805.GA11876@caradoc.them.org> <20070826094053.GA31348@host0.dyn.jankratochvil.net> <u642w11sy.fsf@gnu.org> <20070901081934.GA31205@host0.dyn.jankratochvil.net> <ups12vfro.fsf@gnu.org> <20070901113530.GA30667@host0.dyn.jankratochvil.net> <uir6uvayc.fsf@gnu.org>
On Sat, 01 Sep 2007 14:15:07 +0200, Eli Zaretskii wrote:
...
> But the first command, the one to create the separate debug info file,
> is still needed, right?
>
> In any case, we should tell that these commands (or at least the last
> one) is only needed for the debug-link method.
Enhanced the section I hope according to your advice.
Thanks,
Jan
2007-09-01 Jan Kratochvil <jan.kratochvil@redhat.com>
* NEWS: Mention the build-id .debug files verification.
2007-09-01 Jan Kratochvil <jan.kratochvil@redhat.com>
* gdb.texinfo (Separate Debug Files): Cosmetic quoting removal.
Fixed the ``build ID'' name. New binaries build instructions for the
build ID inclusion. Explain how the commands are specific to the build
ID vs. debug link.
--- gdb/NEWS 28 Aug 2007 19:57:11 -0000 1.236
+++ gdb/NEWS 1 Sep 2007 13:06:23 -0000
@@ -61,6 +61,9 @@ Windows and SymbianOS).
* The GDB remote stub, gdbserver, now supports dynamic link libraries
(DLLs) on Windows and Windows CE targets.
+* GDB now supports a faster verification that a .debug file matches its binary
+according to its build-id signature, if the signature is present.
+
* New commands
set remoteflow
--- gdb/doc/gdb.texinfo 1 Sep 2007 10:28:25 -0000 1.426
+++ gdb/doc/gdb.texinfo 1 Sep 2007 13:06:32 -0000
@@ -11925,7 +11925,7 @@ only on some operating systems, notably
details about this feature, see
@uref{http://fedoraproject.org/wiki/Releases/FeatureBuildId, the
Fedora Project's description of the buid ID feature}.) The debug info
-file's name is not specified explicitly by the debug ID, but can be
+file's name is not specified explicitly by the build ID, but can be
computed from the build ID, see below.
@end itemize
@@ -11941,10 +11941,10 @@ directory, in a subdirectory whose name
directories of the executable's absolute file name.
@item
-For the ``debug ID'' method, @value{GDBN} looks in the
+For the ``build ID'' method, @value{GDBN} looks in the
@file{.build-id} subdirectory of the global debug directory for a file
named @file{@var{nn}/@var{nnnnnnnn}.debug}, where @var{nn} are the
-first 2 hex characters of the debug ID signature, and @var{nnnnnnnn}
+first 2 hex characters of the build ID signature, and @var{nnnnnnnn}
are the rest of the signature. (Real signatures are 32 or more
characters, not 10.)
@end itemize
@@ -12033,16 +12033,36 @@ following commands:
@smallexample
@kbd{objcopy --only-keep-debug foo foo.debug}
@kbd{strip -g foo}
-@kbd{objcopy --add-gnu-debuglink="foo.debug" "foo"}
@end smallexample
@noindent
These commands remove the debugging
-information from the executable file @file{foo}, place it in the file
-@file{foo.debug}, and leave behind a debug link in @file{foo}. Ulrich
-Drepper's @file{elfutils} package, starting with version 0.53, contains
+information from the executable file @file{foo} and place it in the file
+@file{foo.debug}. You can use the first, second or both methods to link the
+two files:
+
+@itemize @bullet
+@item
+The debug link method needs the following additional command to also leave
+behind a debug link in @file{foo}:
+
+@smallexample
+@kbd{objcopy --add-gnu-debuglink=foo.debug foo}
+@end smallexample
+
+Ulrich Drepper's @file{elfutils} package, starting with version 0.53, contains
a version of the @code{strip} command such that the command @kbd{strip foo -f
-foo.debug} has the same functionality as the three commands above.
+foo.debug} has the same functionality as the two separating commands and the
+one linking command above.
+
+@item
+Build ID gets embedded into the main executable using @code{ld --build-id} or
+the @value{NGCC} counterpart @code{gcc -Wl,--build-id}. Build ID support plus
+compatibility fixes for debug files separation are present in @sc{gnu} binary
+utilities (Binutils) since version 2.17.50.0.18.
+@end itemize
+
+@noindent
Since there are many different ways to compute CRC's for the debug
link (different polynomials, reversals, byte ordering, etc.), the