Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Library:Breakpad

From ReverseEngineering.wiki
Library
Developer Google
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 ./symbols prints 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