stopi

Sets a breakpoint at a machine instruction.

SYNTAX

stopi [var | at addr | in func] [if expression] [{cmd; cmd ...}] [after n]
[pset set_name | set_definition]

DESCRIPTION

Use the stopi command to set a breakpoint at a machine instruction.

The first option listed in the synopsis (var | at addr | in func) must come first on the command line; you can specify the other options, if you include them, in any order.

var is the name of a variable. Execution stops whenever the value of the variable changes. If the variable is an array or a parallel variable, execution stops when the value of any element changes. This form of the command slows execution considerably. You cannot specify both a variable and a location.

at addr stops execution when the specified address is reached.

in func stops execution when the specified procedure or function is reached.

if expression specifies the logical condition, if any, under which execution is to stop. The logical condition can be any expression that evaluates to true or false. Unless combined with the at addr syntax, this form of stopi slows execution considerably.

{cmd; cmd ...} specifies the actions, if any, that are to accompany the breakpoint. The actions can be any Prism commands; if you include multiple commands, separate them with semicolons.

after n specifies how many times a trigger condition (for example, reaching a program location) is to occur before the breakpoint occurs. The default is 1. If you specify both a condition and an after count, Prism checks the condition first.

When issued in MP Prism, this command can take a pset qualifier. If used with a qualifier, it applies to the pset you specify. If used without a qualifier, it applies to the current pset. See " Using Pset Qualifiers" for more information on pset qualifiers.

EXAMPLES

stopi at 0x1000

stops execution at address 1000 (hex).

stopi at 0x500 if a == 0

stops execution at address 500 (hex) if a is equal to 0.