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.
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ę, 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.