Next: Memory commands, Previous: Terminology, 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]