利用者:AlexK/Breakpad

提供: wiki
< 利用者:AlexK
2018年6月29日 (金) 04:44時点におけるYamyam (トーク | 投稿記録)による版 (1版 をインポートしました)
(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

Breakpad is a library that generates a dump file after a crash on Windows, Linux and Mac. It is used in Firefox and Chrome. This library is very useful when a user experienced a crash but developers cannot reproduce it. A dump file is generated which later is analyzed against build’s symbol file to find a function which caused the crash. In additional the crash reporter will ask a user to send a dump file every time Blender crashes. That way we can provide critical fixes in timely manner.


Procedure for using breakpad:

Builder/Developer

  • Builder creates a “Release with Debug Info” build WITH_BREAKPAD and WITH_CRASHREPORTER
  • Builder uploads the build online
  • Then builder generate symbol file for compiled build using dump_syms from breakpad tools. (sometimes you must build your own dump_syms on Windows)
***/dump_syms ***/blender.exe > blender.sym

Wait
Move blender.sym to blender.pdb/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX - id inside symbol file
  • Generated symbol file then uploaded to common repository.


User

  • User downloads and installs the build
  • Build crashes
  • The crash reporter starts and asks the user to send the dump file
  • User can add name, e-mail and description.
  • The report is added to the current bug tracker. (We can have separate crash tracker.) http://projects.blender.org/tracker/?func=detail&atid=498&aid=27400&group_id=9
  • The report can be moved or assign to anyone as it is our tracker. The problem that is that user is not registered, so he cannot receive automatic follow ups.


Developer

  • Ideally server would decode dump file
BlenderCrashReporter.png
  • For now developer must manually decode dump file using stackwalk. (on Windows Cygwin should be used to compile it)
***/minidump_stackwalk ***/***.dmp /symbols

/symbols is directory with subdirectories that store 
all builds' symbol files like:
blender.pdb/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/blender.sym
  • The output will find crash function and also provide additional info.


I already wrote interface for crash reporter on Windows. In addition I wrote a function that sends dump file to the tracker using cURL so it can be reuse on every OS. Crash Reporter doesn’t have Cmake/Scons support yet. Breakpad in blender’s source code only changes 2 files and adds 2 additional so it would be easy to include in experimental branches. That way crashes would become known much faster.

in progress Inprogress100.jpg 95%
 Breakpad on Windows
in progress Inprogress25.jpg 20%
 Breakpad on Linux
to do
 Breakpad on Mac
CMake
in progress Inprogress75.jpg 75%
 
Scons
to do
 
Crashreporter UI on Windows
in progress Inprogress100.jpg 95%
 
Crashreporter UI on Linux
to do
 
Crashreporter UI on Mac
to do
 
Crashreporter Sender
in progress Inprogress100.jpg 90%
 
Dump Server analyzer
to do