SCRYMAMEReferenceReadAlso in DOSBox-X

The Read tools

These tools read the program without writing to it: bytes of memory, the registers, the code at an address, the instructions that ran before a stop. They need the program stopped at the debugger; while it runs they refuse (not_stopped), except where an entry says otherwise.

An address is a ref: a symbol of your program, or a number written 0x. Bare hex that names no symbol is refused (unknown_ref), with the 0x spelling it most likely meant.

On a board with several cpus, a call that names no cpu acts on the one the debugger is showing. read_memory, registers and memdump read another only on a MAME whose gdbstub serves each cpu as a thread; status lists them in threads. Without that they read the first cpu and refuse any other (bad_argument).

Three of them run one instruction

read_block, screen_map_find and screen_map_write's add go through MAME's Lua console, which runs one instruction to answer. Their replies end with the readings of the new stop, as lua's does. They write nothing to the program.

The tools