FAT-MAP v1.2
------------

FAT-MAP ist ein Utility zur ausfhrlichen Darstellung und Analyse der Bele-
gung von Festplatten und Disketten. Es sollte auf allen ST(E), TT, Falcon
u.. in allen Auflsungen ab ST-Mid, mit allen TOS-Versionen einschlielich
TOS 1.0, MagiC und MultiTOS und mit allen Festplatten laufen, da es ordent-
lich in GEM eingebunden ist und keine speziellen Eigenschaften voraussetzt.
Die zu betrachtenden Datentrgern mssen allerdings ein TOS-kompatibles Da-
teisystem aufweisen.

Es sei gleich zu Beginn darauf hingewiesen, da FAT-MAP zwar sehr gut geeig-
net ist, logische Fehler auf Datentrgern darzustellen und zu analysieren,
selbst aber keinerlei Hilfsmittel zur Reparatur derselben bietet. Dasselbe
gilt entsprechend fr die Fragmentierung auf den Datentrgern. Die Ursache
dafr ist schlicht das Vorhandensein frei verfgbarer Tools zu diesem Zweck.
Evtl. notwendige Reparaturen sollten mindestens mit dem Programm CHKDISK3
von Atari zu bewerkstelligen sein, das ntige Grundwissen und die Kenntnis
der genauen Fehlerursache vorausgesetzt.


Copyright
---------

FAT-MAP ist Freeware. Es darf beliebig kopiert und benutzt werden, solange
alle Dateien unverndert weitergegeben werden und damit keine kommerziellen
Interessen verbunden sind. Aus gegebenem Anla weise ich darauf hin, da es
damit auch nicht im PD-Versand oder auf Cover-Disks verbreitet werden darf.
Jegliche Haftung fr Schden, welcher Art auch immer, ist ausgeschlossen.


Bedienungsanleitung
-------------------

Diese Anleitung folgt der Einfachheit halber den vorhandenen Menpunkten.
Besonderheiten und Hinweise sind jeweils bei den am nchsten verwandten
Menpunkten untergebracht.


Laufwerk ffnen (Ctrl-O), Statusfenster, Meldungsfenster
--------------------------------------------------------

ber diese Anwahl wird ein Laufwerk ausgewhlt und das Lesen und Auswerten
der Belegungstabelle gestartet.

Wenn das Programm CHK_OFLS von Hans-Jrgen Richstein installiert ist, wird
die Bearbeitung bei gesperrtem Laufwerk abgelehnt. Falls noch Dateien auf
dem Laufwerk geffnet sind, wird eine Warnung ausgegeben.

Bereits geffnete Textfenster bleiben zu Vergleichszwecken erhalten, ein
evtl. vorhandenes grafisches Darstellungsfenster wird gelscht.

Nach dem Auswerten der Belegungstabelle wird ein Statusfenster mit einer
bersicht ber die Belegung und Fragmentierung geffnet, im einzelnen:

- Anzahl der Cluster insgesamt
- Gre des Datenbereichs in MB
- Ungltige Eintrge in der FAT
- Gesperrte (defekte) Cluster
- Belegte Cluster
- Freie Cluster

- Anzahl der Belegungslcken
- Freie Cluster in Belegungslcken
- Freie Cluster am Plattenende

- Anzahl der Ketten (Dateien und Ordner)
- Anzahl der fragmentierten Ketten
- Sprungverkettungen (=> Fragmentierung)

An dieser Stelle noch zwei Hinweise:

Bei logischen Fehlern auf dem Datentrger (z.B. Cluster mehrfach belegt)
knnen einige der Status-Angaben fehlerhaft sein (z.B. Anzahl der Ketten).
In diesen Fllen ist das aber prinzipbedingt nicht zu vermeiden.

Desweiteren kann die Anzahl der Dateien und Ordner auch bei logisch intakter
Platte von der Anzahl der Ketten abweichen, wenn Dateien mit einer Lnge von
0 Bytes existieren. Im Verzeichnis existieren sie, in der FAT jedoch nicht.

Falls sich an dieser Stelle jemand fragt, was wohl ein Cluster ist: Das ist
die logische Zuordnungseinheit auf Disketten/Festplatten fr den eigentli-
chen Datenbereich und damit die kleinste Einheit, die auf einem Laufwerk fr
Dateien oder Ordner alloziert werden kann. Meist sind das 1, 2, 4, 8 oder 16
Sektoren, wobei ein Sektor die kleinste Einheit ist, die auf den Laufwerken
angesprochen werden kann. Der erste Cluster hat immer die Nummer 2.

