home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Computer Club Elmshorn Atari PD
/
CCE_PD.iso
/
pc
/
0600
/
CCE_0632.ZIP
/
CCE_0632
/
GOBJ_111.ZIP
/
GOBJECTS.111
/
DOKU
/
XACCSPY.TXT
< prev
Wrap
Text File
|
1994-03-25
|
8KB
|
161 lines
"XAcc-Spy" - Der XAcc-Spion (Version 25.03.1994)
================================================
Dieses Programm ist FREEWARE, d.h. es darf und soll weitergegeben und
benutzt werden. Die Weitergabe ist gestattet, sofern die Dateien
XACCSPY.APP, XACCSPY.TXT (diese Datei) und der Ordner SOURCE zusammen
und unverändert weitergegeben werden. Wird das Programm in PD-Serien
aufgenommen, auf CDs gepreßt etc., möge man sich doch bitte um die
aktuellste Version kümmern.
Meine Adresse: Thomas Much, Gerwigstraße 46, 76131 Karlsruhe
Tel. (0721) 62 28 41
EMail: Thomas_Much@KA2.MAUS.DE
UK48@ibm3090.rz.uni-karlsruhe.de
XACCSPY.ZIP sollte auf jeden Fall in den Mäusen KA, HAL und HL zu
finden sein (Achtung: Kein Gastdownload von 18-21.45 Uhr).
Wozu ist XAcc-Spy gut?
----------------------
XAcc-Spy ist eine Art "XAcc-Debugger", d.h. in einem Fenster werden
alle laufenden Applikationen angezeigt, die das XAcc-(bzw. AV-)Proto-
koll unterstützen. Dazu erhält man alle XAcc-Parameter (s.u.), mit
denen man solche Programme recht gut einschätzen kann. Diese Anleitung
soll allerdings die XAcc-Doku nicht ersetzen, auf sie sei deshalb an
dieser Stelle verwiesen.
Installation und Anwendung
--------------------------
XAcc-Spy kann sowohl als Programm als auch als Accessory eingesetzt
werden. Beim Einsatz als Programm kann man Accessories auf das XAcc-
Protokoll hin untersuchen, mit dem Accessory kann man entsprechend
ein Hauptprogramm gut untersuchen.
Bei der Verwendung unter MultiTOS sollte der Programmtyp egal sein,
allerdings kann es sein, daß einige Programme noch nicht die "neue"
XAcc-Definition unterstützen, so daß man evtl. ein bißchen herum-
probieren muß (s. "Debugging").
Als Tastatursteuerung kommen derzeit nur <Control>+<Q>, <Control>+
<U>, <Control>+<W> und <Control>+<*> (sowie die gängigen Tasten
<Return>, <Help> etc.) in Frage, ansonten muß die Maus bemüht werden.
In dem Fenster werden alle gefundenen XAcc-Applikationen unterein-
ander angezeigt. Die Zeilen sind folgendermaßen aufgebaut:
Ganz links steht der Name der Applikation. Daneben stehen die AES-
ID und die Nummer des Menüeintrags. Unter einem Nicht-Multitasking-
TOS kennzeichnet apID=0 das Hauptprogramm, das dann auch keinen Menü-
eintrag besitzen sollte (meistens wird dann meID=-1 übergeben).
Dann folgt die Programm-Version, die von der XAcc-Applikation be-
liebig gesetzt und kodiert werden kann. Es folgen noch die unter-
stützten Message-Groups. Jeder Unterstrich kennzeichnet eine Gruppe;
wenn dort die entsprechende Zahl (von rechts nach links) eingetragen
ist, wird diese XAcc-Message-Gruppe verstanden. Links von den Gruppen
wird noch die Art des verstandenen Protokolls angezeigt (a=AV-Proto-
koll, x=XAcc-Protokoll).
Schließlich können noch "Extended Names" vorhanden sein. Mit diesen
kann die Applikation einen maschinenlesbaren Programmtyp (normaler-
weise zwei große Buchstaben) sowie einen entsprechenden "Menschen-
lesbaren" Programmtyp angeben. Außerdem können "Extended Features"
gesetzt werden, die aber normalerweise nur zwischen "gut bekannten"
Programmen versendet und verstanden werden. Ganz zum Schluß folgt
noch der generische Name; dieser kann gesetzt sein, wenn das
Programm nicht überall den gleichen "offiziellen" Namen besitzt,
aber dennoch eindeutig erkannt werden muß.
Alle Buttons im Fenster und in der Toolbar unterstützen die Bubble-
Help (Anklicken des gewünschten Buttons mit der _rechten_ Maus-
taste), so daß sich eine weitere Erklärung hier erübrigt.
Unter MultiTOS bzw. mit dem ICFS-Server wird auch Iconification
unterstützt. In dem Icon-Fenster wird dann nur noch die Anzahl der
gefundenen XAcc-/AV-Applikationen angezeigt.
"Debugging"
-----------
Singletasking-TOS:
Wird XAcc-Spy als Programm gestartet, sollten sofort alle ge-
fundenen XAcc-Applikationen angezeigt werden; an deren Zahl
darf sich eigentlich nichts mehr ändern.
Beim Einsatz als Accessory ist es normal, daß sich nach jedem
Start oder Verlassen eines Hauptprogramms die Liste ändert,
je nachdem ob das Hauptprogramm XAcc unterstützt oder nicht
(unter dem GEM-Desktop z.B. ist die Liste immer leer). Aller-
dings kann man bei einigen Accessories beobachten, daß diese
_nur_ mit dem Hauptprogramm kommunizieren und nicht (wie es die
XAcc-Definition vorsieht) auch mit den anderen Accessories...
Multitasking-TOS:
Die Liste sollte für das Accessory bzw. für das Programm
gleich aussehen. Unterschiede wird es nur geben, wenn andere
Programme evtl. die XAcc-Multitasking-Definition nicht kennen.
Wird ein neues XAcc-Programm oder -Accessory gestartet (oder
verlassen), reagiert der XAcc-Spy mit einem automatischen Up-
date der Liste!
Ein paar Beispiele, welche Programme was anzeigen:
ObjectGEM-Programme geben normalerweise an, daß sie die Message-
Groups 1 und 2 verstehen (meistens wird eine entsprechende An-
frage allerdings per ACC_ACK zurückgewiesen, siehe ObjectGEM-
Doku). Diese Applikationen sollten allgemein _keine_ Probleme
mit XAcc haben. Außerdem verstehen ObjectGEM-Programme sowohl
das XAcc- als auch das AV-Protokoll.
Mit CAT kann man sehr schön die "Extended Names" sehen. So
wird als Applikationstyp "DB" (für Datenbank) bzw. etwas les-
barer "MausTausch-Programm" zurückgegeben. Leider ist die
Abmeldung beim Programmende unter MultiTOS noch nicht ganz
korrekt.
Am besten (der von mir getesteten Programme) wird das XAcc-
Protokoll von Connect beherrscht. Unter MultiTOS sieht es
wirklich toll aus, wenn die XAcc-Liste bei Programmstart und
-ende entsprechend aktualisiert wird :-)
Was man sonst noch über XAcc-Spy wissen sollte
----------------------------------------------
Wie man vielleicht am beiliegenden Quelltext erkennt, ist XAcc-Spy
ein ObjectGEM-Programm. Zur Programmierung wurde die neue ObjectGEM-
Version 1.11 verwendet.
Aus dem objektorientierten Ansatz ergibt sich eine für ein "Diagnose"-
Programm unübliche Größe. XAcc-Spy ist allerdings nicht unbedingt zum
dauerhaften Einsatz vorgesehen, sondern eigentlich dazu, um "mal eben"
zu überprüfen, ob ein Programm das XAcc-Protokoll korrekt beherrscht.
Außerdem ist der Quelltext recht übersichtlich und entsprechend ein-
fach zu warten. Und man darf nicht vergessen, daß der Spion FREEWARE
ist, weshalb er von mir auch zum Testen der neuesten ObjectGEM-
Features "mißbraucht" wird...
Schließlich muß ich noch darauf hinweisen, daß XAcc-Spy bei mir zwar
wunderbar läuft, daß ich dies aber nicht garantieren kann. Wer XAcc-
Spy einsetzt, tut dies AUF EIGENE GEFAHR. Sollte tatsächlich ein
Fehler auftreten und ich davon erfahren, werde ich diesen nach
Möglichkeit eliminieren.
So, nun aber viel Spaß beim "XAcc-debuggen", auf daß möglichst viele
"schwarze Schafe" entlarvt werden, damit sich das XAcc-Protokoll
noch besser durchsetzen kann! ;-)
Bekannte Bugs
-------------
- unter Mag!x wird z.Z. noch nicht das XAcc-MT-Protokoll verwendet,
d.h. der XAcc-Spy wird dort andere Hauptprogramme wahrscheinlich
_nicht_ erkennen (das wird sich aber bald ändern ;-)
- bei zwei installierten XAcc-Spionen kann es unter "normalem" TOS
zu Problemen mit der Resource kommen; Bugfixing läuft...
Release-History
---------------
25.03.94
- komplette Überarbeitung der Oberfläche
- das AV-Protokoll wird ausgewertet
- History-Fenster zum Mitprotokollieren der empfangenen Messages
- ein Bug, durch den bei Verwendung von XAcc-Spy als Acc evtl. nicht
alle anderen XAcc-Accs erkannten wurden, ist beseitigt
04.02.94
- die drei Bomben unter alten TOS-Versionen (bzw. die Memory Violation
unter MultiTOS) sollten beseitigt sein (offensichtlich ein PP-Bug...)
26.01.94
- erste öffentliche Version