[BACK]Return to ddb.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/ddb.html, Revision 1.5

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.4       deraadt    19: Familiarize yourself with <a href="report.html">the general bug reporting procedures</a>
                     20: first. All of that will apply.
1.1       beck       21:
                     22: When reporting a kernel panic or crash, please remember:
                     23:
                     24: <ul>
                     25: <li><em>We need the console output on the screen</em>. Capture it and
                     26: save it. Serial consoles are best, but if you are on a VGA console you
                     27: can <a HREF="http://www.openbsd.org/faq/faq7.html">scroll the console
                     28: back</a> and take readable pictures with a phone or camera.<BR>
                     29:
                     30: <li><em>If the kernel paniced we need the traceback.</em> It may be
                     31: displayed on the screen.  If are at a <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&amp;sektion=4&amp;format=html">ddb</a>&gt;</tt> prompt, type <tt>trace</tt>, If you are running SMP, use the <tt>mach ddbcpu N</tt> command for each of the <tt>N</tt> processors you have and repeat the <tt>trace</tt> command for each processor.<BR>
                     32:
1.2       beck       33: <li><em>We need the process list.</em> Use the command <tt>ps</tt> to get us that.
1.1       beck       34: </ul>
                     35:
1.5     ! ajacouto   36: <em>Reports without the above information are useless. This is the minimum we need to be able to track down the issue</em>.
1.1       beck       37:
                     38: <h3><font color="#0000e0">Additional information you can send</font></h3>
                     39: <P>
                     40: In some situations more information is desirable. Below are outlined some additional steps you can take in certain situations:
                     41: <ul>
1.3       beck       42: <li> ... XXX boot crash? XXX
                     43: <li> ... XXX show regs? XXX
                     44: <li> <em>If your crash appears to involve filesystems</em> The following additional things would be helpful
                     45: <ul>
                     46: <li> The output of the <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&amp;sektion=4&amp;format=html">ddb</a>&gt;</tt> command <tt>show uvm</tt>
                     47: <li> The output of the <tt><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ddb&amp;sektion=4&amp;format=html">ddb</a>&gt;</tt> command <tt>show bcstats</tt>
                     48: <li> The output of the <tt>mount</tt> command from your running machine, so we know what filesystems are mounted and how.
                     49: </ul>
                     50: <li> <em>If you crash appears to involve hibernate/resume</em> XXX
                     51: </li>
                     52:
1.1       beck       53: </ul>
                     54:
                     55: <p>
                     56: </body>
                     57: </html>