| <?php |
| $title = "Getting a Useful Crash Log"; |
| include("../header.inc"); |
| ?> |
| <h2>Getting a Useful Crash Log</h2> |
| <p>Crash logs are incredibly useful when trying to track down a bug, especially if it's not immediately reproducible.</p> |
| |
| <div class="mac-instructions" id="mac"> |
| <h4>Mac OS X</h4> |
| <p>Obtaining a crash log on Mac OS X is incredibly easy since it automatically creates easily accessible crash logs for you.</p> |
| <ol> |
| <li> |
| <p>If WebKit has just crashed or you can easily reproduce the crash, press the Report button on the CrashReporter dialog box |
| to view the crash information.</p> |
| <img src="mac_reportbox.jpg" alt="Mac OS X Crash report box"> |
| </li> |
| <li> |
| <p>Copy and paste the entire contents of the top portion of the CrashReporter window into your favorite text editor and |
| upload it as an attachment in Bugzilla.</p> |
| <img src="mac_viewtrace.jpg" alt="Mac OS X Crash log"> |
| </li> |
| <li> |
| <p>If the crash report dialog does not appear or the crash is hard to reproduce, you can get the crash log from the |
| <tt>Safari.crash.log</tt> file located in <tt>~/Library/Logs/CrashReporter/</tt>. This file is a plain text file and can |
| be viewed in the default Console.app or your favorite text editor.</p> |
| |
| <p><strong>All</strong> of Safari's crashes are logged to this file so please only attach the last crash in it. |
| Crashes are separated by a series of asterisks (∗∗∗∗∗∗∗∗∗∗) |
| for easy identification.</p> |
| </li> |
| </ol> |
| </div> |
| |
| <div class="windows-instructions" id="win"> |
| <h4>Windows XP</h4> |
| <p>Windows XP does not automatically log crashes like OS X, but it does include Dr. Watson, an easy to set up tool that can be |
| configured to log them.</p> |
| <ol> |
| <li> |
| <p>In the Start menu's Run box or from a DOS or Cygwin prompt, enter the command <tt>drwtsn32 -i</tt>.</p> |
| <img src="win_installwatson.jpg" alt="Dr Watson install command"> |
| </li> |
| <li> |
| <p>A dialog box will appear informing you that Dr. Watson has been installed as the default debugger. Press OK.</p> |
| <img src="win_watsoninstalled.jpg" alt="Dr Watson was installed box"> |
| </li> |
| <li> |
| <p>Crash information will now be logged to the <tt>user.dmp</tt> file in |
| <tt>C:\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson\</tt>.</p> |
| |
| <p>Dr. Watson will create a <tt>user.dmp</tt> file that records what WebKit was doing when it crashed. |
| Be careful as it is overwritten with every crash.</p> |
| |
| <p>When reporting a WebKit bug, please upload the <tt>user.dmp</tt> file if possible.</p> |
| </li> |
| <li> |
| <p>Running <tt>drwtsn32</tt> without any options or switches will bring up a window that allows you to change various |
| setting such as moving the log folder to a more easily accessible location or throwing a visual alert letting |
| you know it caught the crash.</p> |
| <img src="win_watsongui.jpg" alt="Dr Watson window"> |
| </li> |
| </ol> |
| </div> |
| |
| <?php |
| include("../footer.inc"); |
| ?> |