Debug Control view
Use the Debug Control view to display target connections with a hierarchical layout of running cores, threads, or user-space processes.
This view enables you to:
- Connect to and disconnect from a target.
- View a list of running cores, threads, or user-space processes as applicable.
- Load an application image onto the target.
- Load debug information when required by the debugger.
- Look up stack information.
- Start, run, and stop the application.
- Continue running the application after a breakpoint is hit or the target is suspended.
- Control the execution of an image by sequentially stepping through an application at the source or instruction level.
- Modify the search paths used by the debugger when it executes any of the commands that look up and display source code.
- Set the current working directory.
- Reset the target.
Some of the views in the DS-5 Debug perspective are associated with currently selected execution context. Each associated view is synchronized depending on your selection.
On Linux Kernel connections, the hierarchical nodes Active Threads and All Threads are displayed. Active Threads shows each thread that is currently scheduled on a processor. All Threads shows every thread in the system, including those presently scheduled on a processor.
On gdbserver connections, the hierarchical nodes Active Threads and All Threads are displayed, but the scope is limited to the application under debug. Active Threads shows only application threads that are currently scheduled. All Threads shows all application threads, including ones that are currently scheduled.
Connection execution states are identified with different icons and background highlighting and are also displayed in the status bar.
When working with threads, note that the current active thread is always highlighted, as shown in the following figure:
Figure 11-9 Debug Control view
Toolbar and context menu options
The following options are available from the toolbar or context menu:
- Collapse All
Collapses all expanded items.
- Display Cores/Display Threads
Click to toggle between viewing cores or threads. This option is only active for bare-metal connections with OS awareness enabled.
- Connect to Target
Connects to the selected target using the same launch configuration settings as the previous connection.
- Disconnect from Target
Disconnects from the selected target.
- Remove Connection
Removes the selected target connection from the Debug Control view.
- Remove All Connections
Removes all target connections from the Debug Control view, except any that are connected to the target.
- Debug from menu
This menu lists the different actions that you can perform when a connection is established.
- Reset menu
This menu lists the different types of reset that are available on your target.
Continues running the target.
NoteA Connect only connection might require setting the PC register to the start of the image before running it.
Interrupts the target and stops the current application.
- Step Source Line
- Step Instruction
This option depends on the stepping mode selected:
If source line mode is selected, steps at the source level including stepping into all function calls where there is debug information.
If instruction mode is selected, steps at the instruction level including stepping into all function calls.
- Step Over Source Line
- Step Over Instruction
This option depends on the stepping mode selected:
If source line mode is selected, steps at the source level but stepping over all function calls.
If instruction mode is selected, steps at the instruction level but stepping over all function calls.
- Step Out
Continues running to the next instruction after the selected stack frame finishes.
- Stepping by Source Line (press to step by instruction)
- Stepping by Instruction (press to step by source line)
Toggles the stepping mode between source line and instruction.
The Disassembly view and the source editor view are automatically displayed when you step in instruction mode.
The source editor view is automatically displayed when you step in source line mode. If the target stops in code such as a shared library, and the corresponding source is not available, then the source editor view is not displayed.
- Debug Configurations...
Displays the Debug Configurations dialog box, with the configuration for the selected connection displayed.
- Launch in background
If this option is disabled, the Progress Information dialog box is displayed when the application launches.
- Show in Stack
- Opens the Stack view, and displays the stack information for the selected execution context.
- Reset DS-5 views to 'Linked'
Resets DS-5 views to link to the selected connection in the Debug Control view.
- View CPU Caches
- Displays the Cache Data view for a connected configuration.
- View Menu
The following options are available:
- Add Configuration (without connecting)...
Displays the Add Launch Configuration dialog box. The dialog box lists any configurations that are not already listed in the Debug Control view.
Select one or more configurations, then click OK. The selected configurations are added to the Debug Control view, but remain disconnected.
Displays a dialog box where you can select whether to load an image, debug information, an image and debug information, or additional debug information. This option might be disabled for targets where this functionality is not supported.
- Set Working Directory...
Displays the Current Working Directory dialog box. Enter a new location for the current working directory, then click OK.
- Path Substitution...
Displays the Path Substitution and Edit Substitute Path dialog box.
Use the Edit Substitute Path dialog box to associate the image path with a source file path on the host. Click OK. The image and host paths are added to the Path Substitution dialog box. Click OK when finished.
- Threads Presentation
Displays either a flat or hierarchical presentation of the threads in the stack trace.
- DTSL options
Opens the DTSL Configuration Editor dialog to specify the DTSL options for the target connection.