Werden beim Lesen logische Fehler festgestellt, werden diese im Klartext in
einem separaten Meldungsfenster angezeigt. Mgliche Fehler sind hier:

- Mehrfach belegte Cluster (sofern aus der FAT ersichtlich)
- Ungltige FAT-Eintrge
- Referenzen auf freie oder gesperrte Cluster


Verzeichnisse lesen (Ctrl-V)
----------------------------

ber diesen Menpunkt knnen smtliche Verzeichnisse des Datentrgers einge-
lesen werden. Fr einige Funktionen ist dies Voraussetzung (s.u.).


Fenster kopieren (Ctrl-C)
-------------------------

Das oberste Textfenster wird ins GEM-Clipboard kopiert, soda der Inhalt in
einem anderen Programm weiterverarbeitet werden kann. Wird zustzlich eine
Shift-Taste gedrckt gehalten, wird der Fensterinhalt an den bestehenden
Clipboard-Inhalt angehngt.

Ist das Clipboard-Laufwerk mit dem aktuell in FAT-MAP dargestellten Laufwerk
identisch, so wird eine Warnung ausgegeben. Fr flssiges Arbeiten erscheint
diese Warnung nach einmaliger Besttigung mit 'Ok' nicht mehr.


Lcken fllen (Alt-F)
---------------------

Das GEMDOS hat die Eigenschaft, neue Dateien immer im ersten freien Cluster
der Platte anzulegen bzw. zu beginnen. Mit diesem Menpunkt kann man sich
dies zunutze machen, um Belegungslcken gezielt zu fllen. Man kann z.B.
mehrere kleine Lcken am Plattenanfang fllen und damit eine grere Lcke
zur ersten machen, um dort eine groe Datei oder ein ganzes neues Programm-
paket ohne Fragmentierung an einem Stck speichern zu knnen.

Dazu wird im Wurzelverzeichnis des Laufwerks die Datei _FATMAP_.$$$ angelegt
bzw. verlngert, falls sie bereits existiert. In der erscheinenden Dialogbox
wird die bereits von der Flldatei belegte Clusteranzahl angezeigt. Eine 0
zeigt an, da noch keine Flldatei existiert. Darunter wird die neu zu fl-
lende Clusteranzahl eingegeben. Falls im Lckenfenster eine Zeile selektiert
ist, wird dieses Feld so vorbesetzt, da alle Lcken bis einschlielich der
selektierten gefllt werden.

Beim Verlngern einer existierenden Flldatei ist folgendes zu beachten: Die
Datei wird vom bisherigen Ende beginnend in Richtung Plattenende gefllt,
soda eine davorliegende Lcke in diesem Fall NICHT gefllt wird. Im Zwei-
felsfall sollte also vorher mit dem Button 'Lschen' die Flldatei gelscht
werden und die Gesamtanzahl der dann ntigen Cluster neu gefllt werden.

Nach dem Dateizugriff (Fllen oder Lschen) werden grundstzlich alle Fenster
aktualisiert.


Einstellungen speichern (Alt-S)
-------------------------------

Die aktuellen Einstellungen werden in der ASCII-Datei FATMAP.INF im aktuel-
len Verzeichnis gespeichert. Diese Datei wird beim Programmstart automatisch
wieder eingelesen. Abgespeichert werden dabei:

- die Positionen aller Fenster
- die Hhen der Lcken-, Dateien- und Darstellungsfenster
- die Zeichenstze aller Textfenster
- die drei Darstellungsoptionen fr Dateienfenster
  (hier werden die zuletzt benutzten Einstellungen gespeichert)

Die von der Programmversion 1.0 zu diesem Zweck erzeugte Datei FATMAP.CFG
wird nicht mehr untersttzt (auch nicht gelesen). Sie kann gelscht werden.

Ist das Laufwerk, auf dem die Datei erzeugt wird, mit dem aktuell in FAT-MAP
dargestellten Laufwerk identisch, so wird eine Warnung ausgegeben.


Beenden (Ctrl-Q)
----------------

Das Programm wird ohne Rckfrage verlassen.


Status (Ctrl-S)
---------------

Falls das aktuelle Statusfenster einmal (z.B. aus Platzgrnden) geschlossen
wurde, kann es hiermit wieder geffnet werden.


Fehlermeldungen (Ctrl-E)
------------------------

