The to command step program execution when debugging.
to [-vbci][-m addr val][-M addr val][-r reg val] [-R reg val][cnt]
|-v||verbose. Display each step when cnt is given|
|-b||verbose. Display only branches when cnt is given|
|-c||verbose. Display only function calls when cnt is given|
|-i||stop on invalid CPC value|
|-m addr val||stop when memory location addr becomes equal to val|
|-M addr val||stop when memory location addr becomes not equal to val|
|-r reg val||stop when register reg becomes equal to val|
|-R reg val||stop when register reg becomes not equal to val|
|-i cnt||trace cnt instructions and then stop|
The to command resumes program execution at the current value of the CPC register and halts when the location after the current location is reached. Eg if the instruction to be executed is a branch or call instruction the next stop is when the branch is not taken or the called function returns. This is very useful when stepping through program loops and subroutine calls and it is not desired to single step the loop or subroutine.
The to command will be repeated cnt times if a value is given. If the -vswitch is given the command determined by the enviroment variable brkcmd will be executed each time. Otherwise the brkcmd will only be executed the last time when program execution is halted.
The -m, -M, -r and -R options can be used to stop execution when a memory location or a register becomes equal or not equal to the given value. If a breakpoint is reached or any other stop condition occurs before the equal or not equal condition program execution will halt. The cnt argument can not be used when match/no match is used.
The command uses the brkcmd environment variable.