

VPatch (c) 1993-94 VISCOM Datensysteme GmbH, Aachen                   Seite 1
-----------------------------------------------------------------------------

VPatch ist ein Utility, das dazu dient, Software-Updates in Form von kleinen
Differenzdateien zu bermitteln. Die Differenzdateien (Patchfiles) enthalten
lediglich die Unterschiede zwischen der ursprnglichen Version
(welche aktuell im Einsatz ist) und der neuen Version (auf welche
upgedatet werden soll).

Im Gegensatz zu den bekannten Kontextdiffs fr Textdateien unter UNIX
bearbeitet VPatch jegliche Art von Dateien beliebiger Gre.


Gegenber herkmmlichen Software-Updates haben Updates mittels VPatch
zwei entscheidende Vorteile:

1.    Die Patchfiles haben eine geringere Gre als gepackte Originaldateien.
      Sie eignen sich deshalb insbesondere fr die bertragung per Modem.

2.    Ohne die alte lizensierte Version der Software (oder der Daten)
      ist ein solches Patchfile wertlos. Ein Update kann also auch z.B. ber
      ein ffentliches  Mailboxsystem verbreitet werden.


VPatch besteht aus zwei Programmen:

1.      DIFF.EXE zum Erzeugen der Differenzdatei
2.      DECOD.EXE zum Updaten der Software beim Benutzer




Bedienung von DIFF.EXE


Das Programm DIFF.EXE wird von der DOS-Kommandozeile aus aufgerufen.

        DIFF <Steuerdatei>

Die Steuerdatei ist eine Textdatei, die aus beliebig vielen Zeilen mit
jeweils drei vollstndigen Dateinamen besteht.
Die beiden ersten Namen sind die zu vergleichenden Dateien, so wie sie
aktuell vorliegen. Der dritte Eintrag einer jeden Zeile ist der Dateiname
der alten Version, so wie sie beim Benutzer vorliegt.

Die Steuerdatei hat also folgenden Aufbau:

        < A > < B > < C >

        < A >  Pfad u. Name der alten Datei,
        < B >  Pfad u. Name der neuen aktualisierten Datei,
        < C >  Pfad u. Name der alten Datei beim Kunden,


Die Steuerdatei kann beliebig viele solcher Tripel enthalten.



VPatch (c) 1993-94 VISCOM Datensysteme GmbH, Aachen                   Seite 2
-----------------------------------------------------------------------------

Ein Beispiel:

        .\altdaten\test.exe   .\neudaten\test.exe     .\test.exe
        .\altdaten\test.dat   .\neudaten\test.dat     .\test.dat
                .
                .
                .
        .\altdaten\plz.dbf    .\neudaten\plz.dbf      .\daten\plz.dbf


Es besteht ferner die Mglichkeit, Jokerzeichen (*, ?) in der Steuerdatei
zu benutzen, dann lautet der Aufruf:

        DIFF <Steuerdatei> /W

Der dritte Eintrag einer jeden Zeile darf dann nicht angegeben werden und
wird durch den zweiten Eintrag ersetzt.

DIFF.EXE erzeugt whrend der Abarbeitung eine Datei namens VPATCH.DIF.
Diese dient spter dem Programm DECOD.EXE als Input.


Weitere Optionen von DIFF:

    /F    (Fast) Bei hochredundanten Dateien (Textdateien oder Datenbank-
          dateien) kann es vorkommen, da die Erstellung der
          Differenzdatei recht lange dauert. Dann bewirkt die Option /F
          eine erhebliche Beschleunigung auf Kosten der Gre der
          Differenzdatei.

    /R    (Reverse) Es wird eine zustzliche Differenzdatei namens
          "VPATCH.REV" erzeugt. Sie ist die Umkehrung von "VPATCH.DIF"
          und dient dazu, die mit der Datei "VPATCH.DIF" gemachten
          nderungen wieder rckgngig zu machen.



Bedienung von DECOD.EXE

Die Bedienung von "DECOD.EXE" ist denkbar einfach.
Auf dem DOS-Prompt wird das Programm durch Eingabe seines Namens aufgerufen.

        DECOD [Dateiname] <ENTER>

Wenn [Dateiname] nicht angegeben ist, mu sich die Datei VPATCH.DIF
im gleichen Unterverzeichnis befinden.

DECOD.EXE sucht die zu patchenden Dateien (das sind die Namen, die in der
Steuerdatei von "DIFF.EXE" an dritter Stelle angegeben sind) und berprft,
ob ihre CRC-Prfsummen mit den gespeicherten Werten bereinstimmen. Ist
dies der Fall, wird die jeweilige Datei durch ihre neue Version ersetzt.
Im anderen Fall gibt das Programm eine Warnung aus und die Datei
bleibt unangetastet.

