Depending on whether the symbols were included in the binary of an application or whether .dSYM files could be located at the time of the crash, functions in the backtraces of a report may be presented by their names or only as addresses. The stack frames may also include the file names and line numbers containing the code.

If those pieces of informations could not be retrieved at the time of the crash, it is still possible to obtain them as long as you have access to the .dSYM files for the binary, frameworks or plugins. This is what the symbolication process does in Unexpectedly.

By default, Unexpectedly will perform the symbolication process for all reports, even those that already contain the function names, file names and line numbers. If you want to disable the symbolication process, use the Symbolication Preferences Pane.

To symbolicate a report, Unexpectedly proceeds as follows:

1. For each stack frame of the backtraces, Unexpectedly finds the binary image that contains the function of the stack frame.
2. Unexpectedly checks whether the symbol file for the build UUID of the corresponding binary image is listed in the symbol files registry.
3. If the symbol file is not in the registry yet, Unexpectedly looks for the symbol file on disk using Spotlight and, if it finds it, adds it to the registry.
4. If the symbol file can be located, Unexpectedly looks for the debug information contained in the symbol files to retrieve the function name, the path of the source file and the line number in the code.
5. If the information can be found, Unexpectedly injects the information inside the stack trace representation.

Description forthcoming

If Unexpectedly was able to find the source file for the stack frame and if the source file is available on the computer at the referenced path, then the source file name will be underlined.

Description forthcoming

Description Forthcoming.

If Unexpectedly was able to find the source file for the stack frame and if the source file is available on the computer at the referenced path, then the source file name will have a follow link button on its right.