Add a Faq about the kernel debugging prompt
[hurd-web.git] / faq / issues / got_a_db_prompt.mdwn
diff --git a/faq/issues/got_a_db_prompt.mdwn b/faq/issues/got_a_db_prompt.mdwn
new file mode 100644 (file)
index 0000000..0835520
--- /dev/null
@@ -0,0 +1,28 @@
+[[!meta copyright="Copyright © 2013 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]]."]]"""]]
+
+[[!meta title="I've just gotten a db> prompt"]]
+
+Something bad happened in the kernel (think of it as the equivalent of the Linux
+Oops). The `db>` prompt is actually the kernel debugger. You can then type the
+`trace` command, which will bring you something like:
+
+    0x8007cf1(8088488,5e,40000008,2aa008,0)
+    0x80071bc(0,0,0,0,0)
+    0x8006831(24fe00,2000,b,800,0)
+
+Which is actually the function call trace, which can be decyphered by using:
+
+    $ addr2line -i -f -e /boot/gnumach 0x8007cf1 0x80071bc 0x8006831
+
+You can then send us the result of the `trace` and the `addr2line`, as well as
+the exact version of the gnumach kernel you were running, for further
+investigation. [[More information about the gnumach
+debugger|microkernel/mach/gnumach/debugging]] is available.