Der FileRequest Standard von Oliver Wagner ANUBIS Implementation von Thomas Globisch und Oliver Graf Dokumentation für die User 0. Einführung ¯¯¯¯¯¯¯¯¯¯¯¯¯ Der FileRequest Standard bietet für den User eine einfache Möglichkeit, Files aus der Box zu saugen. Dabei braucht sich der User nicht durch die Bretter der Box zu wühlen, sondern kann direkt alle benötigten Files bestel- len, die dann über den ZModem Batch Download gesendet werden. Diese Dokumentation sollte von allen Sysops, die die FileRequest Möglichkeit in ihrer Box anbieten wollen, den Usern zugänglich gemacht werden. 1. Login ¯¯¯¯¯¯¯¯ Der Login geschieht nach dem Verbindungsaufbau über das Schlüsselwort FILEREQ. ANUBIS erkennt ab der Version 0.433 dieses Schlüsselwort und führt den Benutzer nicht in die normale Kommandoebene, sondern verlangt nach einer ID. Diese ID sollte im Normalfall aus der Netzwerkadresse des Benutzers bestehen. Sie wird allerdings nicht geprüft, sondern nur für das LogFile benötigt. Eine Auswertung der Daten findet nicht statt. 2. Files bestellen ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Nach dem Login über FILEREQ und der ID bekommt der User die Meldung "+ login correct" und ein Prompt "? ". Jetzt kann er damit beginnen, die Files, die er übertragen haben will, dem FileRequest Modul bekannt- zugeben. Dies geschieht entweder über den Programmnamen (z.B. "Anubis.LHA") oder dem Programmnamen mit dem davorgesetzen Brettnamen der Box (z.B. "PD TOM/Anubis.LHA"). Die zweite Möglichkeit sollte auf jeden Fall gewählt werden, wenn mehrere Programme mit dem gleichen Namen in der Box lagern (z.B. "Fish/FF xxx/Term.LHA" und "PD-Amiga/DFUE/Term.LHA"), aber eins der beiden Files neuer oder kürzer ist. Reserviert ist hier das Schlüsselwort FILELIST (siehe dazu Kapitel 4). Sollte ein File nicht gefunden werden können oder das entsprechende Brett nicht für den FileRequest freigegeben sein, sendet ANUBIS die Fehlermeldung "- error 'file not found'", ansonsten ein "+ ok xxx Bytes". Abgeschlossen wird die Eingabe durch das senden eines einzelnen CRs nach dem Prompt. Danach beginnt sofort die Übertragung der Files. 3. Fileübertragung ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Die Übertragung der Files geschieht grundsätzlich mit ZModem Batch. Dies läßt sich auch nicht ändern. Unmittelbar nach dem Abschluß der Fileauswahl durch CR beginnt ANUBIS nun, die angeforderten Files zu übertragen. Sollte dabei der TimeOut (vom Sysop gesetzt, wird beim Login ausgegeben) über- schritten werden, wird nach der Übertragung eines Files abgebrochen. Nach dem Senden aller Files wird die Verbindung automatisch gelöst. 4. Die Fileliste ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Zur besseren Orientierung für User, die die Box nicht genau kennen, ist es möglich, eine Liste aller für den FileRequest verfügbaren Files zu bekommen. Dies geschieht über das Schlüsselwort "FILELIST". Dies veranlaßt ANUBIS dazu, die Liste der Files unter dem Namen zu senden (z.B. "TOM.FRL"). Diese Liste ist nach einem bestimmten Muster standarisiert, so daß eine automatische Auswertung relativ einfach ist. Nach der Übertragung der Liste befindet sich der User wieder in der Eingabe Ebene. 5. Beispiel-Fileliste ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ Die Fileliste hat folgendes Aussehen (Beispiel entspricht einer stark ge- kürzten Liste der TOM) : ; T.O.M. Software Mailbox - ANUBIS FileRequest-Liste ; ; FileListe Stand : 29-03-92 #FISH/FF 571 AutoCLI.lzh 32625 04-01-92 CPUSet.lzh 5762 04-01-92 Gwin.lzh 207786 04-01-92 MemClear.lzh 6835 04-01-92 SysInfo.lzh 41883 04-01-92 ... #PD TOM GRAFIK_MACHINE.LZH 25425 10-07-90 Bildermanipulation, IFF-Umwandler ONLINE125.LZH 9659 09-04-91 Routinen zum Schreiben von OnlinePrg CLIKK!.LZH 66274 09-09-91 Disk-Utility, Version 2.03d, Sharewar Rev.lha 7232 26-10-91 Revisionsheader (Kick2.0 only) AXPr2_1.lzh 16234 07-12-91 neue, stark verbesserte Version UMMA2_00.run 32915 30-12-91 CD/LP/MC-Archiver V2.00 ShareWare ArcL.LHA 9552 22-01-92 Archivfilelister, Version 1.2 Anubis0430.LZH 226891 28-01-92 Mailbox-Programm, Version 0.430 FilePrint.LHA 8061 30-01-92 Neue Version AppIcon und Commodty ScreenSnap1_12.LZH 12866 02-02-92 speichert den Inhalt bel. Screens (2.0) #PD-AMIGA/ANTIVIRUS VIRUSX_4.01.LZH 14007 11-03-91 VirusX v4.01 ANTILINKA.LZH 25343 21-03-91 Check Files im Dir auf Link-Viren !GU JACK.LZH 18405 21-03-91 Sucht und zerstoert im Dir d. JACK-VI VirusChecker.lha 53982 23-12-91 Virus-Checker V3.1 und BrainFilemaker VC_601.lha 42848 02-03-92 Virus_Checker v6.01, AntivirenTool VT238b.lha 156597 15-03-92 VT2.38 Stand 14.03.92 Heiner ViruZ213.lha 41476 17-03-92 Neueste Version von VirusZ BootX441.lha 159972 17-03-92 Neueste Version von BootX ... ; FileRequest Liste Ende ; ; 464 Files mit insgesamt 42385203 Bytes Genauere Informationen für die Beschreibung des Standards können bei uns angefordert werden. 6. Beispielablauf ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ ANUBIS Version 0.432 (C)1991/92; T.O.M. Software Wuppertal T.O.M. Software Mailbox FileReq Node : TOM Username:FILEREQ ANUBIS FileRequest Modul V 1.0 (03.03.92) by Oliver Graf & Thomas Globisch FileRequest Zeit : 20 Minuten Fileliste mit FILELIST ! Bitte Netzwerk-Adresse als ID senden !ID:OLIVER_GRAF@AWORLD.ZER + login correct ? FILELIST **B000 ? WBSTART.LZH + wbstart.lzh ok 12858 Bytes ? FISH/FF 593/PICTSAVE.LZH - pictsave.lzh error "file not found" ? FISH/FF 593/PICTSAVER.LZH + pictsaver.lzh ok 15547 Bytes ? AFT.LZH + aft.lzh ok 2117 Bytes ? **B000 automatischer Logoff... Modem-Hangup... Wie man sieht, ist die Anforderung und die Übertragung der Files sehr ein- fach. Denkbar wäre auch, ein Script dafür zu schreiben, daß die entspre- chenden Files automatisch anfordert (beispielsweise alle Files ab einem bestimmten Datum.