lksnmnn/symbolicate-crashreports

This script is based on Apple's symbolicate script. With some minor changes it now symbolicates Mac and iOS crash reports from PLCrashReporter.

Symbolicate Crash Reports

This script is based on Apple's symbolicate script from 2016. It now symbolicates Mac and iOS crash reports from PLCrashReporter.

Written in Perl.

Warning

This script is unmaintained atm and is based on Apples script from 2016. Apple may ship better versions in newer XCode releases, so try to use them if this script isnt working for you.

Usage

Currently, the script has to be placed in the following directory:

XCode 7.3 and later: /Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/
XCode 7.2 and earlier: /Applications/Xcode.app/Contents/SharedFrameworks/DTDeviceKitBase.framework/Versions/A/Resources/

Make sure you have your .xcarchive file on your machine. The script should find them. The following will symbolicate your crash report and save it to readable_report.crash

Run the script

/Path/To/symbolicatecrash /Path/To/report.crash > /Path/To/readable_report.crash

or

/Path/To/symbolicatecrash -o /Path/To/readable_report.crash /Path/To/report.crash

Use -v for verbose logging.

For proper reports and symbols, set your build settings to this:

Strip Debug Symbols During Copy: Yes
Strip Style: All Symbols
Strip Linked Product: Yes

Changes

At first I fixed the search paths for the used tools (like otool, atos, ...), added x86_64 as a viable architecture and implemented a minor fix to extract the executable from the .app bundle.

If found this article particular useful: https://possiblemobile.com/2015/03/symbolicating-your-ios-crash-reports/

Known Bugs

The script only works within its previous location (the XCode package). If the report is malformed (like iOS crash reports from PLCrashReporter) it could hang. One needs to remove duplicated binaries in the original report.

Credits

You will find the original script here (at least with XCode from 2016):

/Applications/Xcode.app/Contents/SharedFrameworks/DTDeviceKitBase.framework/Versions/A/Resources/symbolicatecrash

Edited by lksnmnn

Copyright (c) 2008-2011 Apple Inc. All Rights Reserved.

symbolicate-crashreports's Issues

Usage example :

Hi,

I'm currently looking to symbolicate some kernel panic log I've got.
Currently I'm doing it manually .. for each address in the backtrace, I find within which driver range it's found, then I call that address with 'atos' in order to find it's matching function:line in the following manner :

atos -o <pathToDriverMacho> -l <driverBaseAddress> <addressFromBacktrace>

the backtrace can contain several drivers involved, all are listed below with their corresponding address range :

panic(cpu 0 caller 0xffffff800917ff59): "Releasing non-exclusive RW lock without a reader refcount!"@/BuildRoot/Library/Caches/com.apple.xbs/Sources/xnu/xnu-4570.51.1/osfmk/i386/locks_i386.c:1254 Backtrace (CPU 0), Frame : Return Address 0xffffff80690a3010 : 0xffffff800906e166 0xffffff80690a3060 : 0xffffff8009196714 0xffffff80690a30a0 : 0xffffff8009188a00 0xffffff80690a3120 : 0xffffff8009020180 0xffffff80690a3140 : 0xffffff800906dbdc 0xffffff80690a3270 : 0xffffff800906d99c 0xffffff80690a32d0 : 0xffffff800917ff59 0xffffff80690a3300 : 0xffffff800918010e 0xffffff80690a3320 : 0xffffff7f8a4621b0 0xffffff80690a33f0 : 0xffffff7f8a4625cc 0xffffff80690a3460 : 0xffffff7f8a43c4ba 0xffffff80690a3540 : 0xffffff7f8a410152 0xffffff80690a3d60 : 0xffffff80092cfa56 0xffffff80690a3de0 : 0xffffff80092b6b74 0xffffff80690a3f10 : 0xffffff80092b6da7 0xffffff80690a3f40 : 0xffffff8009604418 0xffffff80690a3fa0 : 0xffffff8009020966 Kernel Extensions in backtrace: com.apple.filesystems.apfs(748.51)[4E26C92D-330B-33A8-8DA7-C1498DD86AB7]@0xffffff7f8a3da000->0xffffff7f8a4bffff dependency: com.apple.kec.corecrypto(1.0)[CA65BD09-4559-3507-A72B-733ED9110DF1]@0xffffff7f89faf000 dependency: com.apple.driver.AppleEffaceableStorage(1.0)[6B49B846-2852-3D7C-BD45-E70DC2684A8E]@0xffffff7f8a33e000 dependency: com.apple.iokit.IOStorageFamily(2.1)[F27A8A2A-6662-3608-83BD-415037509E01]@0xffffff7f89ab7000

it seems like this script perform this routine automatically. but doesn't come with usage example, perhaps you can provide one ?

thanks

Fails with Xcode 9 (Is this still supported?)

Does this work on Xcode 9?

I'm running into errors when I try to use it.

/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash Esa-super-easy-timer-crash-1-0-23.crash > readable_report.crash
sh: /Applications/Xcode.app/Contents/Developer/usr/bin/xcrun: No such file or directory
Error: can't find tool named 'otool' in the macosx SDK or any fallback SDKs at /Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash line 115.