Das Fenster fr Fehlermeldungen wird (wie das Statusfenster) automatisch ge-
ffnet - allerdings nur, wenn auch Fehler gefunden wurden. Wurde es zwischen-
zeitlich geschlossen, kann es hiermit wieder geffnet werden.


Belegungslcken (Ctrl-L)
------------------------

In einem Textfenster werden die Position und die Gre smtlicher Belegungs-
lcken sowie jeweils die aufgelaufene Summe der Lckengren angezeigt. Ein-
zelne Lcken knnen selektiert werden - einfach nur zur bersicht, oder um
die letzte Lcke fr das automatische Fllen zu markieren.

Ein Doppelklick auf eine Zeile im Lckenfenster setzt den aktuellen Cluster
in der grafischen FAT-Darstellung (s.u.) auf den Anfang der Lcke, d.h. das
Fenster scrollt so, da der Anfang der Lcke mglichst in der Mitte liegt.
Falls das Darstellungsfenster noch nicht offen war, wird es zuvor geffnet.


FAT-Darstellung (Ctrl-D)
------------------------

Die komplette Belegungstabelle wird mit je einem Symbol pro Cluster darge-
stellt. Dazu werden 12 verschiedene Symbole verwendet, die sowohl Ziel als
auch Herkunft des Clusters innerhalb einer Kette darstellen.

Mgliche Ziele sind: Dateiende, Folgecluster, sonstiger Cluster.
Mgliche Herkunft ist: Dateianfang, Vorgngercluster, sonstiger Cluster.
Spezialsymbole sind: Freier Cluster, gesperrter Cluster, ungltiger Eintrag.

In der Titelzeile des Fensters wird stndig der aktuell sichtbare Cluster-
bereich angezeigt. In der darunterliegenden Infozeile stehen Informationen
ber den aktuell selektierten Cluster.

Durch Anklicken eines Symbols wird der aktuelle Cluster gewhlt. Am Anfang
der Infozeile wird immer die aktuelle Clusternummer angezeigt. Fr den Rest
der Zeile gibt es zwei Varianten. Ein einfacher Klick liefert:

- die Lnge der betroffenen Kette (Kette steht hier wieder fr Dateien und
  Ordner, aber auch fr Reihen von Spezialsymbolen wie z.B. freie Cluster)
- den Clusterbereich, in dem alle Cluster der Kette liegen
  (mit '-' dazwischen, falls ununterbrochen, sonst mit '~')
- die Anzahl der Fragmente der Kette
- den Quellcluster (nur bei Herkunft aus Sprungverkettung)
- den Zielcluster (nur bei Ziel ber Sprungverkettung)

Bei einem Doppelklick auf ein Clustersymbol (ersatzweise tut's auch ein Ein-
fachklick mit zustzlich gedrckter Shift-Taste) wird der komplette Pfad in
der Infozeile angezeigt, sofern es sich um eine Datei oder einen Ordner han-
delt. Falls beim ersten Versuch die Verzeichnisse des Laufwerks noch nicht
eingelesen waren, wird gefragt, ob dies jetzt gemacht werden soll.

Eine weitere Klick-Variante bietet die Control-Taste. Dabei wird nicht der
angeklickte Cluster selbst selektiert, sondern der in der Kette davorliegende
(zusammen mit Shift) oder dahinterliegende (ohne Shift). Man kann also mit
dem Fensterausschnitt der Verkettung folgen.


Dateien und Ordner (Ctrl-F)
---------------------------

Im der erscheinenden Dialogbox knnen diverse Selektionskriterien und einige
Darstellungsoptionen fr eine Liste der Dateien und Ordner des Datentrgers
eingegeben werden. Die Selektionskriterien im einzelnen:

- Cluster-Nummern von/bis
  (nur Ketten, die vollstndig im angegebenen Bereich liegen)
- Gre in Clustern von/bis
- Popup-Auswahl: Alle Ketten / nur Dateien / nur Ordner
- nur fragmentierte Ketten
- nur Ketten mit Lckenkontakt
- Beginn des Pfads (keine Wildcards!)

Der kleine Reset-Knopf in der Box setzt smtliche Selektionskriterien wieder
auf 'alle' zurck.

Die Optionen fr die Listendarstellung:

- Auswahl der Sortierung ber ein Popup
  * Position
    (kleinste belegte Clusternummer)
  * Gre
    (Clusteranzahl; Datei vor Ordner; Lnge bzw. Ordnereintrge; -> Pfad)
  * Fragmente
    (Anzahl der Fragmente; -> Position)
  * Pfad
    (Pfad mit Dateiname)
  * Name
    (Dateiname ohne Pfad; -> Pfad)
  * Dateityp
    (Dateierweiterung; Datei vor Ordner; -> Name)
  * Datum
    (Datum; Zeit; -> Position [rckwrts])
