Registerpoint Debugger Commands — MAME Documentation 0.287 documentation

# 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