Skip to content

Latest commit

 

History

History
30 lines (21 loc) · 1.51 KB

README.md

File metadata and controls

30 lines (21 loc) · 1.51 KB
Raw

crash-handler

This repository contains the crash handler used in Chatterino. The crash handler uses crashpad to capture exception information and restarts the application when a crash is captured.

The following annotations are used:

  • exePath (required): an absolute path to the client executable
  • canRestart (required): a boolean whether the handler should restart the client (true or false)
  • startedAt (required): a UTC timestamp in ISO 8601 when the client was started
  • exeArguments (optional): an encoded argument string for the client executable. Spaces are encoded as '+' and a plus is escaped by another plus ('+' → '++').

In addition to the arguments specified in exeArguments, the handler will start the client with the following arguments:

  • --crash-recovery
  • --cr-exception-code <code>: the numeric, native, platform-specific code of the exception that occurred
  • --cr-exception-message <message>: text version of the exception code (potentially with more context)

Building

This project is built with CMake. Currently, only Windows is supported. Run the following commands in a prompt with Visual Studio environment variables.

git clone --recurse-submodules https://github.com/Chatterino/crash-handler
cd crash-handler
cmake -G Ninja -B build
ninja -C build

The executable can be found in build/bin/crashpad/crashpad-handler.exe.