Christian Fuchs                                Mnchen, den 1.2.1995


Nach langjhriger Entwicklungsarbeit habe ich mich entschieden, das Pro-
grammpaket ASSDEBUG freizugeben, obwohl die Falcon-Untersttzung von
SMON noch ungetestet ist; mehr dazu bei "Installation von SMON". Die
wichtigsten Programme des Pakets sind der Debugger SMON, der resident
geladen wird und mit seinem eingebauten 68060-Disassembler jedes Pro-
gramm "richtig" behandeln kann, sowie der Reassembler SREASS, der ein
uerst leistungfhiges Werkzeug zur Rckverwandlung von Programmen zu
Quelltexten darstellt.

Alle Programme von ASSDEBUG sind S h a r e w a r e; die Shareware-
Gebhr betrgt 50 DM, was angesichts der Leistungsfhigkeit der Program-
me lcherlich gering ist. Es stecken tausende Stunden Entwicklungsarbeit
in den Programmen, alles ist rein in Assembler programmiert! Wer die Pro-
gramme nur ab und zu fr kleinere Aufgaben bentigt, braucht die Share-
ware-Gebhr nicht bezahlen und sollte mit der kleinen Kurzanleitung weiter
unten in diesem Dokument zurechtkommen. Wer allerdings intensiv mit den
Programmen arbeiten mchte, braucht unbedingt die Handbcher zu den
Programmen, um alle Mglichkeiten ausschpfen zu knnen. Die Handb-
cher bekommt man bei der Registrierung (s. Ende des Textes).


Nun eine kleine bersicht ber die Programme:

- SMON     :  residenter Debugger, uerst leistungsfhig
- SMONCNFG :  Konfigurationsprogramm fr SMON
- ENTRSMON :  Programm zum Einsprung in den Debugger
- SDEBUG   :  ldt Programm fr SMON, dann Sprung in den Debugger
- EXECBOOT :  ldt Bootsektorprogramm, dann Sprung in den Debugger
- SREASS   :  leistungsfhiger, interaktiver Reassembler

Das Programmpaket darf nur als ganzes incl. README.TXT weitergegeben
werden.


Installation von SMON:

Eine Installation im eigentlichen Sinne ist nicht ntig, Sie knnen jederzeit
SMON vom Desktop oder sonstwo aus starten. SMON bleibt dann resident
im Speicher und "wartet", bis eine Exception auftritt, ein Breakpoint "ge-
sichtet" wird, die Abbruchbedingung einer selbstprogrammierten Trace-Rou-
tine erfllt ist, die Tastenkombination 'Alternate'+'Shift' (rechte Shift-Taste)
gedrckt wird oder von einem anderen Programm wie ENTRSMON oder
EXECBOOT aufgerufen wird. Wer ca. 60 kB Speicher entbeeren kann und
SMON regelmig nutzen will, sollte SMON in den AUTO-Ordner kopieren.

Etwas mehr Mhe haben Besitzer eines ST mit eingebauter Grafikerweite-
rung wie z. B. Overscan o. . (Grafikkarten werden nicht untersttzt). Sie
mssen mit dem Programm SMONCNFG die Patchvariablen von SMON auf
die entsprechende Art der Videoumschaltung setzen.

Achtung Falcon-Besitzer!!! Die Programmierung der Falcon-Videohardware
ist zwar implementiert, aber mangels Falcon ungetestet. Im Klartext, ich
kann nicht garantieren, da SMON in der Version 1.02 auf dem Falcon ein-
wandfrei funktioniert! Wer SMON in der Version 1.02 auf dem Falcon star-
tet, mu sich darber im Klaren sein, da bei einem Programmfehler zu-
mindest theoretisch die Mglichkeit besteht, da der angeschlossene Moni-
tor (wenn, dann schwer) beschdigt wird! Da ich natrlich daran interes-
siert bin, zu erfahren, ob SMON auch auf dem Falcon funktioniert, mchte
ich mutigen Leuten ein Angebot machen: den ersten drei Testern (beim
Test eines SM124 auf alle Flle), die mir mitteilen, wie sich SMON auf
dem Falcon verhlt, werden die Sharewaregebr erlassen und die Handb-
cher zu den Programmen zugesandt. Besonders gro sollte die Gefahr fr
einigermaen gute Monitore nicht sein, da diese bei falscher horizontaler
Ablenkfrequenz die Synchronisation verweigern, was sie vor Beschdigung
schtzt; aber wer wei schon, ob sich sein Monitor in dieser Beziehung
"gutmtig" verhlt?. Da der Falcon standardmig drei verschiedene Bild-
schirmmodi kennt, sollten mglichst alle getestet werden: der VGA-Modus,
der ST-Hoch-Modus (fr SM124, SM144 oder kompatible Monitore) und der
RGB/TV-Modus. Der VGA-Modus wird aktiv beim Anschlu eines VGA-Mo-
nitors sowie eines Multiscan-Monitors, falls dieser ber einen VGA-Adapter
angeschlossen wird; der ST-Hoch-Modus wird aktiv beim Anschlu eines
SM124-Adapters; der RGB/TV-Modus wird aktiv beim Anschlu eines
SC1224 o. . RGB-Monitors oder eines Fernsehgerts ber den Modulator-
Ausgang. Jeder Falcon-Tester sollte also zustzlich zu seinem Monitor auch
ein Fernsehgert anschlieen, wobei an der Monitor-Buchse des Falcon
nichts angesteckt sein darf!


