11.4 Breakpoints view

Use the Breakpoints view to display the breakpoints, watchpoints, and tracepoints you have set in your program.

It also enables you to:
  • Disable, enable, or delete breakpoints, watchpoints, and tracepoints.
  • Import or export a list of breakpoints and watchpoints.
  • Display the source file containing the line of code where the selected breakpoint is set.
  • Display the disassembly where the selected breakpoint is set.
  • Display the memory where the selected watchpoint is set.
  • Delay breakpoint activation by setting properties for the breakpoint.
  • Control the handling and output of messages for all Unix signals and processor exception handlers.
  • Change the access type for the selected watchpoint.
Figure 11-4 Breakpoints view
Breakpoints view

Syntax of a breakpoint entry

A breakpoint entry has the following syntax:
source_file:linenum @ function+offset address [#ID instruction_set, ignore = num/count, nHits hits, (condition)]
where:
source_file:linenum
If the source file is available, the file name and line number in the file where the breakpoint is set, for example main.c:44.
function+offset
The name of the function in which the breakpoint is set and the number of bytes from the start of the function. For example, main_app+0x12 shows that the breakpoint is 18 bytes from the start of the main_app() function.
address
The address at which the breakpoint is set.
ID
The breakpoint ID number, #N. In some cases, such as in a for loop, a breakpoint might comprise a number of sub-breakpoints. These are identified as N.n, where N is the number of the parent. The syntax of a sub-breakpoint entry is:
function+offset address [#ID]
instruction_set
The instruction set of the instruction at the address of the breakpoint, A32 (ARM) or T32 (Thumb).
ignore = num/count
An ignore count, if set, where:
num equals count initially, and decrements on each pass until it reaches zero.
count is the value you have specified for the ignore count.
nHits hits
A counter that increments each time the breakpoint is hit. This is not displayed until the first hit. If you set an ignore count, hits count does not start incrementing until the ignore count reaches zero.
condition
The stop condition you have specified.

Syntax of a watchpoint entry

A watchpoint entry has the following syntax:
name type @ address [#ID]
where:
name
The name of the variable where the watchpoint is set.
type
The access type of the watchpoint.
address
The address at which the watchpoint is set.
ID
The watchpoint ID number.

Syntax of a tracepoint entry

A tracepoint entry has the following syntax:
source_file:linenum
where:
source_file:linenum
If the source file is available, the file name and line number in the file where the tracepoint is set.

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 different 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.
Delete
Removes the selected breakpoints, watchpoints, and tracepoints.
Delete All
Removes all breakpoints, watchpoints, and tracepoints.
Go to File
Displays the source file containing the line of code where the selected breakpoint or tracepoint is set. This option is disabled for a watchpoint.
Skip All Breakpoints
Deactivates all breakpoints or watchpoints that are currently set. The debugger remembers the enabled and disabled state of each breakpoint or watchpoint, and restores that state when you reactivate them again.
Show in Disassembly
Displays the disassembly where the selected breakpoint is set. This option is disabled for a tracepoint.
Show in Memory
Displays the memory where the selected watchpoint is set. This option is disabled for a tracepoint.
Resolve
Re-evaluates the address of the selected breakpoint or watchpoint. If the address can be resolved, the breakpoint or watchpoint is set, otherwise it remains pending.
Enable Breakpoints
Enables the selected breakpoints, watchpoints, and tracepoints.
Disable Breakpoints
Disables the selected breakpoints, watchpoints, and tracepoints.
Copy
Copies the selected breakpoints, watchpoints, and tracepoints. You can also use the standard keyboard shortcut to do this.
Paste
Pastes the copied breakpoints, watchpoints, and tracepoints. They are enabled by default. You can also use the standard keyboard shortcut to do this.
Select all
Selects all breakpoints, watchpoints, and tracepoints. You can also use the standard keyboard shortcut to do this.
Properties...
Displays the Properties dialog box for the selected breakpoint, watchpoint or tracepoint. This enables you to control activation or change the access type for the selected watchpoint.
View Menu
The following View Menu options are available:
New Breakpoints View
Displays a new instance of the Breakpoints view.
Import Breakpoints
Imports a list of breakpoints and watchpoints from a file.
Export Breakpoints
Exports the current list of breakpoints and watchpoints to a file.
Alphanumeric Sort
Sorts the list alphanumerically based on the string displayed in the view.
Ordered Sort
Sorts the list in the order they have been set.
Auto Update Breakpoint Line Numbers
Automatically updates breakpoint line numbers in the Breakpoints view when changes occur in the source file.
Manage Signals
Displays the Manage Signals dialog box.
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
3.11 Setting a tracepoint
3.8 Conditional breakpoints
3.9 Assigning conditions to an existing breakpoint
3.10 Pending breakpoints and watchpoints
Chapter 11 DS-5 Debug Perspectives and Views
5.1 Examining the target execution environment
5.2 Examining the call stack
Non-ConfidentialPDF file icon PDF versionARM DUI0446W
Copyright © 2010-2015 ARM. All rights reserved.