Buggy ===== Datum: 8. 7. 1991 Autor: Dietmar Rabich, D”velingsweg 2, D-W4408 Dlmen, Tel. 02594-86103, (bis Ende 1991) Koppelbusch 37, D-W4408 Dlmen-Hausdlmen, (ab Anfang 1992) Buggy ist ein Debuggingtool fr Pure C-Programme. Es wird als Modul zu einem Programm hinzugelinkt. Innerhalb des Programms werden Hilfs- texte ber die Funktion Buggy() ausgegeben. Sehen Sie sich bitte das Demonstrationsprogramm an! Folgende Funktionen oder Makros stehen zur Verfgung: Buggy : die Debugfunktion (Ausgabem”glichkeit wie printf()!!) BuggyB : Ausgabe von 1-Byte-Variablen (Name und Inhalt) BuggyW : Ausgabe von 2-Byte-Variablen (Name und Inhalt) BuggyL : Ausgabe von 4-Byte-Variablen (Name und Inhalt) BuggyS : Ausgabe von Strings (Name und Inhalt) SetBuggyMode : Setzen des Ausgabemodus SetBuggyDelay: Setzen der Verz”gerung zwischen zwei Zeichen bei Ausgabe ber MIDI SetBuggyName : Setzen eines Namens, der der Ausgabe vorangestellt wird Es stehen folgende Ausgabeger„te/-modi zur Verfgung: B_NULL : keine Ausgabe B_STDOUT: Standardausgabekanal B_STDERR: Standarderrorkanal (Default) B_STDAUX: Standardschnittstelle (seriell) B_STDPRN: Standarddrucker B_MIDI : Ausgabe ber MIDI B_GEM : Ausgabe ber Alertboxen Die Ausgabeform kann auch statt mit SetBuggyModus() auch mit der Environmentvariablen BUGGYMODE gesetzt werden. Die so bestimmte Ausgabe- form hat h”chste Priorit„t! Die Werte sind ohne "B_" anzugeben. Bei- spiel: BUGGYMODE=STDERR. Bei Ausgabe ber die MIDI-Schnittstelle muá der MIDI-Ausgabeport des Rechners, auf dem getestet wird, mit dem MIDI-Eingabeport des Rechners verbunden sein, auf dem die Texte ausgegeben werden sollen. Ferner muá auf dem Ausgaberechner R_BUGGY.TOS gestartet sein! Bei Ausgabe ber Alertboxen muá der Aufruf von appl_init() bereits erfolgt sein. Alle Funktionen, die bei der Abmeldung aufzurufen sind, werden m”glichst in einer ber atexit() angemeldeten Funktion zusammen- gefaát. In dem Demonstationsprogramm ist dafr ein Beispiel gegeben. (Der Grund fr diese Art der Programmierung ist die M”glichkeit, das laufende Programm bei einer beliebigen Buggy-Meldung abzubrechen. Buggy ruft dann exit() mit dem Returncode -999 auf. Somit erfolgen alle not- wendigen Abmeldungen!) Die Weitergabe von Buggy ist nicht gestattet. Buggy darf nur fr nicht- milit„rische Zwecke eingesetzt werden. Es wird keinerlei Haftung fr eventuell durch den Betrieb von Buggy entstehende Soft-, Hardware- oder sonstige Sch„den bernommen. Zu Buggy geh”ren die Dateien - BUGGY.O - das Modul fr eigene Pure-C-Programme (oder ersatzweise BUGGY.C und BUGGY.PRJ) - BUGGY.H - die Headerdatei fr die Funktionsaufrufe - BDEMO.APP - das Demonstationsprogramm - BDEMO.C - der Quelltext des Demonstationsprogramms - BDEMO.PRJ - die Projektdatei fr das Demonstationsprogramm - BUGGY.TXT - die Anleitung - R_BUGGY.TOS - das Empfangsprogramm bei šbertragung via MIDI (oder ersatzweise R_BUGGY.C) ------------------------------------------------------------------------ Copyright by Dietmar Rabich, Dlmen. Alle Rechte vorbehalten!! ------------------------------------------------------------------------