Kurzbeschreibung von SMON:

Wenn SMON resident ist, kann durch Drcken von 'Alternate'+'Shift'(rechts)
in den Debugger (auch "Monitor" genannt) gesprungen werden. Mit "help"
wird eine komplette Befehlsbersicht sowie die Tastaturbelegung ausgege-
ben. Mehr ist zu SMON hier eigentlich nicht zu sagen.


Kurzbeschreibung von SREASS:

SREASS ist ein Reassembler, d. h. ein Programm, das ausfhrbare Pro-
grammdateien (oder Bootsektoren oder Speicherbereiche (TOS!)) in Assem-
bler-Quelltext verwandelt. Besonders gute Erfolge erzielt man damit natur-
gem bei Programmen, die in Assembler programmiert wurden, aber auch
compilierte Programme lassen sich mit SREASS "behandeln".
Nachdem man festgelegt hat, was man denn gerne reassemblieren mchte,
wo Hilfsdateien abgelegt werden drfen und fr welchen Mikroprozessor
der Quelltext erzeugt werden soll, ffnet sich ein Fenster, und der interak-
tive Teil der Rckbersetzung beginnt: der erste Befehl des Programms
wird angezeigt, SREASS wartet auf Ihre Aktionen. Die nun geltende Ta-
stenbelegung kann man sich durch Drcken der 'Help'-Taste anzeigen las-
sen. Um es noch einmal unmiverstndlich zu sagen: Sie selbst mssen
das Programm disassemblieren, insbesondere wenn der Disassembler auf
Daten stt, die sich nicht als Befehl interpretieren lassen, mssen Sie das
Datenformat festlegen und mit den Cursortasten weitermachen, bis Sie wei-
tere Befehle vermuten und probeweise die Space-Taste drcken.
Nach Abschlu der interaktiven Disassemblierung knnen diverse Optionen
festgelegt werden, woraufhin der Quelltext erzeugt wird.


Ich mchte noch einmal ausdrcklich darauf hinweisen, da trotz der ein-
gebauten Befehls-/Kommando-bersichten wichtige und ntzliche Fhigkei-
ten der Programme verborgen bleiben, wenn man nicht das Handbuch be-
sitzt. Aus diesem und aus Fairness-Grnden sollten Sie sich bei regelmi-
ger Benutzung registrieren lassen. Wer den Quelltext des Disassemblers fr
ein eigenes Projekt haben will, soll sich unter der unten genannten Adresse
oder per E-Mail mit mir in Verbindung setzen.

Um sich registrieren zu lassen, senden Sie mir einen an sich selbst Adres-
sierten Umschlag zu (etwas grer als A4!), der ausreichend frankiert ist
fr ca. 20 A4-Bltter + evtl. eine Diskette (momentanes Porto: 3 DM mit
oder ohne Diskette); legen Sie einen Scheck ber 50 DM bei oder ber-
weisen sie den Betrag auf mein Konto Nr. 903-165538 bei der Stadtspar-
kasse Mnchen, BLZ 701 500 00.
Das erste Update ist kostenlos, fr weitere wird eine Bearbeitungsgebhr
von 3 DM in Briefmarken erhoben.

Das erste Update ist kostenlos, fr weitere wird eine Bearbeitungsgebhr
von drei DM in Briefmarken erhoben.


Anschrift bis ca. August 1995:

Christian Fuchs
Kaiserplatz 13
80803 Mnchen


Andere mgliche Anschrift (unbefristet, aber evtl. lngere Bearbeitungszeit):

Christian Fuchs
Tulpenstr. 11
84513 Tging


E-Mail-Adresse in Internet (fr Anfragen oder Fehlerberichte):

cff@ipp-garching.mpg.de  (gltig bis mind. Juni 1995)




Geschichtliches

21.10.1994  Erstverffentlichung
18.12.1994  nderung der Tastaturinterruptroutine von SMON
            -> SMON V 1.01
2.1.1995    Streichen der Fehlerabfrage von WIND_UPDATE(END_UPDATE)
            wegen eines Fehlers(?) in MAGIC bei SREASS
            -> SREASS V 1.41
30.1.1995   Nochmalige nderung der Tastaturinterruptroutine von SMON
            Fehler bei Cookie-Installation von SMON behoben
            Fehler bei Kommando 'G' im Single-Step-Modus von SMON
            behoben
            -> SMON V 1.02
