Save a Memory Dump for debugging Crashes: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
Freyk (talk | contribs)
Bikerdude (talk | contribs)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
DarkRadiant or TheDarkMod 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 process 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.
DarkRadiant or TheDarkMod crashed? If you don't want that to happen again, you need to help the team to debug this malfunction <br>
You can do this by dumping process 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.


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.
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]. <br>
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.


In principle, recording memory dumps is not limited to crashed applications. It is possible to record memory dump of alive process, although in most cases such dump would be useless.
In principle, recording memory dumps is not limited to crashed applications.<br>
It is possible to record memory dump of alive process, although in most cases such dump would be useless.<br>


Note: At the moment this only applies to the Windows OS.
<b>Note:</b>
There is similar mechanism (core dumps) on Linux environments, but it is not covered by this article yet.
* At the moment this only applies to the Windows OS.<br>
* There is similar mechanism (core dumps) on Linux environments, but it is not covered by this article yet.


There a several methods to record a memory dump:
* Record the memory dump manually, when the application is crashing. (see following chapter)
* Record the memory dump automatically, when the application is crashing. (see chapter: "Alternative approach" on this article)
<br>


== Enable Memory Dumps ==
== Enable Memory Dumps ==
Line 20: Line 19:
<br><br>
<br><br>
If you don't get that window showing up for you, please check the WER flag in registry editor:
If you don't get that window showing up for you, please check the WER flag in registry editor:
# open the Registry Editor <br>
* Run the Registry Editor
# Locate under the key <tt>HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting</tt>,
* Find path: <tt>HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting</tt>
# create at that location the DWORD <tt>DontShowUI</tt> and give it the value <tt>0</tt>.
* Create <tt>DWORD</tt> (32bit) key with name <tt>DontShowUI</tt> and value <tt>0</tt>
# Close the windows registry window, you don't need it anymore
 
<br> Or do the same thing, by following procedure:
See alternative method here: https://superuser.com/a/1349113
# Press Windows-key + R, type in "cmd", and press Ctrl+Shift+Enter to run it with admin rights.
# A black window of console will appear. Check the title bar and make sure it is running with administrator rights.
# Execute the following commands in the console (copy/paste the following line with Ctrl+C / Ctrl+V):
# <tt>reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting" /t REG_DWORD /v "DontShowUI" /d "0x0"</tt>
# Close the console, you don't need it anymore
<br>
See alternative approach here: https://superuser.com/a/1349113


== Record Memory Dumps ==
== Record Memory Dumps ==
Line 49: Line 41:
<br>
<br>


== Enable and Record Memory Dumps Automatically (alternative approach) ==
== Compress and upload the dump ==
 
Depending on what you had opened in DarkRadiant or what FM you loaded in the game itself, the .dmp file might end up very large,<br>
so it's best to compress it by right-clicking it and selecting "Send to..." > "Compressed (zip) folder". <br>(Or use 7-zip to compress the file)<br>
Upload that folder to some place in the web, and please go to the forums to tell the devs about your crash dump.
<br><br>
'''Thanks for your time''',<br>we know that recording and uploading crash dumps might be tedious, <br> but without we really can't do much about the crash, so your help is appreciated!
 
== Debugging / Analysis ==
Coders might want to check out the article on [[Analyze_a_Memory_Dump|analyzing a memory dump.]]
 


