
IMG  Version 1.1d Copyright (c) 1994 by Falk Huth
*** (Internet email: wshao@cluster.urz.uni-halle.de)
*** Dokumentationsdatei.

Gebrauch:  IMG <Kommando> [-<S> [-<S>...]] <Imagename> [<Dateinamen>...]

<Dateinamen>
   <Datei>[ <Datei>[ <Datei>[ ...]]]     bezieht die angegebenen Dateien ein
   @<Datei>[ @<Datei> [...]]             bezieht jede Liste @<Datei> ein

<Kommandos>
  e: Entnimmt Dateien dem Image          t: Testet Korrektheit von Image
  l: Listet Inhalt von Image             v: Ausfhrlicher Inhalt von Image
  p: zeigt Inhalt der Dateien an         x: Entnahme mit Unterverzeichnissen

<Schalter>
  d: Zielverzeichnis aller Images        p: Angabe der Dateien mit Pfadnamen
     z.B.: -dC:\INSTALL\BIG_PRG          q: Abfrage bei jeder Datei
  n: Zielverzeichnis-Name                v: Ermgliche mehrere Images
     z.B.: -nC:\INSTALL\BIG_PRG\DISK1    x: Schliee angegebene Dateien aus
  o: Originaldiskette  z.B.: -oA:        y: Besttigung jeder Abfrage



 Zusammenfassung
~~~~~~~~~~~~~~~~~
Hinweis:  Bei den verwendeten Namen in dieser Dokumentation handelt es sich
          teilweise um eingetragene Warenzeichen der entsprechenden Firmen.

Verschiedene Programme sind in der Lage, die gesamten Informationen einer Dis-
kette (einschlielich Bootsektor, File Allocation Tables usw.) in einer Datei
zu speichern. Diese Dateien knnen dann auf einem alternativen Medium (z.B. MO,
SyQuest oder Streamer-Band) gesichert werden. Bei Bedarf ist es mglich, von
diesen sogenannten Diskettenabzgen (oder disk images) wieder Originaldisketten
zu erstellen.

Oft ist es heutzutage jedoch angenehmer, Programme von einem temporren Ver-
zeichnis der Festplatte aus zu installieren.

Dieses Programm dient nun dazu, Daten aus den Diskettenabzgen direkt auf Fest-
platte zu schreiben, ohne die Originaldisketten erstellen zu mssen.



 Copyright oder so
~~~~~~~~~~~~~~~~~~~

Der Urheber des Programmes IMG ist Falk Huth. Er ist per Internet-email unter
der Adresse wshao@cluster.urz.uni-halle.de zu erreichen.

Die Routinen zum Dekomprimieren von HD-Copy Diskettenabzgen stammen von Oliver
Fromme (Internet email: fromme@rz.tu-clausthal.de). Das Urheberrecht fr diese
Routinen hat er inne, auch wenn er sie freundlicherweise zur Verfgung stellte.

Dieses Programm darf  F R E I  verwendet werden, es wird  K E I N E  Garantie
fr die einwandtfreie Funktionsweise dieses Programmes bernommen.

Das Kopieren und die Weitergabe dieses Programms sind ausdrcklich erwnscht.
Dabei mu die jeweilige Dokumentationsdatei in dem Verzeichnis zu finden sein,
in dem auch das Programm steht.

Der kommerzielle Vertrieb dieses Programmes ist jedoch nur mit ausdrcklicher
Genehmigung des Autors gestattet. Sollte von Ihnen Geld fr dieses Programm
verlangt worden sein, senden Sie doch bitte eine kleine Notiz per Internet-
email, da diese Version  F R E E W A R E  ist.

