Crash reports: Difference between revisions

From Miranda NG
Jump to navigation Jump to search
m (→‎Tips and tricks: +Category:Help)
(revised for better understanding)
Line 1: Line 1:
{{Languages/Crash reports}}
{{Languages/Crash reports}}
Reports generated by {{Plugin|en|CrashDumper}} by default are insufficient and of little use. To create a useful crash report you need to do the following:
Reports generated by {{Plugin|en|CrashDumper}} by default are insufficient and of little use. To create a useful crash report you need to do the following:
# Install the {{Plugin|en|CrashDumper}} plugin (see plugin card for download links)
 
# Update '''manually all''' the plugins from the corresponding source (see [[Download]]).
== Install CrashDumper ==
#* {{Plugin|en|PluginUpdater}} has ''Development version with debug symbols'' option to automatically update your plugins and download debug symbols. You should check that radio button (''Options → Services → Plugin Updater → "Files source"''), then choose ''Check for plugin updates'' in the Main menu and pass to step 5 after Miranda restarts.
Install the appropriate version of {{Plugin|en|CrashDumper}} plugin (see plugin card for download links). Also, you can download and install it automatically using {{Plugin|en|PluginUpdater}}: go to ''Main Menu → Show full plugin list'', select <tt>CrashDumper</tt> and click ''Download'' button.
# Download debug symbols archive <tt>miranda-ng-debug-symbols*.7z</tt> from the corresponding source ([http://miranda-ng.org/distr/stable/miranda-ng-debug-symbols_pdb.7z stable x32] [http://miranda-ng.org/distr/stable/miranda-ng-debug-symbols_pdb_x64.7z stable x64] / [http://miranda-ng.org/distr/miranda-ng-debug-symbols_pdb.7z latest x32] [http://miranda-ng.org/distr/miranda-ng-debug-symbols_pdb_x64.7z latest x64])
 
# Extract <tt>.pdb</tt> files named identically with your plugins from the archive to main Miranda NG folder. Do '''not''' extract anything to <tt>Plugins</tt> folder.
 
# Try to reproduce the crash. By default crashlog files (<tt>.txt</tt> and <tt>.mdmp</tt>) are saved to <tt>Profiles\<Profile_name>\CrashLog\<Current_date></tt>.
== Update your plugins and debug symbols ==
All your plugins and Miranda core files must be of the latest version. Also, the debug symbols (PDB files) must be of the same compilation as the plugins, so it is necessary to update them too (or install if you don't have any).
 
=== Manual method ===
* Update manually '''all''' the plugins from the corresponding source (see [[Download]]).
* Download debug symbols archive <tt>miranda-ng-debug-symbols*.7z</tt> from the corresponding source ([http://miranda-ng.org/distr/stable/miranda-ng-debug-symbols_pdb.7z stable x32] [http://miranda-ng.org/distr/stable/miranda-ng-debug-symbols_pdb_x64.7z stable x64] / [http://miranda-ng.org/distr/miranda-ng-debug-symbols_pdb.7z latest x32] [http://miranda-ng.org/distr/miranda-ng-debug-symbols_pdb_x64.7z latest x64])
* Extract <tt>.pdb</tt> files named identically with your plugins from the archive to main Miranda NG folder. Do '''not''' extract anything to <tt>Plugins</tt> folder.
 
=== Automatic method ===
If you {{Plugin|en|PluginUpdater}} installed you can update your plugins and download debug symbols automatically.
* Go to ''Options → Services → Plugin Updater → "Files source"''
* Select ''Development version with debug symbols'' option and click ''OK''.
* Choose ''Check for plugin updates'' in the Main menu, click ''Update'' and wait till Miranda asks for restart.
 
 
== Reproduce the crash ==
By default, crashlog files (<tt>.txt</tt> and <tt>.mdmp</tt>) are saved to <tt>Profiles\<Profile_name>\CrashLog\<Current_date></tt>.


; Examples
; Examples
# Wrong: [http://pastie.org/5456564 http://pastie.org/5456564]. Some debug symbols are missing which is denoted by lines "<tt>(filename not available) (0): (function-name not available)</tt>" with Miranda core/plugins names (Lines with <tt>USER32</tt>, <tt>ntdll</tt>, <tt>kernel32</tt>, etc. don't matter).
# Wrong: [http://pastie.org/5456564 http://pastie.org/5456564]. Some debug symbols are missing which is denoted by lines "<tt>(filename not available) (0): (function-name not available)</tt>" with Miranda core/plugins names (Lines with <tt>USER32</tt>, <tt>ntdll</tt>, <tt>kernel32</tt>, etc. don't matter).
# Right: [http://pastie.org/5456572 http://pastie.org/5456572]. All debug symbols are in place, no lines "<tt>(filename not available) (0): (function-name not available)</tt>" with Miranda core/plugins names.
# Right: [http://pastie.org/5456572 http://pastie.org/5456572]. All debug symbols are in place, no lines "<tt>(filename not available) (0): (function-name not available)</tt>" with Miranda core/plugins names.


== Tips and tricks ==
== Tips and tricks ==

Revision as of 14:33, 24 July 2013

Template:Languages/Crash reports Reports generated by CrashDumper by default are insufficient and of little use. To create a useful crash report you need to do the following:

Install CrashDumper

Install the appropriate version of CrashDumper plugin (see plugin card for download links). Also, you can download and install it automatically using PluginUpdater: go to Main Menu → Show full plugin list, select CrashDumper and click Download button.


Update your plugins and debug symbols

All your plugins and Miranda core files must be of the latest version. Also, the debug symbols (PDB files) must be of the same compilation as the plugins, so it is necessary to update them too (or install if you don't have any).

Manual method

  • Update manually all the plugins from the corresponding source (see Download).
  • Download debug symbols archive miranda-ng-debug-symbols*.7z from the corresponding source (stable x32 stable x64 / latest x32 latest x64)
  • Extract .pdb files named identically with your plugins from the archive to main Miranda NG folder. Do not extract anything to Plugins folder.

Automatic method

If you PluginUpdater installed you can update your plugins and download debug symbols automatically.

  • Go to Options → Services → Plugin Updater → "Files source"
  • Select Development version with debug symbols option and click OK.
  • Choose Check for plugin updates in the Main menu, click Update and wait till Miranda asks for restart.


Reproduce the crash

By default, crashlog files (.txt and .mdmp) are saved to Profiles\<Profile_name>\CrashLog\<Current_date>.

Examples
  1. Wrong: http://pastie.org/5456564. Some debug symbols are missing which is denoted by lines "(filename not available) (0): (function-name not available)" with Miranda core/plugins names (Lines with USER32, ntdll, kernel32, etc. don't matter).
  2. Right: http://pastie.org/5456572. All debug symbols are in place, no lines "(filename not available) (0): (function-name not available)" with Miranda core/plugins names.


Tips and tricks

  • Upload your crash reports to pastebin.com or pastie.org.
  • Each time you update the plugins you have to re-download the debug symbols.