This is an old version from the tos.hyp. The new is on GitHub!

15.1 AV-Protokoll

Das AV-Protokoll (Accessory-Venus) wurde von Stefan Eissing entwickelt und zuerst im alternativen Desktop Gemini eingesetzt. Mittlerweile wird dieses Protokoll jedoch von vielen weiteren Shells (Ease, MagXDesk, Thing, ...) unterstützt. Dieser Abschnitt beschreibt die Version des Protokolls aus der Gemini-Distribution vom 29. Januar 1995 (Gemini 1.a).

Die Kommunikation zwischen zwei Prozessen erfolgt beim AV-Protokoll über den Austausch von (erweiterten) AES-Nachrichten, die sich einer der folgenden Kategorien zuteilen lassen:

• AV-Funktionen (Client –> Server)
• VA-Funktionen (Server –> Client)

Achtung: An dieser Stelle sei darauf hingewiesen, daß im Hinblick auf zukünftige Betriebssystem-Versionen zur Kommunikation zwischen verschiedenen Programmen benutzte oder über Zeiger zugewiesene Speicherbereiche global sein müssen (Mxalloc-Funktion mit Global-Flag). Andernfalls wird es beim Einsatz auf Rechnern mit PMMU (z.B. Atari-TT oder Falcon) zu Speicherschutzverletzungen kommen.

Sollten in Nachrichten Pfade oder Dateinamen vorkommen, so muß immer der absolute Pfad angegeben werden (also mit Laufwerk) und die Laufwerksbuchstaben müssen Großbuchstaben sein. Pfade sollten immer mit einem Backslash enden!

Mit AV_PROTOKOLL kann jede Applikation nachfragen, welche Nachrichten verstanden werden (nicht alle Shells unterstützen das vollständige Protokoll). Es wäre schön, wenn auch andere Programme auf dieses Protokoll reagieren würden. Zumindest AV_SENDKEY ist sicher leicht zu implementieren und ist die einzige Methode, wie über Nachrichten Tastaturdrücke simuliert werden können.

Unter normalem TOS fragt dazu ein Accessorie, wenn es eine AC_CLOSE-Nachricht vom AES erhalten hat, die Applikation (mit ID) 0 per AV_PROTOKOLL ob sie etwas davon versteht. In einer Multitasking-Umgebung (MultiTOS, MiNT/N.AES oder MagiC) muß aber das Programm nicht mehr die ID 0 haben, zudem kommt es (fast) nicht mehr zu AC_CLOSE-Nachrichten. Außerdem können nicht nur Accessories, sondern auch normale Programme mit dem AV-Server kommunizieren wollen. Was tun?

Wenn es mehr als eine Hauptapplikation geben kann, dann sollte das Programm bzw. Accessory versuchen, mit GEMINI Kontakt aufzunehmen. Die ID kann ja mit appl_find ermittelt werden. Scheitert dies, so kann noch nach AVSERVER oder dem Inhalt der (AES)-Environmentvariable AVSERVER gesucht werden. Besonders die letzte Möglichkeit erlaubt eine leichte Konfiguration von außen. Die neuen Versionen der Library VAFUNC von Stephan Gerle (in gutsortierten Mailboxen erhältlich) verfahren fast genauso.

Querverweis: Nachrichten Drag&Drop-Protokoll OLGA-Protokoll

15.1.1 AV-Protokoll, Quoting im

Mit Quoting ist im AV-Protkoll gemeint, daß Dateinamen optional mit einfachen Anführungszeichen 'name' versehen werden können. Dies ist aber nur erlaubt, wenn beide Parteien (Server und Client) sich darüber einig sind, d.h. es verstehen können.

Wie geht das also vor sich? Angenommen der Server schickt an eine Applikation einen Dateinamen, der ein Leerzeichen enthält. Eine Applikation, die Quoting nicht kann, wird statt einem zwei Dateinamen erkennen, da normalerweise Leerzeichen Dateinamen trennen. Versteht die Applikation aber Quoting (Bit 4 in seinem Protokollstatus), so wird der Server den Dateinamen mit umgeben und die Applikation erkennt, daß das Leerzeichen zum Dateinamen gehört. Gleiches gilt natürlich auch für Dateinamen, die von einer Applikation an einen Server geschickt werden.

