Dumps en Logbestanden

### WHDLoad's dumps en logbestanden

Hoofdzakelijk voor het doel te debuggen,WHDLoad kan verschillende dump- en logbestanden creëren.

#### Geheugendump

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".

#### Register dump

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.

#### Complete dumpbestand

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.

#### bestand toegangslog

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:

- resload_DeleteFile
- resload_DiskLoad
- resload_Examine
- resload_ExNext
- resload_GetFileSize
- resload_GetFileSizeDec
- resload_ListFiles
- resload_LoadFile
- resload_LoadFileDecrunch
- resload_LoadFileOffset
- resload_SaveFile
- resload_SaveFileOffset

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.