Es ist erwnscht, da Sie Ihre Meinung zu diesem Programm per Internet-email
an die Adresse wshao@cluster.urz.uni-halle.de bekunden - Danke.



 Entwicklungsphasen von IMG
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Version 0.99      Diese Version wurde in aller Schnelle zusammengebastelt. Sie
                   diente ausschlielich dazu, einen Diskettenabzug von HD-Copy
                   vollstndig zu entpacken. Dazu wurde ein Unterverzeichnis
                   mit dem Namen des Archives (ohne Erweiterung) angelegt.
                   In dieser Version existierten keine Kommandos oder Optionen,
                   einzelne Dateien konnten nicht entpackt werden.
                   Das entspricht der heutigen Version mit dem Aufruf
                        IMG x <Imagename> 

Version 1.0       Diese Version war im Zeitraum von August bis Dezember 1994 in
                   stndigem Gebrauch. Sie war in der Lage, HD-Copy Abzge zu
                   listen, testen und zu entpacken. Dies war auch fr einzelne
                   Dateien aus dem Abzug mglich. Auerdem wurde die Bearbei-
                   tung mehrerer aufeinanderfolgender Abzge untersttzt.
                    Mit einem Schalter konnten auch reine Diskettenabzge gele-
                   sen werden. Dabei war zu beachten, da HD-Copy Abzugsdateien
                   die Extension .IMG und reine Abzge die Extension .DSK haben
                   muten.
                    Diese Version arbeitete mit XMS (falls vorhanden) und ist
                   auf den beiliegenden Beispiel-Abzugsdateien enthalten.

Version 1.02      Diese Versionsnummer wurde vergeben, whrend die Version
                   1.0 berarbeitet wurde. Dies ist keine fertige Version.

Version 1.01       Diese Versionsnummer wurde gewhlt, als die neue Version
                   fertig zu sein schien.
                    Ab dieser Version wurde kein "" mehr angehngt, da die
                   Routinen zum Entpacken von Diskettenabzgen hinreichend
                   lange getestet wurden.
                    Trotzdem wird keine Garantie dafr bernommen, da die
                   Routinen in 100% der Flle exakt arbeiten.

Version 1.1        Dies ist nun die -vorerst- letzte Version des IMG Programms.
                   Die Funktionsweise wird spter erklrt.
                    Neu gegenber der Version 1.01 ist der Schalter -n, die
                   sicherere Methode, Disketten zurckzuschreiben und die lo-
                   gischere Abfragestruktur (Verzeichnis benutzen, Verzeichnis
                   erstellen, Datei berschreiben usw.)

Version 1.1d       Mit dem "d" hinter der Versionsnummer ist nur gemeint, da
                   es sich hierbei um die deutschsprachige Version handelt. Sie
                   unterscheidet sich von der englisch-sprachigen Version 1.1
                   jedoch nur insofern, da die Ausschriften in deutscher
                   Sprache erfolgen und die Abfrage statt [Yes,No,Always,Quit]
                   [Ja,Nein,Alle,Ende] lautet.
                    Die Parameter in beiden  -  der englisch- und der deutsch-
                   sprachigen Version  -  sind gleich.



 Danksagung
~~~~~~~~~~~~

Oliver Fromme                              fromme@rz.tu-clausthal.de (Internet)
Klingestrae 2
D-38640 Goslar                                                      Deutschland

ist der Autor von HD-Copy. Er stellte Routinen zum Dekomprimieren seines Dis-
kettenabzugsformates zur Verfgung.


Thomas Tischer                                  Student TU-Dresden, Deutschland

gilt besonderer Dank hinsichtlich seiner beratenden Funktion bei der Entwick-
lung dieses Programms. Er brachte viele Ideen zur Optimierung der verwendeten
Algorithmen ein. Fr die Vorgngerversion schrieb er die Routinen fr die Ver-
waltung des XMS-Speichers.


Andreas Walther                         Student MLU, Halle (Saale), Deutschland

hat dieses Programm vor allem den Schalter  -dVerzeichnis  zu verdanken.


Rainer Huth                             n1huth@zeus.rz.th-leipzig.de (Internet)

hat dieses Programm vor allem den Schalter  -nVerzeichnis  zu verdanken.



 Untersttzte Diskettenabzugs-Formate
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