- Lckenkontakt markieren
  (Ketten, deren Cluster irgendwo an eine Lcke grenzen, fett darstellen)
- Datum und Zeit ausgeben

Mit 'Ok' oder 'Neu' wird das Erzeugen der Liste gestartet. Im Fall von 'Ok'
wird die Liste in ein evtl. bereits vorhandenes Fenster ausgegeben, bei 'Neu'
wird die bisherige Liste in ein reines Informationsfenster gewandelt und die
neue Liste in einem neuen Fenster geffnet. Falls erforderlich, werden die
Verzeichnisse automatisch eingelesen.

Im Fenstertitel wird die Anzahl der gefundenen Dateien und Ordner angezeigt,
im Fenster selbst finden sich die folgenden Informationen je Zeile:

- kleinste und grte belegte Clusternummer (in der Regel ist die kleinste
  Nummer mit dem Startcluster der Datei identisch)
- Anzahl der belegten Cluster
- Dateilnge in Bytes bzw. bei Ordnern die aktuelle Anzahl der Eintrge
- Anzahl der Fragmente
- Datum und Zeit (sofern die Option eingeschaltet ist)
- Kennzeichnung Datei/Ordner
- Pfad und Name

Am Ende der Liste wird eine Summenzeile angefgt. Sie enthlt die kleinste
und grte belegte Clusternummer aller gefundenen Ketten, die Gesamtanzahl
der belegten Cluster sowie die Gesamtlnge aller Dateien in Bytes.

Einzelne Zeilen dieses Fensters knnen selektiert werden. Ein Doppelklick
auf eine Zeile setzt den aktuellen Cluster in der grafischen FAT-Darstellung
auf den niedrigsten belegten Cluster der selektierten Kette. Falls das Dar-
stellungsfenster noch nicht offen war, wird es zuvor geffnet.


Alles aktualisieren (Alt-R)
---------------------------

Smtliche Daten in allen 'aktuellen' Fenstern werden neu gelesen und auf den
aktuellen Stand gebracht. Die Verzeichnisse werden jedoch nur dann gelesen,
wenn auch eine Dateiliste existiert.

Dies ist besonders in Multitasking-Umgebungen sinnvoll, wenn zwischenzeitlich
mit einer anderen Applikation oder dem Desktop nderungen auf dem aktuellen
Laufwerk vorgenommen wurden.

Von jedem Fenstertyp ist jeweils maximal eines 'aktuell', d.h. es enthlt
die Daten zum letzten gewhlten Laufwerk oder die letzte gewhlte Dateiliste.
Den Titelzeilen der aktuellen Fenster ist jeweils ein kleiner Pfeil vorange-
stellt. Alle anderen Fenster enthalten nur noch Informationen zum Nachsehen
oder zu Vergleichszwecken. Es knnen keine Sonderfunktionen mit diesen Fen-
stern mehr ausgelst werden und sie werden auch mit dem Menpunkt 'Alles ak-
tualisieren' nicht mehr auf den aktuellen Stand gebracht.


Zeichensatz (Alt-Z)
-------------------

Zeichensatz, Schriftgre und Zeilenzwischenraum fr das obenliegende Text-
fenster einstellen.


Fenster wechseln (Ctrl-W)
-------------------------

Das nchste Fenster nach oben bringen.


Fenster schlieen (Ctrl-U), alle Fenster schlieen (Alt-U)
----------------------------------------------------------

Das obenliegende Fenster bzw. smtliche Fenster schlieen. Erstere Funktion
kann auch mit der Taste 'Undo' erreicht werden.


Volle Gre (Alt-A)
-------------------

Das obenliegende Fenster wird auf die volle Bildschirmgre bzw. wieder zu-
rck auf seine ursprngliche Gre gebracht.


Bugreports
----------

Fehlermeldungen, Verbesserungsvorschlge und sonstige Kommentare bitte an:

   MausNet:   Jens Brggemann @ H
   Internet:  Jens_Brueggemann@maush.han.de
              oder Jens_Brueggemann@h.maus.de
   SnailMail: Jens Brggemann
              Reuterdamm 122
              D-30853 Langenhagen


History
-------

