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