reiner Abzug       ist ein Diskettenabzug, bei dem die Diskette Sektor-fr-
                   Sektor unkomprimiert in eine Datei geschrieben wurde.
                    Die Erstellung eines solchen reinen Diskettenabzuges kann
                   durch verschiedenste Programme erfolgen.

HD-Copy            erstellt keine reinen, sondern komprimierte und teilweise
                   sinnvoll verkrzte Diskettenabzge, vor denen ein Kopf ge-
                   schrieben wird. Fr die Dekomprimierung wird zustzlich Zeit
                   bentigt. Deshalb wird keine maximale Komprimierung verwen-
                   det, so da sich die Zeitverluste durch Kompression in Gren-
                   zen halten.

VGA-Copy           versucht die Diskettenabzge anschlieend mit ARJ zu kompri-
                   mieren. IMG untersttzt jedoch nur das unkomprimierte VGA-
                   Copy Format, das einem reinen Diskettenabzug entspricht.
                    Die komprimierten Dateien sollten deshalb  v o r h e r  mit
                   ARJ entpackt werden.

DR-DOS diskcopy    erstellt reine Diskettenabzge, denen jeweils ein Copyright-
                   Hinweis angefgt wird.

Becker Tools       ist das komplizierteste Format von allen, dessen Besonder-
deluxe 2.0         heit ist, da mehrere Disketten hintereinander archiviert
Disk Archiver      werden. Da die Komprimierungsmethode, die DATA BECKER ver-
                   wendet, unbekannt ist, beschrnkt sich IMG auf Disketten-
                   Archive, bei denen alle Abzge unkomprimiert sind.
                    Ihre Mitarbeit in Form von nheren Informationen ber die-
                   ses Datenformat, wenn mglich, wre willkommen. Dadurch
                   knnte eine der nchsten Version von IMG dieses Format voll-
                   stndig untersttzen.

Das IMG Programm testet automatisch, welcher Dateityp vorliegt. Es gibt einen
Fehler zurck, wenn es sich nicht um einen Diskettenabzug handelt oder dieser
in einem nicht bekannten Format vorliegt.






 Einfhrung
~~~~~~~~~~~~

Hier ist sie nun - die Version 1.1d des Programmes IMG. Viele werden von diesem
Programm noch nichts gehrt haben, da die Vorgngerversionen nur in einem sehr
kleinen Kreis verteilt wurden.

Dieses Programm wurde ursprnglich entwickelt, um Dateien aus Diskettenabzgen
von HD-Copy auf Festplatte zu schreiben, ohne die Abzge vorher auf Disketten
zurckzuschreiben.

Die Erstellung dieses Programmes wurde durch die Mithilfe von Oliver Fromme,
dem Autor von HD-Copy, mglich, der den Aufbau seines Dateiformats offenlegte
und die erforderlichen Quelltexte zur Verfgung stellte.

Die Entwicklung dieses Programmes wurde auerdem durch Thomas Tischer vorange-
trieben, indem er die XMS-Verwaltung fr die Vorgngerversion geschrieben hat
und Verbesserungsvorschlge einbrachte. In dieser Version wird allerdings ein
Algorithmus verwendet, bei dem sich die Verwendung einer virtuellen Datei im
XMS-Speicher als berflssig erwiesen hat.

Sollte Sie beim Gebrauch des Programmes IMG Fehler bemerken oder sollten Sie
Vorschlge zur Verbesserung haben, werden Sie gebeten, eine Nachricht per
Internet-email an wshao@cluster.urz.uni-halle.de zu senden. So knnen Ihre Hin-
weise in einer neueren Version bercksichtigt werden.

Sie werden dann im Abschnitt Danksagung erwhnt werden, auf Wunsch knnen Sie
aber auch anonym bleiben.



 Kommandos
