Pliki zrzutów

### Pliki raportów i zrzutów WHDLoad

W celu ułatwienia śledzenia błędów WHDLoad może tworzyć różne pliki zrzutów i raportów.

#### Zrzuty pamięci

Zrzutem pamięci jest zapisanie do pliku całkowitej zawartości pamięci używanej przez zainstalowany program. Wielkość pliku zrzutu zależy od zainstalowanego programu (odpowiada wartości ws_BaseMemSize w strukturze pliku .slave). Zrzut pamięci zostanie utworzony po naciśnięciu klawisza DebugKey lub, w przypadku wystąpienia błędu i naciśnięciu przycisku CoreDump. Nazwa pliku zrzutu pamięci to ".whdl_memory". Domyślą ścieżką jest "PROGDIR:", ale można to zmienić używając opcji CoreDumpPath. Istniejący plik o takiej nazwie zawsze zostanie zastąpiony. Jeśli zainstalowany program używa dodatkowej pamięci fast, zostanie to zapisane pod nazwą ".whdl_expmem".

#### Zrzuty rejestrów

Zrzut rejestru zawiera całkowity status procesora (włączając w to MMU), CIA oraz rejestrów układów specjalizowanych. Niektóre rejestry CIA i układów specjalizowanych nie mogą zostać odczytane, dlatego też są umieszczane w pliku zrzutu, gdy jest włączony tryb Snoop. Informacje są zapisywane w pliku ASCII z drobnymi wyszczególnieniami utworzonymi poprzez sekwencje Esc (przy użyciu znaku rozpoczynającego sekwencję kontrolną (ang. CSI - Control Sequence Introducer), dziesiętnie 155). Do wyświetlania zaleca się używanie programu obsługującego sekwencje Esc (np. More, MuchMore, MultiView, itp.). Nazwa pliku zrzutu rejestru to ".whdl_register". Domyślą ścieżką jest "PROGDIR:", ale można to zmienić używając opcji CoreDumpPath. Jeśli istnieje plik o takiej nazwie, zrzut zosytanie do niego dołączony - w przeciwnym razie zostanie utworzony nowy plik.

#### Plik kompletnego zrzutu

Plik kompletego zrzutu jest plikiem w formacie IFF zawierającym informacje o wszystkich wcześniejszych plikach zrzutu. Plik ten jest przeznaczony do wykorzystania przez inne aplikacje. Struktura pliku jest opisana w dodatkowym pliku `whddump.i`. Obecnie wykorzystują go aplikacje WHDLoadGCI (graficzny interfejs kodera) oraz SP (zapisywanie obrazków). Nazwa tworzonego pliku kompletnego zrzutu to ".whdl_dump". Domyślnym katalogiem zapisywania pliku zrzutu jest "PROGDIR:", ale można to zmienić wykorzystując opcję CoreDumpPath. Istniejący plik będzie zawsze nadpisywany.

#### Raporty dostępu do plików

Jeśli zostanie użyta opcja FileLog, to każda próba dostępu do pliku będzie raportowana. Opcja ta może być użyteczna do analizy operacji dyskowych przeprowadzanych przez zainstalowany program w celu wyszukiwania błędów i dokonania optymalizacji. Następujące funkcje tworzą wpisy w pliku raportu:

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

Każde odwołanie do pliku przy użyciu jednej z powyższych funkcji tworzy jedną linię wpisu w pliku raportu, linia określa wywołaną funkcję, sumę kontrolną crc odczytanych/zapisanych danych, parametry oraz rezultat jej działania. WHDLoad przechowuje wszystkie wpisy w wewnętrznym buforze. Bufor jest opróżniany przy wyjściu, lub, gdy nastąpi jego przepełnienie, podczas wywołania jednej z wymienionych funkcji. Informacje zostaną zapisane w pliku ASCII, nazwa pliku raportu to ".whdl_filelog", domyślą ścieżką jest "PROGDIR:", ale można to zmienić używając opcji CoreDumpPath.