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:Crashpad

From ReverseEngineering.wiki
Library
Developer Google / Chromium
License Apache-2.0
Website https://chromium.googlesource.com/crashpad/crashpad
On this wiki Facts · Code · Notes · Topics

Chromium's crash reporter (Apache-2.0): an in-process client plus an out-of-process crashpad_handler executable that writes Format:Minidump files into a crash report database and uploads them; used by Chrome, Electron, many games and by Sentry Native.

Identification

  • A crashpad_handler (crashpad_handler.exe) executable next to the program (or inside the app bundle; on Android it may be packaged as a library, Unverified), started with arguments such as --database=PATH, --url=URL, --annotation=KEY=VALUE, --pipe-name=PIPE, --no-rate-limit, --monitor-self (usage text in handler/handler_main.cc, getsentry/crashpad mirror).
  • Client code: crashpad::CrashpadClient::StartHandler, crashpad::CrashpadInfo. The CrashpadInfo struct starts with the 32-bit signature 'CPad' (client/crashpad_info.h) and lives in a well-known section: __DATA,crashpad_info on Mach-O, section CPADinfo on Windows PE, and a .note.crashpad.info ELF note that points to it (crashpad_info.cc). A tool scanning a module for that section can see whether it embeds Crashpad and read its simple annotations.
  • Windows clients talk to the handler over a named pipe given by --pipe-name; the handler writes the minidump, so the app itself rarely contains minidump-writing code.

Crash report database

A directory chosen by the application (--database). Layout depends on the platform backend (read from client/crash_report_database_*.cc):

  • Generic (Linux, Android): subdirectories new, pending, completed, a settings.dat file, and per report a <uuid>.dmp, <uuid>.meta and lock file.
  • Windows: reports/ holding <uuid>.dmp, per-state metadata file metadata, and settings.dat.
  • macOS: pending and completed directories with .dmp files.
  • settings.dat begins with the magic 'CPds' (client/settings.cc, kSettingsMagic) followed by version, client id (UUID), flags and last upload time (field layout Unverified).

The .dmp files are Format:Minidump files; Crashpad adds a stream carrying the annotation dictionary (key/value strings such as prod, ver, ptype, guid; names are conventions from Breakpad uploads, Unverified).

Uses

For a closed-source app, the database directory (often under the user data folder) lists crashes with module lists: each module carries its CodeView GUID/age or build id, which is the debug id for Format:Breakpad symbol file lookup. See Technique:Identifying crash reporting SDKs.

Related: Library:Breakpad, Library:Sentry Native, Library:Electron, Format:PDB (Program Database).

Code & repositories

  • https://github.com/getsentry/crashpad @ 493151b224a6536bcedc3467d042863a063addc4 · license: Apache-2.0 (read from LICENSE; GitHub's API was busy)
    Sentry's mirror/fork of Chromium Crashpad (handler, client, database)
    Tested on: source read, not run: source read, not run · checked 2026-10-18