v1.2 vom 02.11.94: FATMAP.PRG (48869), FATMAP.TXT (18510).

   - Ein sehr peinlicher Bugfix war ntig. Eine Funktion, die schon in der
     v1.0 unverndert enthalten war, rechnete bei Partitionen mit mehr als
     16k Clustern mit einem falschen Vorzeichen.

v1.1 vom 31.10.94: FATMAP.PRG (48867), FATMAP.TXT (18244).

   ALLGEMEINES
   - Konfiguration in ASCII-Datei FATMAP.INF statt binr in FATMAP.CFG.
   - Beim Speichern der Voreinstellungen Warnung VOR dem Speichern, falls
     das aktuell dargestellte Laufwerk beschrieben wird.
   - Beim Lesen der Verzeichnisse wird das Laufwerk mit angezeigt.
   - Deutlich hhere Geschwindigkeit beim Lesen der Verzeichnisse.
   - Gelinkt mit den aktuellen Libraries, u.a. nun Smart-Redraw-fest,
     kein Nachlaufen mehr beim Scrollen, Fenster hintergrundbedienbar.
     Insgesamt nun noch besser gerstet fr Multitasking, obwohl es
     auch schon vorher problemlos damit lief.
   OBERFLCHE
   - Men vllig umstrukturiert.
   - Neu: 'Alle schlieen' und 'Volle Gre'.
   - Auch 'Undo' schliet das oberste Fenster.
   - Option 'Lckenkontakt markieren' in die Dateilisten-Box verlagert.
   - Die Fensterkonfiguration ist nun immer up to date.
   - Keine Untersttzung mehr fr ST-Low. FAT-MAP luft jetzt ab ST-Mid.
   - Alle Buttons 1 Pixel hher (fr Let 'em fly).
   - Kleiner Pfeil in der Titelzeile des aktuellen Fensters jedes Typs.
   - In den Dialogen und Meldungen wird der Programmname angegeben.
   LAUFWERK FFNEN
   - Buttons umbenannt (fr Tastaturbedienung per Let 'em fly).
   - Wiederholtes Lesen eines inzwischen nicht mehr vorhandenen Laufwerks
     (z.B. RAM-Disk) wird unterbunden, auch beim Lesen der Verzeichnisse.
   - CHK_OFLS von Hans-Jrgen Richstein wird genutzt, falls installiert.
   - Mehrfach benutzte Cluster => Fehler.
   - Ungltige FAT-Eintrge => Fehler.
   - Referenzen auf freie oder gesperrte Cluster => Fehler.
   - Neues Fenster fr Fehlermeldungen.
   STATUSFENSTER
   - Angabe der Anzahl der fragmentierten Ketten.
   - Die einigermaen redundante Angabe der Folgeverkettungen ist entfallen.
   LCKENFENSTER
   - Je Zeile zustzlich die aufgelaufene Summe der Lckengren.
   - Einzelne Zeilen im Lckenfenster knnen selektiert werden.
   - Ein Doppelklick auf eine Zeile setzt den Focus der FAT-Darstellung.
   FAT-DARSTELLUNG
   - Markieren des aktuellen Clusters; verbunden mit der Infozeile.
   - Bedienungslogik bei Klicks gendert, nur noch 2 Infozeilenarten.
   - Ausgabe- und Redrawgeschwindigkeit stark erhht (Faktor 2 bis 4).
   - Aktuell sichtbarer Cluster-Bereich steht stndig in der berschrift.
   - Navigieren entlang der Verkettungen durch die Control-Taste.
   DATEIENLISTE
   - Die Listenberschrift gehrt nun zum Fensterinhalt.
   - Sofortiger Abbruch der Liste bei Speichermangel.
   - Ausgabe der Kettenanzahl in der berschrift des Dateienfensters.
   - Umfangreicher Selektions- und Auswahldialog.
   - Neue Sortiermodi 'Dateityp' und 'Datum'.
   - Datum und Zeit optional in der Liste; optimierte Ausgabefunktionen.
   - Ersetzen der aktuellen Liste oder Liste in neuem Fenster.
   - Summen unter den Dateilisten.
   - Einzelne Zeilen im Dateienfenster knnen selektiert werden.
   - Ein Doppelklick auf eine Zeile setzt den Focus der FAT-Darstellung.
   SONSTIGE NEUE FUNKTIONEN
   - Textfenster auf's Clipboard kopieren, optional anhngen.
   - Menpunkt 'Alles aktualisieren'.
   - Menpunkt 'Lcken fllen'.

v1.0 vom 25.08.93: FATMAP.PRG (30848), FATMAP.TXT (6138).

