Welcome to the MAME debugger V0.54!
 
Many commands accept either a value or a register name. 
You can indeed type either "R HL = SP" or "R HL = 1FD0".
In the syntax, where you see <address> you may generally
use a number or a register name of the active CPU.
A <boolean> can be specified as ON/OFF, YES/NO, Y/N or 1/0.
Note: You may put your preferences into a file "mamedbg.cfg" in your
main directory. Furthermore you can put game specific settings into a
set of files <driver>.cf<cpu>, eg. "dkong.cf0" and "dkong.cf1".
The files can contain different settings for the CPUs of a game.

Valid commands and keys are:

A [<update>]
Animate (trace) and update display once per frame [or every <update> opcode

D <1|2> <address>
Display memory <1|2> starting at <address>

E <1|2> [<address>]
Edit memory window <1|2> [at <address>]

M <1|2> [BYTE|WORD|DWORD]
Change memory window mode to default [to BYTE|WORD|DWORD (or 0|1|2)]

F
Fast

G [<address>]
Go [and break at <address>]

J <address>
Jump to <address> in disassembly window

R <register> <value>
Replace <register> with <value> (<value may also be a <register>)

BP <address> [<times>] (aka BPX]
Break on execution of <address> [after ignoring it <times>]

BC
Clear execution breakpoint

RP <register> [<value> [<mask>]] 
Break if <register> changes [to <value> [compare after applying <mask>]]

RC
Clear register watchpoint

WP <address> [<value>] (aka BPW)
Break if data at <address> changes [to <value>]

WC
Clear data watchpoint

HERE
Run to cursor

DASM <filename> <start> <end> [<boolean>]
Disassemble to <filename> from address <start> to <end>
Opcode dump on by default [OFF|NO|0 without]

DUMP <filename> <start> <end> [<data size> [<ASCII mode> [<prog/data memor
Dump to <filename> from address <start> to <end>
[data size BYTE|WORD|DWORD] (also 0|1|2)]
[PROG or DATA memory (also 0|1) for CPUs supporting it]

TRACE {<filename> [<reg1> [<reg2>...]]}|OFF
Trace to <filename> [dumping <reg1> [reg2...]] | OFF to stop trace

SAVE <filename> <start> <end> [OPCODES|DATA]
Save binary to <filename> from address <start> to <end>
[either OPCODES (from OP_ROM, default) or DATA (from OP_RAM), also 0|1].

IGNORE <cpunum>
Ignore CPU #<cpunum> while debugging or tracing

OBSERVE <cpuname>
Observe CPU #<cpuname> while debugging or tracing

REPEAT rate
Set keyboard initial repeat rate (rate/frame will decrease to 1/frame)

CASE DEFAULT|LOWER|UPPER (also 0|1|2)
Set disassembly case style

OPCODES (boolean)
Display opcodes in disassembly window

RELATIVE (boolean)
Display relative jump address in disassembly window

SQUEEZE (boolean)
Allow squeezed normal display

COLOR <element> <foreground> [<background>]
Set <element> color to <foreground> on BLACK [or <background>].
For a list of <elements> and <colors> see mamedbg.cfg

[Up Arrow]      Move cursor up in disassembly window

[Down Arrow]    Move cursor down in disassembly window

[PgUp]          Move cursor up one page in disassembly window

[PgDn]          Move cursor down one page in disassembly window

[HOME]          Move cursor to first page in disassembly window

[END]           Move cursor to last page in disassembly window

[Left Arrow]    Back to the previous point in 'follow history'

[Right Arrow]   Follow the current instruction's code or data reference

[Tab]           Switch between windows (backwards SHIFT+TAB)

[F1]            Help - maybe you realized this ;)

[F2]            Toggle breakpoint at current cursor position

[F4]            Run to Cursor

[F6]            Set the focus to the next (not ignored) CPU

[F8]            Step one instruction

[F9]            Animate (trace) at speed set by last "A" command

[F10]           Step over instruction at Cursor (i.e. execute call, jsr, bsr)

[F12]           Go!

[Escape]        Go!


Onscreen docs (when used with the arcadia emulation) retyped from screen by Adam Trionfo, June 9, 2002 - Version 1.01.
