Describes the view content.
When the trace has been captured the debugger extracts the information from the trace stream and decompresses it to provide a full disassembly, with symbols, of the executed code.
This view shows a graphical navigation chart that displays function executions with a navigational timeline. In addition, the disassembly trace shows function calls with associated addresses and if selected, instructions. Clicking on a specific time in the chart synchronizes the Disassembly view.
In the left-hand column of the chart, percentages are shown for each function of the total trace. For example, if a total of 1000 instructions are executed and 300 of these instructions are associated with
myFunction() then this function
is displayed with 30%.
In the navigational timeline, the color coding is a "heat" map showing the executed instructions and the amount of instructions each function executes in each timeline. The darker red color showing more instructions and the lighter yellow color showing less instructions. At a scale of 1:1 however, the color scheme changes to display memory access instructions as a darker red color, branch instructions as a medium orange color, and all the other instructions as a lighter green color.
Figure 10-23 Trace view with a scale of 1:1
The Trace view might not be visible by default. To add this view:
Ensure that you are in the DS-5 Debug perspective.
Select Window > Show View to open the Show View dialog box.
Select Trace view.
The Trace view contains several tabs:
Trace tab showing the graphical timeline and disassembly.
Right-click on the column headers to select the columns that you want displayed.
are displayed by default.
Toolbar and context menu options
The following options are available from the toolbar or context menu:
- Linked: context
Links this view to the selected connection in the Debug Control view. This is the default. Alternatively you can link the view to a specific connection or processor in an Symmetric MultiProcessing (SMP) connection. If the connection you want is not shown in the drop-down list you might have to select it first in the Debug Control view.
- Show Next Match
Moves the focus of the navigation chart and disassembly trace to the next matching occurrence for the selected function or instruction.
- Show Previous Match
Moves the focus of the navigation chart and disassembly trace to the previous matching occurrence for the selected function or instruction.
- Don’t mark other occurrences - click to start marking, Mark other occurrences - click to stop marking
When function trace is selected, marks all occurrences of the selected function with a shaded highlight. This is disabled when instruction trace is selected.
- Clear Trace
Clears the raw trace data that is currently contained in the trace buffer and the trace view.
- Showing instruction trace - click to switch to functions, Showing function trace - click to switch to instructions
Toggles the disassembly trace between instruction trace or function trace.
- Export Trace Report
Displays the Export Trace Report dialog box to save the trace data to a file.
Where enabled, moves the trace view to the beginning of the trace buffer. Changes might not be visible if the trace buffer is too small.
- Page Back
Where enabled, moves the trace view back one page. You can change the page size by modifying the Set Maximum Instruction Depth setting.
- Page Forward
Where enabled, moves the trace view forward one page. You can change the page size by modifying the Set Maximum Instruction Depth setting.
Where enabled, moves the trace view to the end of the trace buffer. Changes might not be visible if the trace buffer is too small.
- Switch between navigation resolutions
Changes the timeline resolution in the navigation chart.
- Switch between alternate views
Changes the view to display the navigation chart, disassembly trace or both.
- Focus Here
At the top of the list, displays the function being executed in the selected time slot. The remaining functions are listed in the order that they are executed after the selected point in time. Any functions that do not appear after that point in time are placed at the bottom and ordered by total time.
- Order By Total Time
Displays the functions ordered by the total time spent within the function. This is the default ordering.
- View Menu
The following View Menu options are available:
- New Trace View
Displays a new instance of the Trace view.
- Set Trace Page Size...
Displays a dialog box where you can enter the maximum number of instructions to display in the disassembly trace. The number must be within the range of one thousand to one million instructions.
- Find Trace Trigger Event
Enables you to search for trigger events in the trace capture buffer.
- Find Timestamp...
Displays a dialog box where you can enter either a numeric timestamp as a 64 bit value or in the h:m:s format.
- DTSL Options...
Displays a dialog box where you can add, edit or choose a DTSL configuration.
NoteThis will clear the trace buffer.
Discards all the data in the view and rereads it from the current trace buffer.
- Freeze Data
Toggles the freezing of data in the current view.
- Trace Filter Settings...
Displays a dialog box where you can select the trace record types that you want to see in the Trace view.