~~~~~~~~~~~

  e: Entnimmt Dateien dem Image
          Entnimmt Dateien aus der Diskettenabzugsdatei. Dabei wird die Ver-
         zeichnisstruktur, die auf der ursprnglichen Diskette vorhanden war,
         nicht angelegt, sondern werden alle Daten in  e i n   V e r z e i c h-
         n i s  geschrieben.

  l: Listet Inhalt von Image
          Listet den Inhalt der Diskettenabzugsdatei. Es wird jeweils nur der
         Dateiname und die Dateigre angegeben. Die Unterverzeichnisse werden
         in jeweils einer gesonderten Zeile aufgefhrt. Am Ende erscheint die
         Anzahl der gezeigten Dateien und deren Gesamtgre. Die Gesamtgre
         bezieht sich jedoch nur auf die gezeigten Dateien.

  p: zeigt Inhalt der Dateien an
          Zeigt den Inhalt von Dateien aus dem Diskettenabzug an. Bei diesem
         Kommando sollte man jedoch sinnvollerweise Dateinamen angeben, so da
         nur Textdateien angezeigt werden.

  t: Testet Korrektheit von Image
          Testet die Korrektheit des Diskettenabzuges. Hierbei wird die Disket-
         tenabzugsdatei genauso behandelt wie bei der Entnahme von Dateien nur
         mit dem Unterschied, da keine Daten geschrieben werden.

  v: Ausfhrlicher Inhalt von Image
          Zeigt den Inhalt der Diskettenabzugsdatei ausfhrlich an. Dabei wer-
         den bei den Dateien zustzlich zum Kommando "l" das jeweilige Datum,
         die Uhrzeit und die Dateiattribute angezeigt. Am Ende erscheint neben
         der Anzahl der gezeigten Dateien und deren Gesamtgre auch die Zahl
         der Verzeichnisse und der Grad der Komprimierung.

  x: Entnahme mit Unterverzeichnissen
          Entnimmt Dateien aus der Diskettenabzugsdatei, wobei die Verzeichnis-
         struktur der ursprnglichen Disketten ausgehend vom Zielverzeichnis
         wieder angelegt wird.



 Schalter
