Merge branch 'master' into external_pager_mechanism

Conflicts:
	microkernel/mach/external_pager_mechanism.mdwn

1 files changed, 29 insertions, 0 deletions

diff --git a/gdb/backtrace.mdwn b/gdb/backtrace.mdwn
new file mode 100644
index 00000000..7411ad05
--- /dev/null
+++ b/gdb/backtrace.mdwn
@@ -0,0 +1,29 @@
+[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]]
+
+[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
+id="license" text="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]]."]]"""]]
+
+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|hurd/running/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.