Dumppaus

### WHDLoadin dumpit ja lokitiedostot

Lähinnä vianetsintätarkoituksiin WHDLoad voi luoda useita dumppi- ja lokitiedostoja.

#### Muistidumppi

Muistidumppi on koko asennetun ohjelman käyttämä muisti kirjoitettuna tiedostoon. Dumpin koko riippuu asennetusta ohjelmasta (se vastaa Slave-rakenteen ws_BaseMemSize-arvoa). Muistidumppi luodaan, jos DebugKeytä painetaan tai CoreDump-painiketta painetaan virheen jälkeen. Luodun muistidumpin tiedostonimi on ".whdl_memory". Oletussijainti on "PROGDIR:" mutta se voidaan muuttaa CoreDumpPath-valinnalla. Olemassa oleva, saman niminen tiedosto ylikirjoitetaan aina. Jos asennettu ohjelma käyttää lisäksi Fast-muistia, se tallennetaan nimelle ".whdl_expmem".

#### Rekisteridumppi

Rekisteridumppi sisältää CPU:n (sekä MMU:n), Cia:n ja erikoispiirien täydellisen tilan. Joitain Cia- ja Custom-rekistereitä ei voi lukea, ja ne ovat mukana dumpissa vain jos Snoop-tila on aktiivinen. Tiedot kirjoitetaan ASCII-tiedostoon korostettuna Escape-jaksoilla (käyttäen CSI - Control Sequence Introducer -merkkiä, desimaali 155). Tarkasteluun suositellaan Escape-jaksoja tukevaa ohjelmaa (esim. More, MuchMore, MultiView jne.). Dumppitiedoston nimi on ".whdl_register", oletussijainti on "PROGDIR:" mutta se voidaan muuttaa CoreDumpPath-valinnalla. Jos saman niminen tiedosto on jo olemassa, dumppi lisätään sen loppuun - muuten luodaan uusi tiedosto.

#### Täydellinen dumppitiedosto

Täydellinen dumppitiedosto on IFF-tiedosto, joka sisältää kaikkien aiempien dumppitiedostojen sisällön. Se on suunniteltu muiden sovellusten käyttöön. Tiedoston rakenne on kuvattu ylimääräisessä include-tiedostossa nimeltä `whddump.i`. Tällä hetkellä täydellistä dumppitiedostoa lukevat sovellukset WHDLoadGCI (graafinen ohjelmoijan käyttöliittymä) ja SP (tallenna kuva). Luodun täydellisen dumppitiedoston nimi on ".whdl_dump". Oletussijainti on "PROGDIR:" mutta se voidaan muuttaa CoreDumpPath-valinnalla. Nykyinen tiedosto ylikirjoitetaan aina.

#### Tiedostohakuloki

Jos FileLog-valinta on käytössä, kaikki levyhaut kirjataan lokiin. Tämä toiminto on hyödyllinen, jos halutaan analysoida asennetun ohjelman levynkäyttöä vianetsintä- ja optimointitarkoituksiin. Seuraava resload-toiminto luo kirjauksen lokitiedostoon:

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

Kukin tiedoston käyttö yllä olevien toimintojen kautta luo yhden rivin lokitiedostoon. Rivillä on kutsuttu funktio, luetun/kirjoitetun datan tarkistussumma, parametrit sekä tulos. WHDLoad kerää lokikirjaukset sisäiseen puskuriin. Puskuri tyhjennetään poistuttaessa tai haun aikana, jos puskuri on täynnä. Tiedot kirjoitetaan ASCII-tiedostoon, dumppitiedoston nimi on ".whdl_filelog", oletussijainti on "PROGDIR:" mutta se voidaan muuttaa CoreDumpPath-valinnalla.