CP/M Debugger

Hier eine Übersicht über Debugger — und der von mir modifizierten Version —, die von Digital Research vertrieben wurden mit einer Zusammenstellung der vorhandenen Kommandos:

Befehl	Debugger → ↓ Funktion	DDT	SID	ZSID	ZSID mod
?	Help	---	---	---	?
A	Assemble	As	{-}A{s}	{-}A{s}	{-}A{s}
B	Search	---	---	---	B{"}s{"}
C	Call	---	Cs{b{,d}}	Cs{b{,d}}	Cs{b{,d}}
D	Display	D{s{,f}}	{-}D{W}{s}{,f}	{-}D{W}{s}{,f}	{-}D{W}{s}{,f}
E	Execution	---	Epgm-file{,sym-file}	---	Epgm-file{,sym-file}
F	Fill memory	Fs,f,c	Fs,f,d	Fs,f,d	Fs,f,d
G	Go	G{s{,b{,c}}}	{-}G{p}{,a{,b}}	{-}G{p}{,a{,b}}	{-}G{p}{,a{,b}}
H	Hex	---	H{a,b}	H{a,b}	H{a,b}
I	Input line	Ifilename{.typ}	Icommand tail	Icommand tail	Icommand tail
L	Lists mnemonics	L{s{,f}}	{-}L{s}{,f}	{-}L{s}{,f}	{-}L{s}{,f}
M	Move	Ms,f,d	Ms,h,d	Ms,h,d	Ms,h,d
O	Other bank	---	---	---	O{b}
P	Pass point	---	{-}P{p{,c}}	{-}P{p{,c}}	{-}P{p{,c}}
Q	Quit	---	---	---	Q
R	Read	R{b}	Rfilespec{,d}	R{d}	Rfilespec{,d}
S	Set memory	Ss	S{W}s	S{W}s	S{W}s
T	Trace	T{n}	{-}T{W}{n{,c}}	{-}T{W}{n{,c}}	{-}T{W}{n{,c}}
U	Untrace	U{n}	{-}U{W}{n{,c}}	{-}U{W}{n{,c}}	{-}U{W}{n{,c}}
V	Value	---	V	---	{-}U{W}{n{,c}}
W	Write	---	---	---	Wfile,s,f
X	Examine	X{r}	X{f}{r}	X{f}{r}	X{f}{r}

Der Debugger soll ein Programm untersuchen, das in die TPA, also ab Adresse 0x0100, geladen wird. Auch der Debugger ist ein Programm, das in diese Adresse geladen wird.

Deshalb ist allen Debuggern gemeinsam, dass sie zunächst direkt unter das BDOS verschoben werden. Sie bestehen daher aus zwei Teilen:

Ein Ladeprogramm, welches den eigentlichen Debugger unter das BDOS verschiebt
Der Code für den Debugger gefolgt von einer Bitmap für die Relokation

Die Debugger unterstützen die Ein- und Ausgabe von Mnemonics (Befehle A und L). Außer beim DDT kann dieser Bereich abgetrennt werde, so dass auch größere Programme in den Speicher geladen werden können.

Falls Änderungen des Programmcodes durchgeführt wurden, ist eine Speicherung des neuen Codes notwendig. Unter CP/M 2 gab es dafür den eingebauten Befehl SAVE. Dieser steht allerdings unter CP/M 3 nicht zur Verfügung, weil der CCP, anders als bei CP/M 2, in der TPA ab Adresse 0x0100 abgelegt ist. Unter CP/M 3 gibt es jedoch das Programm SAVE, was vor Aufruf von (Z)SID aktiviert werden musste. Nach Ende des Debuggers wurde dann abgefragt, welcher Speicherbereich in eine Datei geschrieben werden soll. Ich habe dafür das neue Kommando W eingeführt, um die Handhabung zu erleichtern.

Hinweise zu weiteren Debuggern finden sich hier

Werner Cirsovius

Zusammengestellt Mai 2010