[Main]
[Docs]
[Installs]
[Search]
[Team]
[Guestbook]
[Links]
Volcados y archivos de bitácora de WHDLoad
WHDLoad puede crear diversos volcados y archivos de bitácora, principalmente
con el propósito de eliminar errores.
Un volcado de memoria es toda la memoria utilizada por el programa instalado
escrita a un archivo. El tamaño del volcado dependerá del programa instalado
(es igual al valor de ws_BaseMemSize en la estructura del Esclavo). Un volcado
de memoria puede ser creado si la DebugKey es presionada
durante la ejecución o luego de un error si el botón CoreDump es presionado.
El nombre del volcado de memoria creado será ".whdl_memory". La ubicación por defecto
es "PROGDIR:" pero puede ser cambiada con la opción CoreDumpPath.
Cualquier fichero existente con el mismo nombre siempre será sobreescrito. Si el
programa instalado utiliza Memoria de Expansión adicional (ws_ExpMem),
será salvado bajo el nombre ".whdl_expmem".
El volcado de registros contiene el estado completo de la CPU (incluyendo la MMU), la
CIA y los chips Custom. Algunos registros de las CIA y los Custom no son legibles, estos
estarán contenidos en el archivo de volcado si el modo Snoop esta activo.
La información será escrita en un fichero ASCII con algunas secciones resaltadas usando
secuencias de Escape (usando CSI - Control Sequence Introducer, decimal 155). Para verlo se
recomienda un programa que soporte secuencias de Escape (tales como More, MuchMore, MultiView,
...). El nombre del archivo del volcado es ".whdl_register", la ubicación por defecto es
"PROGDIR:" pero puede ser cambiada con la opción CoreDumpPath.
Si existe un fichero con el mismo nombre, el volcado será agregado al final del mismo - de lo contrario
se creara un nuevo fichero.
El fichero de volcado completo es un fichero IFF conteniendo la información de todos los ficheros de volcado previos.
La intención es que sea utilizado por otras aplicaciones. La estructura del fichero está descripta en un fichero de inclusión con el nombre whddump.i. Actualmente
las aplicaciones WHDLoadGCI (interface gráfica para programadores) y SP (salvar pantalla) pueden leer el fichero de volcado completo.
El nombre del fichero de volcado completo creado es ".whdl_dump". La ubicación por defecto es "PROGDIR:" pero puede cambiarse con la opción CoreDumpPath.
Cualquier fichero existente siempre sera sobreescrito.
Todos los accesos a disco será registrados si la opción FileLog/S ha
sido activada. Esta funcionalidad es muy útil para analizar las operaciones de disco del programa
instalado para la eliminación de errores y con el propósito de optimización. Las siguientes
funciones de resload generaran una entrada en el archivo de bitácora:
Cada acceso a archivos utilizando las funciones arriba mencionadas generara una línea en
el archivo de bitácora. La entrada muestra la función que ha sido llamada, un verificador
CRC de la información escrita/leída, los parámetros y el resultado.
WHDLoad colectará las entradas de la bitácora en un buffer interno: LogBuffer/K/N.
El buffer será descartado al salir o al crear una entrada si el buffer esta lleno. La información será escrita
a un archivo ASCII. El nombre del archivo de volcado es ".whdl_log" (con anterioridad a
WHDLoad v18.0 el nombre era ".whdl_filelog").
La ubicación por defecto es "PROGDIR:" pero puede ser cambiada con la opción CoreDumpPath.
Si existe un archivo con el mismo nombre, el volcado se agregará al final, de otra forma se
creará un nuevo archivo.
Comenzando con WHDLoad versión 18.0 es posible crear entradas de bitácora adicionales
a medida en el archivo ".whdl_log" utilizando la función resload_Log.
Las entradas recibirán formato utilizando una cadena de formato y parámetros similares a sprintf.
Las entradas se ubicarán en caché en LogBuffer/K/N para evitar
conmutaciones al sistema operativo. Para una cantidad grande de entradas el LogBuffer deberá
incrementarse en forma acorde. Para que las entradas sean salvadas deberá activarse
la opción FileLog/S.
[Main]
[Docs]
[Installs]
[Search]
[Team]
[Guestbook]
[Links]