5.8.8. Specifying Qualifiers

To set a conditional breakpoint, you must assign a condition qualifier. To do this, click the New button in the Qualifiers group, shown in Figure 5.15, to display the New Qualifiers menu. You can use this to specify qualifiers when you first create a breakpoint, or to add qualifiers to edit an existing breakpoint.

Figure 5.15. Assigning qualifiers to breakpoints

Assigning qualifiers to breakpoints

The order of the qualifiers, in the Qualifiers group display list, defines the order they are tested to trigger the breakpoint. If a condition is False, then subsequent conditions are not tested. See Controlling the behavior of breakpoints for details on how the order of conditional qualifiers affects the behavior of a breakpoint.

The New Qualifiers menu

This menu enables you to select the qualifier that controls execution, that is to define the condition that must be satisfied to trigger the breakpoint:

SW Pass Count...

Use this to specify the number of times execution must arrive at the specified address before execution stops.

The equivalent CLI command qualifier is passcount:count.

When Expression True...

Enables you to specify an expression that must evaluate to True to stop execution.

The equivalent CLI command qualifier is when:{condition}.

When Expression False...

Use this to specify an expression that must evaluate to False to stop execution.

The equivalent CLI command qualifier is when_not:{condition}.

User Macro...

Enables you to specify a macro that runs when execution stops. This brings up a dialog box where you supply the macro name and any arguments required to run it. See Attaching macros to breakpoints for an example. Also, see Controlling the behavior of breakpoints for details on how the macro return value affects the behavior of a breakpoint.

The equivalent CLI command qualifier is macro:{MacroCall(arg1,arg2)}.

C++ Object...

Use this to specify a C++ this object to test. The Call Stack pane contains a This tab where you can view such objects.

The equivalent CLI command qualifier is obj:(n).

Favorites...

Select this option to display your personal Favorites List of breakpoint qualifiers (see Favorites categories used by RealView Debugger features). From here you can specify the required qualifier.

See Setting breakpoints from your breakpoint Favorites List for details of creating breakpoint favorites and adding qualifiers to the list.

Copyright © 2005, 2006 ARM Limited. All rights reserved.ARM DUI 0281C
Non-Confidential