Breakpoints Window Introduction

The Breakpoints window is the central location in SourcePoint for managing breakpoints.   

The Breakpoints window is not the only window where breakpoints can be defined.  Breakpoints may also be defined in the Code window, the Trace window, the Symbols window, etc.  For more information, see Set Breakpoints From Other SourcePoint Windows.

Breakpoints Window

To open the Breakpoints window, select View|Breakpoints on the menu bar or click on the Breakpoints icon on the toolbar.

Breakpoints Window

Breakpoints Window - Breakpoint List Section

The Breakpoints window displays the Breakpoint list, a list of currently defined breakpoints.  This includes hardware (processor) breakpoints, software (memory) breakpoints and task debugging breakpoints.

Note: Double clicking in a column heading will sort the Breakpoint list in ascending order by that column. Double clicking the column heading a second time will sort the list in descending order.  

Breakpoint List Columns

Enable / Disable (unlabeled).  Displays the type of a breakpoint and whether it is enabled.  The type of breakpoint is indicated by its icon and color.  The same icons used in the Breakpoints window are also displayed in the Breakpoint column in the Code window.

 

 

Breakpoint Icons

Clicking in this column enables or disables a breakpoint.  The enable/disable state is indicated by the icon being solid or just an outline.  

Identifier.  Displays the symbolic name for a breakpoint.

Address.  Displays the address of a breakpoint.

Attributes.  Displays the other attributes of a breakpoint.  The attributes displayed vary by the breakpoint type.  A long list of attributes clipped by the right-hand side of the window is available in the tooltip for that field.

Breakpoint List Button Bar

The buttons below the Breakpoint list provide quick shortcuts for managing breakpoints.  All of the button actions are also available on the context menu.  To reduce the size of the Breakpoints window, the button bar can be hidden by selecting Hide Buttons on the context menu.

Edit.  Opens the Edit Breakpoint dialog with the currently selected breakpoint displayed (double left-clicking on the breakpoint performs the same action).  See Add/Edit Dialog for more information about editing breakpoints.

Add.  Opens the Add Breakpoint dialog to define a new breakpoint.  See Add/Edit Dialog for more information about adding breakpoints.

If an existing breakpoint is selected when Add is pressed, the dialog will be initialized with that breakpoint’s settings.  This is useful when creating a breakpoint similar to one already defined.

Remove.  Removes the currently selected breakpoint.

Remove All.  Removes all breakpoints in the list.

Enable / Disable.  Toggles the state of the currently selected breakpoint.

Disable All.  Disables all breakpoints in the list.

The number of hardware breakpoints available varies based on processor type.  The number of software breakpoints available is always 512.

Breakpoint List Context Menu

The Breakpoint list context menu is available by right clicking anywhere in the Breakpoint list.

Edit.  Provides the same functionality as the Edit button (above).

Add. Provides the same functionality as the Add button (above).

Remove.  Provides the same functionality as the Remove button (above).

Enable / Disable.  Provides the same functionality as the Enable / Disable button (above).

Open Code.  Opens a Code window displaying the location of the currently selected breakpoint.  This button is only enabled on execution breakpoints.

Open Memory.  Opens a Memory window displaying the location of the currently selected breakpoint.  This button is only enabled on execution and data breakpoints.

Remove All.  Removes all breakpoints from the Breakpoint list.

Enable All.  Enables all breakpoints in the Breakpoint list.

Disable All.  Disables all breakpoints in the Breakpoint list.

Hide / Show Buttons.  Hides or shows the Breakpoint list button bar.  Hiding the buttons makes the Breakpoints windows smaller, but requires that all of the button actions be performed via the context menu.

Load.  Loads a group of breakpoints from a file.  Provides a quick way to switch between different breakpoint environments.

Save.  Saves a group of breakpoints to a file.  The file saved has a .brk extension by default.

Resources.  Opens the Breakpoint Resources dialog.  This read-only dialog displays the number of hardware and software breakpoints available and currently in use.