Save a Memory Dump for debugging Crashes: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
Created page with "Your DarkRadiant application crashed? If you don't want that to happen again, you need to help the team to debug this malfunction - you can do this by dumping DarkRadiant's me..."
 
No edit summary
Line 1: Line 1:
Your DarkRadiant application crashed? If you don't want that to happen again, you need to help the team to debug this malfunction - you can do this by dumping DarkRadiant's memory to a file, which can then be used by developers to debug and inspect the application's state at the point in time it crashed. (Note: At the moment this only applies to the Windows version of DarkRadiant, I don't know if there's something similar available for Linux environments.)
Your DarkRadiant application crashed? If you don't want that to happen again, you need to help the team to debug this malfunction - you can do this by dumping DarkRadiant's memory to a file, which can then be used by developers to debug and inspect the application's state at the point in time it crashed. (Note: At the moment this only applies to the Windows version of DarkRadiant, I don't know if there's something similar available for Linux environments.)


If a crash is reproducible, it might be enough to describe the exact steps that lead up to the fault and file a bug report on the [[tracker http://bugs.thedarkmod.com]]. But more often than sometimes crashes occur out of seemingly nothing and are barely reproducible, and in this case a saved memory dump is even more valuable for debugging purposes.
If a crash is reproducible, it might be enough to describe the exact steps that lead up to the fault and file a bug report on the [http://bugs.thedarkmod.com bugtracker]. But more often than sometimes crashes occur out of seemingly nothing and are barely reproducible, and in this case a saved memory dump is even more valuable for debugging purposes.


== How to record the Dump ==
== How to record the Dump ==

Revision as of 10:22, 24 May 2016

Your DarkRadiant application crashed? If you don't want that to happen again, you need to help the team to debug this malfunction - you can do this by dumping DarkRadiant's memory to a file, which can then be used by developers to debug and inspect the application's state at the point in time it crashed. (Note: At the moment this only applies to the Windows version of DarkRadiant, I don't know if there's something similar available for Linux environments.)

If a crash is reproducible, it might be enough to describe the exact steps that lead up to the fault and file a bug report on the bugtracker. But more often than sometimes crashes occur out of seemingly nothing and are barely reproducible, and in this case a saved memory dump is even more valuable for debugging purposes.

How to record the Dump

When DarkRadiant crashes, it usually shows a dialog like this:

Keep that window open, don't close that dialog, instead open your Task Manager. To open the Task Manager, hit Windows-R and type "taskmgr" and click OK. In the Task Manager, switch to the Processes tab and locate the DarkRadiant.exe, it should be in that list since you still have the "DarkRadiant has stopped working" dialog open in the background.

Now right-click the DarkRadiant.exe line and select "Create dump file..."

it will work a bit and then show you something like this:

Open Windows Explorer and head to the location indicated in the dialog. Note that you can mark and copy the location from that dialog using your mouse, so you don't have to type it in entirely. Depending on what you had opened in DarkRadiant, the .dmp file might end up very large, so it's best to compress it now using 7-zip or by right-clicking it and selecting "Send to..." > "Compressed (zip) folder".

Upload that folder to some place in the web, and please go to the forums to tell the devs about your crash dump. Be thanked for your time, I know that recording and uploading crash dumps might be tedious, but without I really can't do much about the crash, so your help is appreciated!