https://github.com/electron/symbolicate-mac
Symbolicate macOS Electron crash reports
https://github.com/electron/symbolicate-mac
Last synced: about 1 year ago
JSON representation
Symbolicate macOS Electron crash reports
- Host: GitHub
- URL: https://github.com/electron/symbolicate-mac
- Owner: electron
- License: isc
- Created: 2019-06-11T18:37:18.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-26T14:02:24.000Z (over 1 year ago)
- Last Synced: 2024-10-29T14:58:34.177Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 721 KB
- Stars: 31
- Watchers: 8
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# @electron/symbolicate-mac
[](https://github.com/electron/symbolicate-mac/actions/workflows/test.yml)
[](https://npmjs.org/package/@electron/symbolicate-mac)
Symbolicate an [Electron](https://www.electronjs.org/) macOS crash report that is
missing symbols. Wraps [parse-breakpad](https://github.com/nornagon/parse-breakpad) with
convenient parsing and downloading of symbol files.
This tool downloads the symbol files needed to symbolicate and stores them in a
`cache` folder relative to the module. These files are large (~400MB) and may
take some time download initially.
```
$ npx @electron/symbolicate-mac /path/to/crash
```
Note that the crash file must be the _full_ crash, including the "Binary
Images" section, or else symbolicate-mac won't be able to discover which exact
version of Electron to use.
## Usage
- Obtain a complete crash dump, sampling report, or spindump.
```
Process: Slack [2214]
Path: /Applications/Slack.app/Contents/MacOS/Slack
Identifier: com.tinyspeck.slackmacgap
Thread 0 Crashed:: Dispatch queue: com.apple.main-thread
[...]
91 com.github.Electron.framework 0x000000010ae32a06 v8::internal::SetupIsolateDelegate::SetupHeap(v8::internal::Heap*) + 2919558
92 com.github.Electron.framework 0x000000010ae36119 v8::internal::SetupIsolateDelegate::SetupHeap(v8::internal::Heap*) + 2933657
[...]
Binary Images:
0x109ae8000 - 0x109b37fcf +com.tinyspeck.slackmacgap (4.18.0 - 6748) /Applications/Slack.app/Contents/MacOS/Slack
0x109b49000 - 0x1115c0f7f +com.github.Electron.framework (13.1.6) <36C7F681-FAD6-3CD1-B327-6C1054C359C7> /Applications/Slack.app/Contents/Frameworks/Electron Framework.framework/Versions/A/Electron Framework
[...]
```
- Run `@electron/symbolicate-mac` and specify the path to the file
```sh
npx @electron/symbolicate-mac /path/to/crash.txt
```
- The crash will be printed out, with symbols resolved:
```
[...]
91 com.github.Electron.framework 0x000000010ae32a06 content::BrowserMainLoop::EarlyInitialization()
92 com.github.Electron.framework 0x000000010ae36119 content::BrowserMainRunnerImpl::Initialize(content::MainFunctionParams const&)
[...]
```