11.7 Debug Control view

Use the Debug Control view to display target connections with a hierarchical layout of running threads, user space processes, and related call stacks. Call stack information is gathered when the system is stopped.

This view enables you to:
  • View a list of running threads and user space processes as applicable.
  • View the call stack, showing stack elements for each thread or process as applicable.
  • Connect to and disconnect from a target.
  • Load an application image onto the target.
  • Load debug information when required by the debugger.
  • Reset the target.
  • 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.
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.
Some of the views in the DS-5 Debug perspective are associated with the currently selected stack frame. Other views are associated with editors or target connections. Each associated view is synchronized accordingly.
Connection states are identified with different icons and background highlighting and are also displayed in the view status bar, as shown in the following figure:
Figure 11-8 Debug Control view
Debug Control view

Toolbar and context menu options

The following options are available from the toolbar or context menu:
Collapse All
Collapses all expanded stack trace configurations.
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.
Continue
Continues running the target.

Note

A Connect only connection might require setting the PC register to the start of the image before running it.
Interrupt
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.
Reverse Continue
Continues running backwards through the code.
Reverse Step Source Line
Reverse Step Instruction
This option depends on the stepping mode selected:
  • If source line mode is selected, steps backwards at the source level including stepping into all function calls where there is debug information.
  • If instruction mode is selected, steps backwards at the instruction level including stepping into all function calls.
Reverse Step Over Source Line
Reverse Step Over Instruction
This option depends on the stepping mode selected:
  • If source line mode is selected, steps backwards at the source level but stepping over all function calls.
  • If instruction mode is selected, steps backwards at the instruction level but stepping over all function calls.
Reverse Step Out
Continues running backwards to the instruction before the start of the selected stack frame.
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.
Step Out to This Frame
Continues running to the selected stack frame.
Change Connection Color
Enables you to change the color of the connection icon.
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.
Load...
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.
Auto Expand Call Stack
Controls whether to automatically display an expanded stack when selecting a connection.
Default Stack Depth
Controls the maximum number of stack frames to display in the Debug Control view. Increasing the number of displayed stack frames might slow the debugger performance.
Always Show Cores
Displays the available processors.
DTSL options
Opens the DTSL Configuration Editor dialog to specify the DTSL options for the target connection.
Related concepts
6.8 About debugging multi-threaded applications
6.9 About debugging shared libraries
6.10.2 About debugging a Linux kernel
6.10.3 About debugging Linux kernel modules
6.11 About debugging TrustZone enabled targets
Related reference
16.2 DS-5 Debug perspective keyboard shortcuts
11.6 Commands view
Chapter 11 DS-5 Debug Perspectives and Views
Non-ConfidentialPDF file icon PDF versionARM DUI0446W
Copyright © 2010-2015 ARM. All rights reserved.