summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--hurd/debugging.mdwn1
-rw-r--r--hurd/debugging/gdb.mdwn2
-rw-r--r--hurd/debugging/gdb/backtrace.mdwn27
3 files changed, 30 insertions, 0 deletions
diff --git a/hurd/debugging.mdwn b/hurd/debugging.mdwn
index 5a825479..5f4184e3 100644
--- a/hurd/debugging.mdwn
+++ b/hurd/debugging.mdwn
@@ -9,6 +9,7 @@ is included in the section entitled
# Strategies
* [[GDB]] -- the GNU debugger
+ * [[gdb/Backtrace]]s
* [[subhurd]] -- running another Hurd system in parallel
* [[rpctrace]] -- tracing [[RPC]]s
diff --git a/hurd/debugging/gdb.mdwn b/hurd/debugging/gdb.mdwn
index 02c66711..d9d6de02 100644
--- a/hurd/debugging/gdb.mdwn
+++ b/hurd/debugging/gdb.mdwn
@@ -12,6 +12,8 @@ features](http://sourceware.org/gdb/current/onlinedocs/gdb_19.html#Hurd%20Native
to offer, such as [[noninvasive_debugging]] (for avoiding [[deadlock]]s), for
example.
+* [[Backtrace]]s
+
* [Manual](http://sourceware.org/gdb/documentation/)
* [When disassemble doesn't work](http://lists.gnu.org/archive/html/bug-hurd/2007-02/msg00039.html)
diff --git a/hurd/debugging/gdb/backtrace.mdwn b/hurd/debugging/gdb/backtrace.mdwn
new file mode 100644
index 00000000..62067392
--- /dev/null
+++ b/hurd/debugging/gdb/backtrace.mdwn
@@ -0,0 +1,27 @@
+[[meta copyright="Copyright © 2007 Free Software Foundation, Inc."]]
+[[meta license="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
+is included in the section entitled
+[[GNU_Free_Documentation_License|/fdl.txt]]."]]
+
+When someone asks you to supply a backtrace (from a [[segmentation_fault]], for
+example), here is roughly what you have to do.
+
+Run the faulting program like this:
+
+ $ gdb --args PROGRAM [ARGUMENTS]
+ [...]
+ (gdb) run
+ [...]
+ [Segmentation fault.]
+ (gdb) bt
+ [...]
+
+(!) This will only provide useful information if the executable (and additional
+libraries) contain debugging symbols, or those are available separartely.
+
+If you're one a [[Debian_GNU/Hurd_system|running/distrib/debian]], you'll have
+to have the *hurd-dbg* package installed for debugging Hurd stuff, and perhaps
+*libc0.3-dbg* as well if it's inside the glibc.