OpenBoot 3.x Command Reference Manual

Breakpoint Commands

Table I-42 Breakpoint Commands

Command  

Stack Diagram 

Description 

+bp

( addr -- ) 

Add a breakpoint at the given address. 

-bp

( addr -- ) 

Remove the breakpoint at the given address. 

--bp

( -- )  

Remove the most-recently-set breakpoint. 

.bp

( -- ) 

Display all currently set breakpoints. 

.breakpoint

( -- ) 

Perform a specified action when a breakpoint occurs. This word can be altered to perform any desired action. For example, to display registers at every breakpoint, type: ['] .registers is .breakpoint. The default behavior is .instruction. To perform multiple behaviors, create a single definition which calls all desired behaviors, then load that word into .breakpoint.

.instruction

( -- ) 

Display the address, opcode for the last-encountered breakpoint.  

.step

( -- ) 

Perform a specified action when a single step occurs. (See .breakpoint).

bpoff

( -- ) 

Remove all breakpoints. 

finish-loop

( -- ) 

Execute until the end of this loop. 

go

( -- ) 

Continue from a breakpoint. This can be used to go to an arbitrary address by setting up the processor's program counter before issuing go.

gos

( n -- ) 

Execute go n times.

hop

( -- ) 

(Like the step command.) Treat a subroutine call as a single instruction.

hops

( n -- ) 

Execute hop n times.

return

( -- ) 

Execute until the end of this subroutine. 

returnl

( -- )  

Execute until the end of this leaf subroutine. 

skip

( -- ) 

Skip (do not execute) the current instruction. 

step

( -- ) 

Single-step one instruction. 

steps

( n -- ) 

Execute step n times.

till

( addr -- ) 

Execute until the given address is encountered. Equivalent to +bp go.