Unexpectedly - Outline Reports

PATH Contents > Outline Reports

Outline Reports

The outline report view presents the contents of reports with a focus on backtraces.

Outline - Overview — Fig.1 - Outline report view

The outline report view is divided into 5 parts:

The jump bar.
The exception and diagnostic view
The backtraces list
The layout and presentation options bottom bar
The binary images list

To learn how to use the jump bar, see Chapter 4, Using the jump bars.

As the focus is made on backtraces in the outline report view, there are less pieces of information displayed than there are in text reports. To access these pieces of information:

Use the Inspector to get most of the information from the header section of reports.
Use the Registers window to get the state of the registers for the crashed thread.

To learn how to use the Inspector and the Registers window, see Chapter 8, Inspector and Registers window.

Exception and diagnostic view

This view presents the exception type (and signal) and the diagnostics message available in the report.

Outline - Exception and diagnostic — Fig.2 - Outline report view

Note: The view can be resized to only display the exception type.

To display more information about the type of exception:

1	Click the More Info… button.
2	Click "Open on Apple's Developer Site" if you want to know even more about the type of exception.

Backtraces view

The backtraces can be presented using a list or columns. It's up to you to choose the layout you want to use.

Outline - Backtraces — Fig.3 - Outline backtraces - List

In addition to the usual stack frame components, the origin of the binary image for the machine instruction address of a stack frame is indicated by a colored icon. The colors are the same as the ones used in the Xcode debugger.

To copy a stack frame as it is displayed:

1	Select the stack frame.
2	Choose Edit > Copy.

To only copy the machine instruction address of stack frame:

1	Control-click the stack frame.
2	Choose Copy Machine Instruction Address

To copy the offset of a stack frame in the related binary image:

1	Control-click the stack frame.
2	Hold down the alt key and choose Copy Binary Image Offset

To show the machine instruction address in Hopper Disassembler:

1	Control-click the stack frame.
2	Choose Show In > Hopper Disassembler.

Notes:

This assumes that Hopper Disassembler is installed on your Mac.
At the time of this writing, each time you use this feature, a new Hopper Disassembler document is created.

Presentation options

The presentation options are available at the bottom of the Backtraces list.

The following layout options are available:

Show or hide the list of binary images. See the paragraph Binary images for more info.
Show threads and backtraces in a list or in columns. See the paragraph Backtraces list for more info.

The following filtering options are available:

Show only the backtrace of the crashed thread.
Show or hide some components of stack frames.

To show or hide the list of binary images:

1	Click the binary images disclosure button or choose View > (Show\|Hide) Binary Images.

To switch between the list and column layouts:

1	Click the outline layout toggle.

To only display the backtrace of the crashed thread:

1	Click the crashed thread toggle.

Unexpectedly also lets you show or hide some components of the stack frame of a backtrace:

To hide or show the binary name of stack frames:

1	Click the binary name toggle.

To hide or show the machine instruction address of stack frames:

1	Click the machine instruction address toggle.

To hide or show the byte offset (and source file) of stack frames:

1	Click the byte offset toggle.

See the Preferences chapter to learn how to define which components should be visible by default.

Binary images

This pane presents in a table all the binary images listed in the report.

Here are the main features of the table:

The images can be sorted by name, version, addresses or paths. By default, they are sorted by addresses.
The origin of an image is indicated by a colored icon. The colors are the same as the ones used in the Xcode debugger.
When a stack frame is selected in the Backtraces list, the binary image for the stack frame is getting highlighted.
The list of images can be filtered using the Filter field.

To show a binary image in the Finder:

1	Select the binary image in the list.
2	Choose File > Show in Finder.

To open a binary image in Hopper Disassembler:

1	Select the binary image in the list.
2	Control-click the binary image and choose Open With > Hopper Disassembler.

Note: This assumes that Hopper Disassembler is installed on your Mac.

To filter the displayed binary images:

1	Click the Filter field.
2	Type the string to match.

Revision History

04/30/21

First version