Library:Breakpad
| Developer | |
|---|---|
| License | BSD-3-Clause |
| Website | https://chromium.googlesource.com/breakpad/breakpad |
| On this wiki | Facts · Code · Notes · Topics |
Google Breakpad (BSD-3-Clause): crash reporting library and tools that write Format:Minidump files on Windows, macOS, Linux and Android, and process them with text symbol files (dump_syms, minidump_stackwalk).
Identification
Apps embedding Breakpad contain the client classes ExceptionHandler and MinidumpDescriptor (RTTI/symbol names google_breakpad::ExceptionHandler, google_breakpad::MinidumpDescriptor), and often ship crash_generation_*, crashreporter or a separate sender. On Linux the handler uses a signal handler and a cloned writer process; the output is a Format:Minidump (magic MDMP) even on Linux.
Tools in the repository (src/tools, src/processor)
dump_syms(per platform: Linux, macOS, Windows): reads DWARF/STABS, Mach-O or PDB and writes a Format:Breakpad symbol file.minidump_stackwalk(src/processor/minidump_stackwalk.cc):minidump_stackwalk minidump.dmp ./symbolsprints a symbolized stack trace to stdout and verbose logging to stderr. The symbols directory must hold<module name>/<debug id>/<module name>.sym, taken from the file's MODULE line (docs/linux_starter_guide.md).microdump_stackwalk,sym_upload(upload protocol in docs/sym_upload_v2_protocol.md:/symbols/<debug_file>/<debug_id>:checkStatus?key=<key>).
Stack walking uses STACK CFI / STACK WIN records first, then frame-pointer and stack-scanning heuristics (docs/stack_walking.md, Unverified here).
Forks and successors
Library:Crashpad replaces Breakpad in Chromium; Library:Sentry Native can use Breakpad as one of its backends (getsentry/breakpad fork).
Related: Format:Minidump, Format:Breakpad symbol file, Technique:Identifying crash reporting SDKs.
Code & repositories
- https://github.com/google/breakpad @
94c818ea27482d8a8d32b0c8de50cbca0270db9a· license: BSD-3-Clause (declared by the contributor for the files used; GitHub reports MIT (read from LICENSE; GitHub's API was busy) for the repository)
Breakpad client, dump_syms, minidump_stackwalk and symbol_files.md
Tested on: source read, not run: source read, not run · checked 2026-10-18