~~~~~~~~~~

   d: Zielverzeichnis aller Images   z.B: -dC:\INSTALL\BIG_PRG
           Im Beispiel werden alle Diskettenabzge ausgehend vom Verzeichnis
          C:\INSTALL\BIG_PRG geschrieben.
          Diesen Schalter bentigt man bei etlichen Programmen, die bei der In-
          stallation von Festplatte (die meist bedeutend schneller ist) alle
          Dateien von allen Disketten in ein und dem selben Verzeichnis haben
          mchten.

   n: Zielverzeichnis-Name  z.B.: -nC:\INSTALL\BIG_PRG\DISK1
           Dieser Schalter ermglicht es, ausgehend von einem Zielverzeichnis,
          fr jede Diskette ein extra Verzeichnis anzulegen.
          z.B.:  -nC:\INSTALL\BIG_PRG\DISK1
          In diesem Beispiel schreibt IMG den Inhalt des ersten Diskettenabzu-
          ges in das Verzeichnis C:\INSTALL\BIG_PRG\DISK1, den des zweiten Dis-
          kettenabzuges nach C:\INSTALL\BIG_PRG\DISK2 usw.
          Auch dieser Schalter wird sich bei der Installation mancher Programme
          von Festplatte als Vorteil erweisen.

   o: Originaldiskette  z.B.: -oA:
           Im Beispiel erstellt IMG eine Originaldiskette im Laufwerk A:.
          Dabei sind zwei grundlegende Dinge zu beachten.
           Erstens: Dieser Schalter arbeitet nur in Zusammenhang mit einem Kom-
          mando (z.B. "l": Image listen).
           Zweitens: Bei Differenzen zwischen dem Diskettenformat des Abzugs
          und dem der eingelegten Diskette, wird die Diskette formatiert. Dies
          ist in dieser Version jedoch nur fr Standard-DOS-Formate mglich.
          Bei anderen Formaten wird das Programm mit einer Fehlermeldung abge-
          brochen.
           Es erfolgt  k e i n e   W a r n u n g , wenn auf der Diskette noch
          Daten stehen. Bei Schreibfehlern oder Verify-Fehlern wird das Pro-
          gramm abgebrochen.
           Vor dem Zugriff auf das Diskettenlaufwerk wird gewartet, bis der An-
          wender die <RETURN> Taste bettigt hat.

   p: Angabe der Dateien mit Pfadnamen
           Die Dateinamen sollen mit vollstndigen Pfadnamen berprft werden.
          Das bedeutet, die Dateinamen knnen in der Form \ENGL*\*.EXE angege-
          ben werden, wobei dann nur dir Dateien in den Verzeichnissen \ENGL*
          bearbeitet werden. Die Dateinamen-Angabe mu dann mit  \ , ? oder *
          beginnen (siehe auch Abschnitt Dateinamen).

   q: Abfrage bei jeder Datei.
           Wenn Sie diesen Schalter angegeben haben, haben Sie jede Aktion des
          Programms zu besttigen.
           Der Schalter "y" (Besttigung jeder Abfrage) hebt den Schalter "q"
          auf.

   v: Ermgliche mehrere Images
           Bearbeitet mehrere aufeinanderfolgende Diskettenabzge. Dabei wird
          die Zahl im Dateinamenstamm nach jedem Abzug um 1 erhht. Sollte im
          Stamm des Dateinamens keine Zahl enthalten sein, werden die Buchsta-
          ben "weitergezhlt".
           Falls der Schalter "d" nicht angegeben wurde, wird auch das Zielver-
          zeichnis "um 1 erhht".
           Beispiele: - Serie TEST1.IMG, TEST2.IMG, ..., TEST9.IMG, TEST10.IMG
                      - Serie DSK1A.IMG, DSK2A.IMG, ..., DSK9A.IMG, DSK10A.IMG
                      - Serie PRG_A.IMG, PRG_B.IMG, ...

   x: Schliee angegebene Dateien aus
           Bearbeitet alle Dateien die im Diskettenabzug enthalten sind, auer
          diejenigen, die den angegebenen Dateinamen entsprechen.

   y: Besttigung jeder Abfrage
           Wenn dieser Schalter angegeben wurde, erfolgt keinerlei Abfrage.
          Auch dann nicht, wenn der Schalter "q" gesetzt wurde.
          Der Schalter "y" ist deshalb  s e h r   v o r s i c h t i g  zu ver-
          wenden.



 Imagename
~~~~~~~~~~~

Unter Imagename ist der Name der Diskettenabzugsdatei zu verstehen. Dieser ist
mit Extension anzugeben. Der Verzeichnisname ist so zu whlen, da die Datei
gefunden wird, z.B.:  ..\..\TEST\EGAL.IMG




 Dateinamen
~~~~~~~~~~~~

Diese Angabe ist optional. Wird die Angabe "Dateinamen" weggelassen, werden
automatisch alle Dateien bearbeitet.

Ansonsten knnen die Dateinamen mit Ersatzzeichen (wie unter DOS blich) ange-
geben werden. Bei Angabe von Dateinamen werden nur die entsprechenden Dateien
aus dem Diskettenabzug bearbeitet - oder, wenn der Schalter "x" angegeben
wurde, nicht bearbeitet.

Bei der Verwendung des Schalters "p" (Angabe der Dateien mit Pfadnamen) sind
die Dateinamen mit Pfadnamen (der ursprnglichen Diskette, z.B. \TEST) anzuge-
ben. Die Laufwerksangabe der ursprnglichen Diskette (z.B. A:) ist wegzulassen.
Die Pfadangabe lt sich mit "*\..." umgehen.

Es ist mglich (wie unter DOS), Dateilisten anzugeben. Die Dateinamen der ent-
sprechenden Listen sind mit "@<Dateiname>" anzugeben. In der Listendatei knnen
mehrere Dateien eingetragen sein. Jede Zeile der Textdatei stellt einen Datei-
namen dar.



 Datenstrme
~~~~~~~~~~~~~

Die Datenstrme unter DOS  ("<", ">", "|")  werden auch vom Programm IMG unter-
sttzt.



 Abfragen
