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