Annotation of www/ddb.html, Revision 1.6
1.1 beck 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD kernel crash reports</title>
5: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6: <meta name="description" content="How to report an OpenBSD kernel crash">
7: <meta name="copyright" content="This document copyright 1998-2004 by OpenBSD.">
8: <link rel="canonical" href="http://www.openbsd.org/report.html">
9: </head>
10:
11: <body bgcolor="#ffffff" text="#000000" link="#23238e">
12: <a href="index.html"><img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" border="0"></a>
13: <p>
14: <h2><font color="#e00000">Extracting useful information from kernel crashes</font></h2>
15: <hr>
16:
17: <h3><font color="#0000e0">Minimum information for kernel problems</font></h3>
18:
1.6 ! tb 19: Familiarize yourself with
! 20: <a href="report.html">the general bug reporting procedures</a>
! 21: first.
! 22: All of that will apply.
1.1 beck 23: When reporting a kernel panic or crash, please remember:
24:
25: <ul>
1.6 ! tb 26: <li><em>We need the console output on the screen</em>.
! 27: Capture it and save it.
! 28: Serial consoles are best, but if you are on a VGA console you can
! 29: <a HREF="http://www.openbsd.org/faq/faq7.html">scroll the console back</a>
! 30: and take readable pictures with a phone or camera.<BR>
! 31:
! 32: <li><em>If the kernel panicked we need the traceback.</em>
! 33: It may be displayed on the screen.
! 34: If you are at a
! 35: <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&sektion=4&">ddb</a>></tt>
! 36: prompt, type <tt>trace</tt>.
! 37: If you are running SMP, use the <tt>mach ddbcpu N</tt> command for each
! 38: of the <tt>N</tt> processors you have and repeat the <tt>trace</tt>
! 39: command for each processor.<BR>
1.1 beck 40:
1.6 ! tb 41: <li><em>We need the process list.</em>
! 42: Use the command <tt>ps</tt> to get us that.
1.1 beck 43: </ul>
44:
1.6 ! tb 45: <em>
! 46: Reports without the above information are useless.
! 47: This is the minimum we need to be able to track down the issue.
! 48: </em>
1.1 beck 49:
50: <h3><font color="#0000e0">Additional information you can send</font></h3>
51: <P>
1.6 ! tb 52: In some situations more information is desirable.
! 53: Below are outlined some additional steps you can take in certain situations:
1.1 beck 54: <ul>
1.3 beck 55: <li> ... XXX boot crash? XXX
56: <li> ... XXX show regs? XXX
1.6 ! tb 57: <li> <em>If your crash appears to involve filesystems.</em>
! 58: The following additional things would be helpful
1.3 beck 59: <ul>
1.6 ! tb 60: <li> The output of the
! 61: <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&sektion=4&">ddb</a>></tt>
! 62: command <tt>show uvm</tt>
! 63: <li> The output of the
! 64: <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&sektion=4&">ddb</a>></tt>
! 65: command <tt>show bcstats</tt>
! 66: <li> The output of the <tt>mount</tt> command from your running machine,
! 67: so we know what filesystems are mounted and how.
1.3 beck 68: </ul>
1.6 ! tb 69: <li> <em>If your crash appears to involve hibernate/resume.</em> XXX
1.3 beck 70: </li>
71:
1.1 beck 72: </ul>
73:
74: <p>
75: </body>
76: </html>