[Main]
[Docs]
[Installs]
[Search]
[Team]
[Guestbook]
[Links]
WHDLoad's dumps og logfiler
Hovedsageligt ifm. fejlretningsformål kan WHDLoad oprette forskellig dump- og logfiler.
Et hukommelsesdump er hele hukommelsen brugt af det installerede program, skrevet til en fil. Størrelsen på dumpet afhænger af det installerede program (det er lig værdien af ws_BaseMemSize i Slavestrukturen). Et hukommelsesdump vil blive oprettet, hvis DebugKey tastes eller - efter en fejl - hvis CoreDump-tasten tastes. Navnet på den oprettede hukommelsesdump-fil er ".whdl_memory". Standard-lokationen er "PROGDIR:" men kan ændres med CoreDumpPath optionen. En eksisterende fil med samme navn vil altid blive overskrevet. Hvis det installerede
program bruger yderligere Ekspansionshukommelse (ws_ExpMem), gemmes den under filnavnet".whdl_expmem".
Register-dumpet indeholder den komplette status for CPU'en (inklusiv MMU), CIA og de brugerdefinerede chips. Nogle CIA- og brugerdefinerede registre er ikke læsbare,
disse er kun indeholdt i dumpfilen, hvis et Snoop modus var aktivt. Information vil blive skrevet til en ASCII-fil med noget fremhævning foretaget vha. Escape-sekvenser
(ved brug af CSI - Control Sequence Introducer, decimal 155). For visning er et program, der understøtter Escape-sekvenser anbefalet (f.eks. More, MuchMore, MultiView,
...). Navnet på dumpfilen er ".whdl_register", standardplaceringen er
"PROGDIR:", men kan ændres med CoreDumpPath optionen. Hvis en fil med samme navn allerede eksisterer, vil dumpet blive tilføjet - ellers vil en ny fil blive oprettet.
Den komplette dumpfil er en IFF-fil, der indeholder infomationen over alle tidligere listede dumpfiler.
Det er beregnet til at blive brugt af andre applikationer. Filstrukturen er beskrevet i en ekstra include-fil ved navn
whddump.i. Pt. læser applikationerne WHDLoadGCI (grafisk kode-interface) og SP (gem billede) den komplette dumpfil.
Navnet på den komplette dumpfil, der er oprettet, er ".whdl_dump". Standardplaceringen er
"PROGDIR:", men kan ændres med CoreDumpPath optionen. En eksisterende fil vil altid blive overskrevet.
Alle diskadgange vil blive logget hvis FileLog/S optionen er blevet aktiveret. Denne funktion vil være meget brugbar til at analysere det installerede programs diskoperationer ifm. fejlretnings- og optimeringsformål. Følgende resload-funktion vil oprette en indgang i logfilen:
Hver filadgang skaber via de ovenfor nævnte funktioner ån linje i logfilen. En logindgang viser den kaldte funktion, en CRC af de læste/skrevne data, parametrene og resultatet.
WHDLoad vil indsamle logindgangene i en intern
LogBuffer/K/N. Bufferen vil blive tømt ved afslutning og ifm. oprettelse af en indgang, hvis bufferen er fuld.
Informationen vil blive skrevet til en ASCII-fil. Navnet på dumpfilen er ".whdl_log" (forud for
WHDLoad v18.0 var det ".whdl_filelog"). Standardplaceringen er "PROGDIR:", men kan ændres med CoreDumpPath
optionen. Hvis en fil med samme navn allerede ekisterer, vil dumpet blive tilføjet - ellers vil en ny fil blive oprettet.
Begyndende med WHDLoad version 18.0
er det muligt at oprette yderligere brugerdefinerede logindgange i filen ".whdl_log"
vha. funktionen resload_Log. Indgangene kan formateres vha. en sprintf-lignende streng and parametre.
Indgange vil blive cachet i LogBuffer/K/N for at
undgå skift til operativsystemet. For en stor mængde indgange bør
LogBufferen øges tilsvarende.
For at få logindgangene skrevet, skal optionen FileLog/S være aktiveret.
[Main]
[Docs]
[Installs]
[Search]
[Team]
[Guestbook]
[Links]