It is possible to enable automatic saving of crash dumps for a particular program,<br> although it is more complicated to enable it.<br>
== Record Memory Dumps automatically (alternative approach) ==
The process is also described in [https://docs.microsoft.com/en-us/windows/win32/wer/collecting-user-mode-dumps Windows User-Mode Dumps].
 
When the "darkradiant has stopped working" popup doesnt appear, when the program crashes,<br>
then is possible to enable automatic saving of crash dumps, <br>
This way is not recommended since it is more complicated to setup.<br>
It is also described in [https://docs.microsoft.com/en-us/windows/win32/wer/collecting-user-mode-dumps Windows User-Mode Dumps].


# Press Windows-key + R, type in "cmd", and press Ctrl+Shift+Enter to run it with admin rights.
# Press Windows-key + R, type in "cmd", and press Ctrl+Shift+Enter to run it with admin rights.
Line 63: Line 69:
# <tt>net start WerSvc</tt> <br>(if there is a windows service named "Windows Error Reporting Service")
# <tt>net start WerSvc</tt> <br>(if there is a windows service named "Windows Error Reporting Service")
# Close the console, you don't need it anymore.
# Close the console, you don't need it anymore.
 
<br>
Now you can run TDM as usual (run executable TheDarkModx64.exe).
Now you can run TDM as usual (run executable TheDarkModx64.exe).<br>
If it crashes, a dump will be recorded and saved at <tt>C:\temp\CrashDumps</tt>.
If it crashes, a dump will be recorded and saved at <tt>C:\temp\CrashDumps</tt>.<br>
 
<br>
Here is how you can disable automatic saving of memory dumps for TheDarkModx64.exe:
After this you need to disable automatic saving of memory dumps for TheDarkModx64.exe:
# Run console (cmd) with admin rights the same way you did it when you enabled dumps, then execute:
# Press Windows-key + R, type in "cmd", and press Ctrl+Shift+Enter to run it with admin rights.
# A black window of console will appear. Check the title bar and make sure it is running with administrator rights.
# Execute the following commands in the console (copy/paste them with Ctrl+C / Ctrl+V):
# <tt>reg delete "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe"</tt>
# <tt>reg delete "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe"</tt>
 
<br>
Alternatively, you can add/remove registry keys directly in Registry Editor if you like.
Alternatively, you can add/remove registry keys directly in Registry Editor if you like.
In this case, restart Windows instead of starting WerSvc service.
In this case, restart Windows instead of starting WerSvc service.<br>
<br>
<br>
 
== Compress and upload the dump ==
 
Depending on what you had opened in DarkRadiant or what FM you loaded in the game itself, the .dmp file might end up very large,<br>
so it's best to compress it by right-clicking it and selecting "Send to..." > "Compressed (zip) folder". <br>(Or use 7-zip to compress the file)<br>
Upload that folder to some place in the web, and please go to the forums to tell the devs about your crash dump.
<br><br>
'''Thanks for your time''',<br>we know that recording and uploading crash dumps might be tedious, <br> but without we really can't do much about the crash, so your help is appreciated!
 
== Debugging / Analysis ==
Coders might want to check out the article on [[Analyze_a_Memory_Dump|analyzing a memory dump.]]





Latest revision as of 20:09, 18 March 2024

DarkRadiant or TheDarkMod 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 process 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.

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.

In principle, recording memory dumps is not limited to crashed applications.
It is possible to record memory dump of alive process, although in most cases such dump would be useless.

Note:

  • At the moment this only applies to the Windows OS.
  • There is similar mechanism (core dumps) on Linux environments, but it is not covered by this article yet.


Enable Memory Dumps

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



If you don't get that window showing up for you, please check the WER flag in registry editor:

  • Run the Registry Editor
  • Find path: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting
  • Create DWORD (32bit) key with name DontShowUI and value 0

See alternative method here: https://superuser.com/a/1349113

Record Memory Dumps

  1. When the dialog appears, keep that window open, don't close that dialog, instead open your Task Manager.
    To open the Task Manager, press Ctrl + Shift + Escape.
    Another way is to hit Windows + R and type "taskmgr" and click OK.
  2. In the Task Manager, switch to the Processes tab and locate the program which crashed (DarkRadiant.exe, TheDarkModx64.exe or tdm_installer.exe).
    It should be in that list since you still have the "XXX has stopped working" dialog open in the background.
  3. Now right-click the line with the name of the crashed program and select "Create dump file":
  4. It will work a bit and then show you something like this: "The file has been sucessfully created. The file is located at: location"
  5. 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.








Compress and upload the dump

Depending on what you had opened in DarkRadiant or what FM you loaded in the game itself, the .dmp file might end up very large,
so it's best to compress it by right-clicking it and selecting "Send to..." > "Compressed (zip) folder".
(Or use 7-zip to compress the file)
Upload that folder to some place in the web, and please go to the forums to tell the devs about your crash dump.

Thanks for your time,
we know that recording and uploading crash dumps might be tedious,
but without we really can't do much about the crash, so your help is appreciated!

Debugging / Analysis

Coders might want to check out the article on analyzing a memory dump.


Record Memory Dumps automatically (alternative approach)

When the "darkradiant has stopped working" popup doesnt appear, when the program crashes,
then is possible to enable automatic saving of crash dumps,
This way is not recommended since it is more complicated to setup.
It is also described in Windows User-Mode Dumps.

  1. Press Windows-key + R, type in "cmd", and press Ctrl+Shift+Enter to run it with admin rights.
  2. A black window of console will appear. Check the title bar and make sure it is running with administrator rights.
  3. Execute the following commands in the console (copy/paste them with Ctrl+C / Ctrl+V):
  4. reg add "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe" /t REG_SZ /v "DumpFolder" /d "c:\temp\CrashDumps"
  5. reg add "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe" /t REG_DWORD /v "DumpCount" /d "0x1"
  6. reg add "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe" /t REG_DWORD /v "DumpType" /d "0x2"
  7. reg add "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe" /t REG_DWORD /v "CustomDumpFlags" /d "0"
  8. net start WerSvc
    (if there is a windows service named "Windows Error Reporting Service")
  9. Close the console, you don't need it anymore.


Now you can run TDM as usual (run executable TheDarkModx64.exe).
If it crashes, a dump will be recorded and saved at C:\temp\CrashDumps.

After this you need to disable automatic saving of memory dumps for TheDarkModx64.exe:

  1. Press Windows-key + R, type in "cmd", and press Ctrl+Shift+Enter to run it with admin rights.
  2. A black window of console will appear. Check the title bar and make sure it is running with administrator rights.
  3. Execute the following commands in the console (copy/paste them with Ctrl+C / Ctrl+V):
  4. reg delete "HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps\TheDarkModx64.exe"


Alternatively, you can add/remove registry keys directly in Registry Editor if you like. In this case, restart Windows instead of starting WerSvc service.