SCRYMAMEReferenceMachineAlso in DOSBox-X
The Machine tools
These tools describe the machine a session runs and read what MAME logs about it. cpu_info and machine_map say what is there: the cpus, their memory, the screens, the ROM files. log and log_wait read the lines MAME writes.
All four answer while the program runs. A cpu is named by its MAME tag, with or without the leading colon: subcpu or :subcpu.
The tools
cpu_infoList each cpu as the debugger sees it: visible, ignored or suspended, its program counter, and the breakpoints and watches set on it.machine_mapGet the layout of the machine: its cpus and their address spaces, the address map, memory regions and shares, screens and ROM files.logRead the newest log lines that match a pattern: from MAME's own log, from the process's output, or from both.log_waitWait until a log line matches a pattern, or get the line at once when the log already has it.