5.4.1. Managing qualifiers and actions

Qualifiers, actions, and the continuation state, are set up using the Set Address/Data Break/Tracepoint dialog box, shown in Figure 5.8.

Using the New Qualifiers menu

Click the New button in the Qualifiers group to display the New Qualifiers menu, shown in Figure 5.9. You can use this to specify qualifiers when you first create a breakpoint, or to add qualifiers to edit an existing breakpoint.

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...

Enables you to specify the number of times execution must arrive at the specified address before execution stops.

When Expression True...

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

When Expression False...

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

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 of attaching a macro to a breakpoint.

C++ Object...

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

Favorites...

Select this option to display your personal favorites list of breakpoint qualifiers. From here you can specify the required qualifier.

See Saving breakpoints as favorites for details of creating breakpoint favorites and adding qualifiers to the list.

Using the New Actions menu

Click the New button in the Actions group to display the New Actions menu, shown in Figure 5.10. You can use this to specify breakpoint actions when you first create a breakpoint, or to add actions to edit an existing breakpoint. These actions are not actioned until the breakpoint qualifiers complete:

Update Window...

Displays a list selection box where you can choose which RealView Debugger windows are updated when execution stops. The list includes all windows and panes available from the default desktop. You can also redirect RealView Debugger output to a user window and this can be updated when execution stops.

When updating multiple windows, you can only use this selection box to specify one window at a time.

Update All Windows

Updates all desktop windows at the time the breakpoint triggers.

Update Sample...

Updates registered samples when execution stops. This is used as part of the graphing and visualization functions in RealView Debugger.

Note

This menu option is not available for visualization functions in this release. This option is available when a sampling variant is available, for example logging from breaks.

Breakpoint Timer

This option is enabled where your debug target supports cycle timing in hardware. The timer measures execution time from the point where the breakpoint triggers.

Message Output...

Displays a dialog box where you can enter a short text string for display when the breakpoint triggers.

By default this message appears in the Output pane but you can specify a window, for example, $250$Stop at convert proc. This sends the message Stop at convert proc to the specified window (see Attaching macros to breakpoints for an example).

Favorites...

Select this option to display your personal favorites list of breakpoint actions. From here you can specify the required action.

If you have used actions previously, these are displayed at the bottom of the New Actions menu.

Viewing qualifiers and actions

When you have set up actions and qualifiers they are displayed in the Qualifiers and Actions group display lists, shown in the example in Figure 5.16.

Figure 5.16. Breakpoint actions and qualifiers

Breakpoint actions and qualifiers

The order of the qualifiers, in the Qualifiers group display list, defines the order they are tested to trigger the breakpoint. If a qualifier fails then subsequent conditions are not tested.

The order of the actions, in the Actions group display list, defines the order they are carried out when the breakpoint triggers. These actions do not execute until all breakpoint qualifiers complete successfully.

To manage the Qualifiers and Actions display lists:

  • re-order the list by highlighting a qualifier, or action, and use the up, or down, button to reposition the specified entry in the list

  • highlight a qualifier, or action, and click Del to delete the specified entry

  • highlight a qualifier, or action, and click Edit to update it so changing the behavior.

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B
Non-Confidential