Library:Crashpad
| 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_infoon Mach-O, sectionCPADinfoon Windows PE, and a.note.crashpad.infoELF 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, asettings.datfile, and per report a<uuid>.dmp,<uuid>.metaand lock file. - Windows:
reports/holding<uuid>.dmp, per-state metadata filemetadata, andsettings.dat. - macOS:
pendingandcompleteddirectories with.dmpfiles. settings.datbegins 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