~~~~~~~~~~

Die nun folgende Tabelle enthlt die Liste aller Abfragen, die whrend des Pro-
grammablaufes auftreten knnen. Es ist mit "X" angegeben, bei welchen Schaltern
welche Abfragen auftreten knnen. Ist der Schalter "y" gesetzt, verliert der
Schalter "q" automatisch seine Wirkung.

Die Beantwortung einer Abfrage mit "A" bzw. "Alle" hat zur Folge, da alle Ab-
fragen  g l e i c h e r   A r t  von diesem Zeitpunkt an nicht mehr stattfin-
den. Dies ist demzufolge nicht mit dem Schalter "y" gleichzusetzen.


Die aufgefhrten Abfragen sind die der deutsch-sprachigen Version:

   Abfrage                        kein Schalter  Schalter "q"  Schalter "y"

Verzeichnis . existiert bereits.                              
Verwenden?  [Ja,Nein,Alle] :            X              X      

Verzeichnis . existiert nicht.                                
Erstellen?  [Ja,Nein,Alle]                             X      

. entnehmen? [Ja,Nein,Alle,Ende]                       X      

Datei . existiert bereits. ber-                              
schreiben? [Ja,Nein,Alle,Ende]          X              X      
                                                              

Ist der Name eines zu erstellenden Verzeichnisses gleich mit dem Namen einer
vorhandenen Datei oder wird die Abfrage nach der Benutzung eines schon vorhande-
nen Verzeichnisses mit "Nein" geantwortet, wird nach einem alternativen Ver-
zeichnisnamen gefragt. Drckt man bei dieser Abfrage nur die <RETURN> Taste,
wird das Programm beendet.

Wird bei der Abfrage nach dem berschreiben einer existierenden Datei mit
"Nein" geantwortet, wird nach einem anderen Dateinamen gefragt. Wird hier nur
die <RETURN> Taste bettigt, wird die entsprechende Datei bersprungen.

Bei den letzten beiden in der Tabelle aufgefhrten Abfragen ist es mglich, mit
"E" bzw. "Ende" zu antworten. Dadurch wird das Programm beendet.



 Exitcodes des Programms IMG
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Der Exitcode des Programms ist bei fehlerfreier Ausfhrung 0. Ansonsten ent-
spricht er meist dem DOS-Laufzeitfehler (z.B.:  3 = Pfad nicht gefunden).

Auerdem gibt es noch zustzliche Exitcodes:

65500      -       Programm beendet   (durch den Anwender)
65534      -       Ungltige  File Allocation Tables
65535      -       Ungltiges Diskettenabzugs-Format



 Beispiele
~~~~~~~~~~~

img v test.img                         zeigt den ausfhrlichen Inhalt des Ab-
                                       zugs test.img an, wobei alle Dateien be-
                                       arbeitet werden

img t ..\programs\test.img             testet die Korrektheit aller Dateien des
                                       Abzuges test.img im Verzeichnis
                                       ..\programs

img p test.img *.txt                   zeigt alle Dateien *.txt, die im Abzug
                                       test.img enthalten sind, an

img l -oA: test.img                    zeigt den Inhalt des Abzuges test.img an
                                       und erstellt eine Originaldiskette im
                                       Laufwerk A:

img e -d. -p -q test.img \german\*.*   entpackt Dateien des Abzugs test.img,
                                       die bei der Originaldiskette im Pfad
                                       \german gestanden haben, in das aktuelle
                                       Verzeichnis (.), wobei das Verzeichnis
                                       .\german nicht angelegt wird und bei
                                       jeder Datei eine Abfrage erfolgt.

img x -ndisk1 -v -x -y test1.img *.bak entpackt alle Dateien der Abzge mit den
                                       Namen test1.img, test2.img, ..., auer
                                       die Dateien *.bak, wobei die Zielver-
                                       zeichnisse .\disk1, .\disk2, ... lauten,
                                       die Originalverzeichnisstruktur wieder
                                       angelegt wird und keine Abfrage erfolgt


Ende.
