WHDLoad's dumps en logbestanden
Hoofdzakelijk voor het doel te debuggen,WHDLoad kan verschillende
dump- en logbestanden creëren.
Een geheugendump is het gehele geheugen gebruikt bij het geïnstalleerde
programma geschreven naar een bestand. De grootte van de dump hangt af
van het geïnstalleerde programma (het is gelijk aan de waarde van
ws_BaseMemSize in de Slave structuur).
Een geheugendump wordt gemaakt als de DebugKey ingedrukt is
of na een error de CoreDump knop wordt ingedrukt. De naam van het geheugen dumpbestand
dat gemaakt word is ".whdl_memory".De standaard locatie is "PROGDIR:" maar kan veranderd worden met de
CoreDumpPath optie. Een bestaand bestand met dezelfde naam
zal altijd overschreven worden. Als het geïnstalleerde programma aangevulde Fast(Snel)-Geheugen gebruikt, wordt
het geschreven onder het bestandsnaam ".whdl_expmem".
De register dump bevat de complete status van het CPU (inclusief MMU), de Cia,
en de Custom chips. Sommige Cia en Custom registers zijn niet leesbaar,
deze zijn alleen aanwezig in het dumpbestand wanneer de Snoop mode actief was. De informatie wordt
geschreven naar een ASCII bestand met een paar benadrukkingen, gebruikmakend
van Escape sequences (using CSI - Control Sequence Introducer, decimal 155).
Om ze te bekijken, is een programma aanbevolen welke de Escape sequences ondersteund
(o.a More, MuchMore, MultiView,...). De naam van het dumpbestand is ".whdl_register",
De standaard locatie is "PROGDIR:" maar kan veranderd worden met de
CoreDumpPath optie. Wanneer een bestand met dezelfde naam al bestaat,
zal de dump zich toevoegen aan de bestaande - anders zal er een nieuw bestand
aangemaakt worden.
De Complete dumpbestand is een
IFF bestand dat de informatie bevat van alle vorige genoteerde dumpbestanden.
Het is bedoeld om gebruikt te worden met andere applicaties. De structuur
van het bestand is beschreven in een extra inbegrepen bestand met de naam whddump.i.
Op dit moment kunnen de applicaties WHDLoadGCI (graphical coders interface) en SP (save picture) het complete dumpbestand lezen.
De naam van het complete dumpbestand dat gemaakt word is ".whdl_dump".
De standaard locatie is "PROGDIR:" maar kan veranderd worden met de CoreDumpPath optie. Een bestaand bestand zal
altijd overschreven worden.
Alle disk toegangen worden bewaard in een log als de FileLog optie geactiveerd is.
Deze eigenschap is erg handig om een disk operaties te analyzeren van een geïnstalleerd
programma om te debuggen en te optimaliseren.
De volgende resload functie zal een notitie aanmaken in het logbestand:
Elk bestandstoegang via de functies die hierboven staan, maakt 1 regel aan in het logbestand,
De regel identificeert de aangeroepen functie, een crc of de lees/schrijven data,
de parameters en het resultaat. WHDLoad zal de log notities verzamelen in een interne buffer.
De buffer zal geleegd worden bij het verlaten of bij toegang tot de buffer vol is.
De informatie word weggeschreven naar een ASCII bestand, de naam van het dumpbestand is
".whdl_filelog", de standaard locatie is "PROGDIR:" maar kan veranderd worden met de
CoreDumpPath optie.