Next: , Previous: , Up: Monitor   [Contents][Index]


12.2 Machine state commands

backtrace
bt

Print JSR call chain (most recent call first). Stack offset relative to SP+1 is printed in parentheses. This is a best guess only.

cpuhistory [<count>]
chis [<count>]

Show <count> last executed commands. (disabled by default; configure with –enable-cpuhistory to enable)

dump "<filename>"

Write a snapshot of the machine into the file specified. This snapshot is compatible with a snapshot written out by the UI. Note: No ROM images are included into the dump.

goto <address>
g <address>

Change the PC to address and continue execution.

io [<address>]

Display i/o registers. Invoking without an address shows a dump of the entire io range, if an address is given then details for the chip at the respective (base-)address are displayed (if available).

next [<count>]
n [<count>]

Advance to the next instruction. Subroutines are treated as a single instruction.

registers [<reg_name> = <number> [, <reg_name> = <number>]*]
r [<reg_name> = <number> [, <reg_name> = <number>]*]

Assign respective registers (use FL for status flags). With no parameters, display register values.

reset [<type>]

Reset the machine or drive. type: 0 = soft, 1 = hard, 8-11 = drive.

return
ret

Continues execution and returns to the monitor just after the next RTS or RTI is executed.

step [<count>]
z [<count>]

Single step through instructions. An optional count allows stepping more than a single instruction at a time.

stopwatch [reset]

Print the CPU cycle counter of the current device. ’reset’ sets the counter to 0.

undump "<filename>"

Read a snapshot of the machine from the file specified.


Next: Memory commands, Previous: Terminology, Up: Monitor   [Contents][Index]