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 showing breakpoints and sub-breakpoints

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 themain_app()
function. -
address
-
The address at which the breakpoint is set.
-
ID
-
The breakpoint ID number,
#
. In some cases, such as in aN
for
loop, a breakpoint might comprise a number of sub-breakpoints. These are identified as
, whereN
.n
is the number of the parent. The syntax of a sub-breakpoint entry is:N
function
+offset
address
[#ID
] -
instruction_set
-
The instruction set of the instruction at the address of the breakpoint,
A32 (Arm)
orT32 (Thumb)
. -
ignore =
num
/count
-
An
ignore
count, if set, where:
equalsnum
count
initially, and decrements on each pass until it reaches zero.
is the value you have specified for thecount
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 theignore
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 currently set breakpoints or watchpoints. 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.