Registerpoint Debugger Commands

rpset

sets a registerpoint to trigger on a condition

rpclear

clears registerpoints

rpdisable

disables a registerpoint

rpenable

enables registerpoints

rplist

lists registerpoints

Registerpoints evaluate an expression each time a CPU executes an instruction and halt execution and activate the debugger if the result is true (non-zero).

rpset

rp[set] <condition>[,<action>]

Sets a new registerpoint which will be triggered when the expression supplied as the <condition> evaluates to true (non-zero). Note that the condition may need to be surrounded with braces { } to prevent it from being interpreted as an assignment. The optional <action> parameter provides a command to be executed whenever the registerpoint is triggered. Note that you may need to surround the action with braces { } to ensure commas and semicolons within the command are not interpreted in the context of the rpset command itself.

Each registerpoint that is set is assigned a numeric index which can be used to refer to it in other registerpoint commands. Registerpoint indices are unique throughout a session.

Examples:

rp {PC==150}

Set a registerpoint that will halt execution whenever the PC register equals 150.

temp0=0; rp {PC==150},{temp0++; g}

Set a registerpoint that will increment the variable temp0 whenever the PC register equals 150.

rp {temp0==5}

Set a registerpoint that will halt execution whenever the temp0 variable equals 5.

Back to Registerpoint Debugger Commands

rpclear

rpclear [<rpnum>,[,…]]

Clears registerpoints. If <rpnum> is specified, the registerpoints referred to will be cleared. If <rpnum> is not specified, all registerpoints will be cleared.

Examples:

rpclear 3

Clear the registerpoint with index 3.

rpclear

Clear all registerpoints.

Back to Registerpoint Debugger Commands

rpdisable

rpdisable [<rpnum>[,…]]

Disables registerpoints. If <rpnum> is specified, the registerpoints referred to will be disabled. If <rpnum> is not specified, all registerpoints will be disabled.

Note that disabling a registerpoint does not delete it, it just temporarily marks the registerpoint as inactive. Disabled registerpoints will not cause execution to halt, their condition expressions will not be evaluated, and their associated commands will not be executed.

Examples:

rpdisable 3

Disable the registerpoint with index 3.

rpdisable

Disable all registerpoints.

Back to Registerpoint Debugger Commands

rpenable

rpenable [<rpnum>[,…]]

Enables registerpoints. If <rpnum> is specified, the registerpoints referred to will be enabled. If <rpnum> is not specified, all registerpoints will be enabled.

Examples:

rpenable 3

Enable the registerpoint with index 3.

rpenable

Enable all registerpoints.

Back to Registerpoint Debugger Commands

rplist

rplist [<CPU>]

List current registerpoints, along with their indices and conditions, and any associated actions. If no <CPU> is specified, registerpoints for all CPUs in the system will be listed; if a <CPU> is specified, only registerpoints for that CPU will be listed. The <CPU> can be specified by tag or by debugger CPU number (see Specifying devices and address spaces for details).

Examples:

rplist

List all registerpoints.

rplist .

List all registerpoints for the visible CPU.

rplist maincpu

List all registerpoints for the CPU with the absolute tag path :maincpu.

Back to Registerpoint Debugger Commands