Watchpoint Management

Watchpoints stop or notify on data access rather than on code location. In the TEMU System Debugger they are managed from the lower half of the Breakpoints / Watchpoints dock.

Opening the Watchpoint View

Open the Breakpoints / Watchpoints dock from the left-side tab group. The dock is vertically split:

  • Breakpoints in the upper section

  • Watchpoints in the lower section

Watchpoint list
Figure 1. Watchpoint tree view

Adding Watchpoints

You can create watchpoints from several GUI entry points:

Gear menu

Click the gear button at the top of the watchpoint section and choose Add Watchpoint…​.

Component Browser

Right-click a symbol leaf and choose Add Watchpoint.

Source Code View

Right-click an identifier symbol and choose Set Watchpoint on "<name>".

The add/edit dialog is the main interface when you need to configure the target, access mode, size, or other conditions manually.

Watchpoint Settings Dialog

The Watchpoint Settings dialog is divided into three groups.

Watchpoint settings dialog
Figure 2. Watchpoint settings dialog

Target

Type

Choose whether the watchpoint targets an Address or a Variable.

Address

Enter a hexadecimal address such as 0x1000.

Variable

Search known component variables from an editable drop-down list.

Label

Optional text used to make the watchpoint easier to recognize in the list.

Context

Select the software context that should own the watchpoint.

Trigger

Access

Choose Read or Write.

Size

Set the watched size in bytes.

Condition

Provide an optional expression guard.

Execution Behavior

Remove watchpoint after the first hit

Creates a one-shot watchpoint.

Ignore Count

Skips the first N hits before the watchpoint becomes active.

Managing the Watchpoint List

The watchpoint table shows one row per watchpoint with these columns:

On

A check box that enables or disables the watchpoint.

Target

The watched address, symbol, or custom label.

Mode

The access type, such as Read or Write.

Size

The watched size in bytes.

Hits

The current hit count.

Hovering a row shows more detail, including the selected context, condition, symbol path, ignore count, and whether the watchpoint is one-shot.

Toolbar and Context Menu Actions

The gear menu above the list provides:

  • Add Watchpoint…​

  • Enable Selected

  • Disable Selected

  • Edit Watchpoint

  • Delete Selected

  • Clear All

Right-clicking a watchpoint row opens a smaller context menu with:

  • Edit Watchpoint

  • Delete

Deleting selected rows and clearing the list both ask for confirmation first.

Navigation Behavior

Double-click a watchpoint row to navigate to its address. If the watchpoint belongs to another context, the debugger switches to that context first and then routes the navigation to the disassembly workflow.

Tips

  • Use symbol-based watchpoints when you want the GUI to track the watched item by name instead of typing an address manually.

  • Use one-shot watchpoints for temporary investigations where the first access is the only one that matters.