BINREAD - (C) 1995-1998 by DF3VI ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Funktion 2. Interner Ablauf 3. Beschraenkungen beim Auslesen 4. Installation 5. Anwendung 6. Fehlermeldungen 7. User-Dokumentation 1. Funktion ----------- Das Programm BINREAD dient zum gepackten Auslesen von Mailbox-Files. Das gepackte Archiv wird dann mittels BOXBIN ausgesendet. Zum Packen werden derzeit LHArc, RAR, ARJ und PKZIP unterstuetzt. (RAR und ARJ stehen allerdings nur unter DOS zur Verfuegung!) LHArc ist dabei Default-Packer, also sollte man diesen einzigen echten PD-Packer auf jeden Fall haben. Auch ARJ ist zum privaten Gebrauch frei, RAR und PKZIP sind Shareware. 2. Interner Ablauf ------------------ Das Programm kopiert aus Geschwindigkeitsgruenden direkt die Files wie sie auf der Platte liegen, benennt sie dabei aber um in das Format "Rubrik.Nummer". Bei Nummern groesser 999 wird die vorderste Stelle abgeschnitten. Diese Files werden dann mit dem gewuenschten Packer direkt in das BIN_Output-File (wie in RUNDAT.BCM angegeben) gepackt. Anschliessend wird der BIN-Header erzeugt und in das TXT_Output-file geschrieben. Durch die Namensgebung des Archives aus den bis zu ersten fnf Buchstaben des Boards sowie der letzten vier Buchstaben des BIN-Ausgabefiles (ohne Null) wird ein weitgehend eindeutiger Filename erreicht, so dass sich mehrere folgende BINREAD-Ausgaben nicht ueberschreiben koennen, und doch etwas mehr Uebersicht als durch Benutzung des reinen BCM-Filenamens erreicht. 3. Beschraenkungen beim Auslesen --------------------------------- Mengenmaessig sind der Benutzung inzwischen Grenzen gesetzt, da einige Zeitgenossen mit Packen ganzer Rubriken das DOS-Timeout heraufbeschworen. Deshalb ist nun nach zwanzig "Treffern" Schluss (diese Zahl ist diskutierbar). Weitere Einschraenkungen gibt es derart, dass fuer Nicht-Sysops einbuchstabige Info-Rubriken nicht zugaenglich sind, geloeschte Files unsichtbar bleiben, und kein Userfile ausser dem eigenen gepackt werden kann. Fuer den Sysop gelten diese Beschraenkungen nicht. 4. Installation --------------- Zur Installation muss lediglich das Programm BINREAD.EXE (DOS) bzw binread (Linux) irgendwo in einem mit PATH erreichbaren Verzeichnis stehen. Ausserdem sollten die oben genannten Packer zur Verfuegung stehen. Zus„tzlich ist ein Eintrag in RUNUTIL.BCM ohne Optionen n”tig. Ein Konfigurationsfile gibt es wie ueblich nicht... 5. Anwendung ------------ Die Anwendung haelt sich eng an die BCM-uebliche Syntax. Der Packer ist als Option angebbar, und zwar -A fuer ARJ, -R fuer RAR, -Z fuer ZIP. Danach kommen Rubrik (muss immer angegeben werden) sowie eine Bereichsangabe (in der Form 1, 1-, 1-2, aber NICHT -2) und/oder ein Suchbegriff. Eine Kombination von Bereichsangabe und Suchbegriff gleichzeitig ist moeglich! 6. Fehlermeldungen ------------------ Bei unzureichenden Eingaben gibt das Programm eine einzeilige Syntaxbeschreibung aus. Sind die Parameter syntaktisch korrekt, aber es konnten keine Dateien gefunden werden (sei es, dass versucht wurde geloeschte oder nicht vorhandene Dateien zu lesen, oder aber ein Verzeichnis nicht existiert), werden kontextabhaengige Fehlermeldungen ausgegeben. Die Ausgaben der DOS/Linux-Programme werden unterdrueckt. 7. User-Dokumentation --------------------- Folgendes kann lokal in die Mailbox eingespielt werden, um die User darueber zu informieren, wozu BINREAD eigentlich gut ist. Bei einer Linux-BayBox sollten bei den moeglichen Packern ARJ und RAR rauseditiert werden. -------------------------------------------------------------------------- BINREAD ist ein Utility, das GEPACKTE Ausgaben von Mailbox-Files erstellt. Insbesondere Text-Dateien koennen damit erheblich schneller (weil komprimiert) ausgelesen werden. Als Packer stehen (als Default) LHA und (optional) ARJ, RAR sowie (PK)ZIP zur Verfuegung. Die Syntax des Befehls ist: BINREAD [-Packer] <[Bereich] [Begriff]> ! ! ! ! ! ! ! +- Suchbegriff (optional) ! ! ! ! ! +----------- Bereich im Board ! ! ! +---------------------- Name des Boards ! +------------------------------- -A fuer ARJ, -Z fuer ZIP (sonst mit LHA gepackt) Suchbegriff und Bereichsangabe koennen auch verknuepft werden, z.B.: > BINREAD DARC 100-120 DK9HU packt im Board DARC im Bereich der Msg-Nr 100 bis 120 nur die Files ein, die von DK9HU sind (oder DK9HU im Titel haben). Da das Programm bei groesseren Datenmenge recht lange laeuft, wurde die Maximalzahl von Files, die "in einem Rutsch" gepackt werden, auf zehn begrenzt (es hat schon zweimal jemand mit "binread xyz 1-" das System abgeschossen). Die Ausgabe des gepackten Files erfolgt im BOX-BIN-Format. D.h., das eigene Terminal muss faehig sein BIN-Files lesen zu koennen. Der Filename ist eine Kombination aus Board-Namen und einem zeitabhaengigen Code und damit weitgehend einmalig (kein Ueberschreiben vorhergehender BINREAD-Aufrufe durch folgende Archiv-Files). Wichtig: Stellt Eure Terminal-Programme richtig ein! Die Mailbox kann wirklich nichts dafuer, wenn durch falsche Konfiguration der Benutzer-Software das Auslesen mehrerer 7PLUS- oder BIN-Files durch vom Terminal-Programm ausgesendete Status- Meldungen abgebrochen wird! Fuer GP : DB0RWI-8 als Typ "B>" (Mailbox) eintragen Fuer SP6: DB0RWI-8 als Typ "3" (Mailbox) eintragen Stellt man sein Terminal-Programm so ein, werden *keine* Status- Meldungen mehr an die Mailbox gesendet, obwohl sie (zumindest bei GP) auf dem Bildschirm ausgegeben werden. -------------------------------------------------------------------------- vy 73 de Patrick - DF3VI @ DB0RWI.#NRW.DEU.EU