Die Frage bleibt, wie man denn nun einfache Anführungszeichen überträgt. Nun, solche Zeichen, die zum Dateinamen gehören, werden einfach verdoppelt. Aus Zorro's Hypertext wird für die Übertragung 'Zorros Hypertext'. In diesen Fällen wird also die gleiche Methode wie beim Drag&Drop-Protokoll eingesetzt.

Querverweis:
AV_PROTOKOLL   VA_ACC_QUOTING(a)   VA_SERVER_QUOTING(a)   VA_PROTOSTATUS   Drag&Drop-Protokoll

15.1.2 AV-Funktionen

Diese Nachrichten werden von einer Applikation an Gemini bzw. einen vorhandenen AV-Server geschickt.

Querverweis: VA-Funktionen   Nachrichten

15.1.2.1 AV_ACCWINDCLOSED

15.1.2.2 AV_ACCWINDOPEN

15.1.2.3 AV_ASKCONFONT

15.1.2.4 AV_ASKFILEFONT

15.1.2.5 AV_ASKOBJECT

15.1.2.6 AV_COPY_DRAGGED

15.1.2.7 AV_COPYFILE

15.1.2.8 AV_DELFILE

15.1.2.9 AV_DRAG_ON_WINDOW

15.1.2.10 AV_EXIT

15.1.2.11 AV_FILEINFO

15.1.2.12 AV_GETSTATUS

15.1.2.13 AV_OPENCONSOLE

15.1.2.14 AV_OPENWIND

15.1.2.15 AV_PATH_UPDATE

15.1.2.16 AV_PROTOKOLL

15.1.2.17 AV_SENDCLICK

15.1.2.18 AV_SENDKEY

15.1.2.19 AV_SETWINDPOS

15.1.2.20 AV_STARTED

15.1.2.21 AV_STARTPROG

15.1.2.22 AV_STATUS

15.1.2.23 AV_VIEW

15.1.2.24 AV_WHAT_IZIT

15.1.2.25 AV_XWIND

15.1.3 VA-Funktionen

Diese Nachrichten werden von einem vorhandenen AV-Server an eine Applikation geschickt.

Querverweis: AV-Funktionen   Nachrichten

15.1.3.1 VA_ACC_QUOTING(a)

Dies ist ein Test des Protokollstatus auf Quoting. In C läßt sich der Test als Makro wie folgt realisieren:

#define VA_ACC_QUOTING(a)   ((a) & 0x10)

15.1.3.2 VA_CONFONT

15.1.3.3 VA_CONSOLEOPEN

15.1.3.4 VA_COPY_COMPLETE

15.1.3.5 VA_DRAGACCWIND

15.1.3.6 VA_DRAG_COMPLETE

15.1.3.7 VA_FILECHANGED

15.1.3.8 VA_FILECOPIED

15.1.3.9 VA_FILEDELETED

15.1.3.10 VA_FILEFONT

15.1.3.11 VA_FONTCHANGED

15.1.3.12 VA_OBJECT

15.1.3.13 VA_PATH_UPDATE

15.1.3.14 VA_PROGSTART

15.1.3.15 VA_PROTOSTATUS

15.1.3.16 VA_SERVER_QUOTING(a)

Dies ist ein Test des Protokollstatus auf Quoting. In C läßt sich der Test als Makro wie folgt realisieren:

#define VA_SERVER_QUOTING(a)  ((a) & 0x40)

15.1.3.17 VA_SETSTATUS

15.1.3.18 VA_START

15.1.3.19 VA_THAT_IZIT

15.1.3.20 VA_VIEWED

15.1.3.21 VA_WINDOPEN

15.1.3.22 VA_XOPEN