Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Close

Symbolicator by Peter Hosey

This is a program to symbolicate crash logs generated on Mac OS X.

When you receive a crash log, pipe it through the Symbolicator. You'll probably want to send the output into a pager or editor.

symbolicator < MyApp-2009-01-01-130145_My-Computer.crash | less

The Symbolicator will use Spotlight to find any dSYM bundles it needs, and dwarfdump to extract symbol information for the addresses in the crash log; it will then replace the bare addresses in the log text with the matching symbol information, and write the symbolicated text out to its standard output.

This means:

  • You do not need to tell the Symbolicator where your dSYM bundles are, nor to put your dSYM bundles into a special location. As long as Spotlight can find them, the Symbolicator will find them automatically.
  • You can use ThisService (http://wafflesoftware.net/thisservice/) to make a Symbolicator service. With this, you can select the entire text of a crash log, use your preferred graphical editor's New Window with Selection service to copy that text to a new document, and then select the crash log text there and run your Symbolicator service on it.

Recent activity

jer...@buttered-cat.com

Commits by jer...@buttered-cat.com were pushed to boredzo/Symbolicator

8008be0 - Fixed issues handling version 9 reports (lion I think)
jer...@ambrosiasw.com

Commits by jer...@ambrosiasw.com were pushed to boredzo/Symbolicator

817ff19 - fixed resolved symbol not replacing address in outputted crash log
jer...@ambrosiasw.com

Commits by jer...@ambrosiasw.com were pushed to boredzo/Symbolicator

8ee6a37 - Fixed problem with some earlier changes with usage of a dict instead of just a string with uuids & dsyms. fixed problem with parsing binary ...
Jeremy Knope

Commits by Jeremy Knope were pushed to boredzo/Symbolicator

1a1160e - updated for some 10.6 changes to crash logs and added x86_64 and ARM to architectures map. added lookup method that uses atos used when looking ...
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.