Manual para la Depuración de AROSEste manual explica las varias opciones para la depuración de AROS. IntroducciónPara la mayoría de los desarrolladores, la manera más fácil para desarrollar y depurar es usar el puerto de AROS hosted en Linux (que es la configuración más popular) o en BSD. De esta manera puedes usar GDB en Linux para depurar AROS. Necesitarás pasar --enable-debug al guión de configure antes de compilar AROS. Ten cuidado, las informaciones de depuración pueden decuplicar el tamaño de disco ocupado por el árbol de AROS. Los desarrolladores de hardware de bajo nivel usarán de preferencia la salida de depuración en serie/serial en el puerto nativo. Los desarrolladores de aplicación necesitarán asegurarse que sus programas liberan todos los recursos que tomen. AROS proporciona algunas herramientas para hacer esto. Imprimir las sentencias de depuración
#define DEBUG 1
#include <aros/debug.h>
...
D(bug("value1=%ld, path=%s", value, path));
D() se expandirá a nada si DEBUG es 0 o indefinido. El uso es el mismo que de printf(). En el AROS hosted, la salida será mostrada en la consola donde AROS fue iniciado. Con AROS alojado: Usando GDBPuedes ejecutar AROS en GDB, o usar GDB después de que AROS ha terminado y deja un vaciado de la memoria. No olvides compilar AROS con la depuración habilitada (./configure --enable-debug). La depuración en vivoInicia GDB igual que abajo: > cd /AROS/bin/linux-i386/AROS/ > gdb aros GNU gdb 6.0-debian Copyright 2003 Free Software Foundation, Inc. GDB is free software, covered by the GNU General Public License, and you are welcome to change it and/or distribute copies of it under certain conditions. Type "show copying" to see the conditions. There is absolutely no warranty for GDB. Type "show warranty" for details. This GDB was configured as "i386-linux"... (gdb) Luego ejecuta AROS con: (gdb) r Starting program: /AROS/bin/linux-i386/AROS/aros (... lots of debug output follow ...) (... sigue mucha salida de depuración ...) Puedes pasarle argumentos a AROS ubicándolos después del comando r. Usa Ctrl-C en el shell para interrumpir AROS y volver al prompt de GDB. Usa help para tener ayuda, o q para salir :) La depuración post-mortemPrimero, tienes que habilitar la generación del vaciado de la memoria, usando, por ej. ulimit si el shell es Bash. Después ejecuta AROS y genera el vaciado de la memoria: > cd /AROS/bin/linux-i386/AROS/ > ulimit -c unlimited # see your shell manual to enable core dumps > ./aros Quit (core dumped) Ahora puedes iniciar GDB, especificando el nombre del ejecutable de AROS y el nombre del archivo con la memoria volcada: > gdb aros core GNU gdb 6.0-debian Copyright 2003 Free Software Foundation, Inc. GDB is free software, covered by the GNU General Public License, and you are welcome to change it and/or distribute copies of it under certain conditions. Type "show copying" to see the conditions. There is absolutely no warranty for GDB. Type "show warranty" for details. This GDB was configured as "i386-linux"... Core was generated by `aros'. Program terminated with signal 3, Quit. Reading symbols from /usr/X11R6/lib/libX11.so.6...done. Loaded symbols for /usr/X11R6/lib/libX11.so.6 Reading symbols from /usr/X11R6/lib/libXext.so.6...done. Loaded symbols for /usr/X11R6/lib/libXext.so.6 Reading symbols from /lib/libc.so.6...done. Loaded symbols for /lib/libc.so.6 Reading symbols from /lib/libdl.so.2...done. Loaded symbols for /lib/libdl.so.2 Reading symbols from /lib/ld-linux.so.2...done. Loaded symbols for /lib/ld-linux.so.2 #0 0x40125607 in sigsuspend () from /lib/libc.so.6 (gdb) GDG (los comandos básicos)El comando help entrega la ayuda para todos los comandos de GDB. Invócalo directamente para tener una lista del tema de ayuda conocido, o sigue un tema o el nombre (o abreviación) de un comando. Se te anima a leer la ayuda online de todos los comandos que brevemente serán presentados aquí. El comando bt (backtrace) imprime un backtrace de todos los marcos de la pila. Aquí está un backtrace después de interrumpir AROS con Ctrl-C en la consola GDB: Program received signal SIGINT, Interrupt. 0x40125607 in sigsuspend () from /lib/libc.so.6 (gdb) bt #0 0x40125607 in sigsuspend () from /lib/libc.so.6 #1 0x080531d5 in idleTask (sysBase=0x40231290) at idletask.c:23 #2 0x08052ba7 in Exec_NewAddTask (task=Cannot access memory at address 0x8 ) at newaddtask.c:280 Previous frame inner to this frame (corrupt stack?) (gdb) El marco más interno es el #0. Para imprimir el valor de una expresión accesible del marco actual, usa p (print, imprimir): (gdb) p SysBase $1 = (struct ExecBase *) 0x40231290 El comando imprimir de GDB es muy poderoso. Entiende la sintaxis de C, así que puedes imprimir cualquier expresión válida:
(gdb) p SysBase->IntVects[2]
$2 = {iv_Data = 0x0, iv_Code = 0x8052f30 <SoftIntDispatch>, iv_Node = 0x4023c528}
También puedes usar print como una calculadora hexadecimal, como: (gdb) p 0x42 + 0xc0de $1 = 49440 Para mostrar el resultado en hexadecimal, usa p/x (fíjate cómo puedes llamar una expresión anterior): (gdb) p/x $1 $2 = 0xc120 Para moverte entre marcos, usa el comando f (frame, marco): (gdb) f 1 #1 0x080531d5 in idleTask (sysBase=0x40231290) at idletask.c:23 23 sigsuspend(&sigs); Para mostrar diez renglones del código fuente en torno a la posición actual, usa l (list), que también se puede usar para mostrar un renglón específico. Si estás haciendo la depuración en vivo:
Usa q para salir: (gdb) q The program is running. Exit anyway? (y or n) y > GDB (específico para AROS)Los comandos de GDB específicos para AROS son suministrados en /AROS/_gdbinit, que se instala en /AROS/bin/linux-i386/AROS/.gdbinit. GDB lee este archivo al iniciarse, y contiene los siguientes comandos: findaddr - Muestra el módulo que contiene la dirección dada. thistask - Imprime información sobre la tarea en ejecución. liblist - Lista las bibliotecas actuales del sistema. devlist - Lista los dispositivos actuales del sistema. resourcelist - Lista los recursos actuales del sistema. residentlist - Lista los residentes del sistema. taskready - Lista las tareas actuales listas para ejecutarse. taskwait - Lista las tareas que esperan un evento. modlist - Lista todos los módulos cargados en la memoria. printtaglist - Muestra la taglist dada. De esta lista, findaddr es esencial para una apropiada depuración del código no-ROM (bibliotecas compartidas, aplicaciones...) Usar findaddrMás a menudo querrás depurar bibliotecas o aplicaciones, pero un backtrace te da una o más direcciones sin resolver:
Core was generated by `aros'.
Program terminated with signal 11, Segmentation fault.
Reading symbols from /usr/X11R6/lib/libX11.so.6...done.
Loaded symbols for /usr/X11R6/lib/libX11.so.6
Reading symbols from /usr/X11R6/lib/libXext.so.6...done.
Loaded symbols for /usr/X11R6/lib/libXext.so.6
Reading symbols from /lib/libc.so.6...done.
Loaded symbols for /lib/libc.so.6
Reading symbols from /lib/libdl.so.2...done.
Loaded symbols for /lib/libdl.so.2
Reading symbols from /lib/ld-linux.so.2...done.
Loaded symbols for /lib/ld-linux.so.2
#0 0x080c8830 in Intuition_SetAttrsA (object=0x317ceb, tagList=0x402f7504,
IntuitionBase=0x40289dfc) at setattrsa.c:84
84 result = DoMethodA (object, (Msg)&ops);
(gdb) bt
#0 0x080c8830 in Intuition_SetAttrsA (object=0x317ceb, tagList=0x402f7504,
IntuitionBase=0x40289dfc) at setattrsa.c:84
#1 0x402bd919 in ?? ()
#2 0x00317ceb in ?? ()
#3 0x402f7504 in ?? ()
#4 0x40289dfc in ?? ()
#5 0x8042bfe0 in ?? ()
#6 0x404ca36c in ?? ()
Usa findaddr con cualquier dirección que quieras resolver (probablemente la más interna): (gdb) findaddr 0x402bd919 Searching in the loaded modules... Address found in System:Tests/Zune/list1, which is loaded at 0x402bd454. If this is an executable, its .text section starts at 0x402bd460 Después usarás el comando add-symbol-file para cargar el archivo encontrado en la dirección hallada del texto:
(gdb) add-symbol-file Tests/Zune/list1 0x402bd460
add symbol table from file "Tests/Zune/list1" at
.text_addr = 0x402bd460
(y or n) y
Reading symbols from Tests/Zune/list1...done.
Con suerte ha resuelto las direcciones:
(gdb) bt
#0 0x080c8830 in Intuition_SetAttrsA (object=0x317ceb, tagList=0x402f7504,
IntuitionBase=0x40289dfc) at setattrsa.c:84
#1 0x402bd919 in main () at list1.c:107
#2 0x402bd5d1 in __startup_entry (argstr=0x402bcd24 "\n", argsize=1,
sysbase=0x40232290) at startup.c:102
#3 0x080580a7 in Dos_RunProcess (proc=0x403f76f0, sss=0x403daac4,
argptr=0x402bcd24 "\n", argsize=1, entry=0x402bd458, DOSBase=0x402a6888)
at runprocess.c:123
#4 0x0806a1c7 in Dos_RunCommand (segList=0x402bd454, stacksize=40960,
argptr=0x402bcd24 "\n", argsize=1, DOSBase=0x402a6888) at runcommand.c:107
#5 0x40400461 in ?? ()
#6 0x402bd454 in ?? ()
#7 0x0000a000 in ?? ()
#8 0x402bcd24 in ?? ()
#9 0x00000001 in ?? ()
#10 0x402a6888 in ?? ()
Así que con suerte puedes encontrar el error: (gdb) f 1 #1 0x402bd919 in main () at list1.c:107 107 set(3243243, MUIA_Window_Open, TRUE); Repite para las direcciones restantes que deseas resolver. Usando thistaskMuestra información variada de la tarea que se está ejecutando. No sorprende, son los datos que puedes hallar en SysBase->ThisTask: (gdb) thistask Task SigWait SigRecvd StkSize StkUsed Pri Type Name ----------------------------------------------------------------------------- 40231fb8 00000000 00000000 40960 872 -128 1 Idle Task Consejos y trucosUn punto de interrupción inducido por el programa en i386Si insertas:
asm("int $3");
en el código C, se generará una trace excepction durante la ejecución. Puede ser muy útil mientras ejecutas con GDB, para ingresar a la depuración interactiva cuando una condición específica ocurre:
if (byteSize == 112)
asm("int $3");
Resource trackingEl Resource Tracking igual al de los otros OS no está disponible en AROS en este momento, así que tendrás que encargarte de liberar los recursos por tí mismo. Aquí encontrarás algunas herramientas que te ayudarán a comprobar que tu programa esté limpio. Siguiendo a la memoria con MungwallSi está configurado con --enable-debug, AROS habilita Mungwall. que vigila una pequeña zona antes y después de tus asignaciones para verificar que no escribas fuera de los límites. Esta comprobación se hace en las rutinas de asignación de memoria, o en cualquier momento si se invoca AvailMem(MEMF_CLEAR). La herramienta de línea de comando CheckMem llama a esta función, e informa a la salida de depuración (serial para el nativo, o la terminal para el hospedado). Si no se detecta ninguna violación de límite, informará la cantidad actual de asignaciones y su tamaño total: === MUNGWALL MEMORY CHECK ============ Num allocations: 1579 Memory allocated 3333326 LeakWatchÉsta es una herramienta tonta pero útil. Caza la memoria total y los objetos de Exec: las bibliotecas, los dispositivos, las fuentes, los recursos, los puertos y los semáforos. Dispara un flush de objetos sin uso que están aún en la memoria para informar el monto real de memoria después de que algunos recursos son cerrados. Lanza LeakWatch en su propio shell, después usa las siguientes teclas:
Ctrl-F es la tecla más útil: apriétala antes de ejecutar tu programa, y después de salir de él. No debería informar ningún recurso. En el caso opuesto:
Si piensas que tu programa disparó un leak en una biblioteca de AROS, busca un programa de prueba existente o escribe uno pequeño que use las llamadas que hacen leak, para asegurarte que el leak realmente viene de allí. Herramientas misceláneas del CLITambién hay herramientas de depuración más simples que están en C:. El Shell de AROSTipea en el Shell set __debug_mem para habilitar los informes de la memoria disponible antes y después de cada comando, así como la diferencia de memoria. En esencia lo mismo que LeakWatch sólo que para la memoria. AvailUsa Avail para mostrar informaciones sobre la memoria. El parámetro FLUSH forzará que sean expurgados los objetos no usados. LiblistMuestra una lista de las bibliotecas que estén abiertas en ese momento como también alguna información sobre la versión y la cantidad abierta. DevlistLo mismo que Liblist, pero para los Dispositivos de Exec. Consejos y trucosLa revisión de Mungwall en el planificadorUn ingenioso truco de Mungwall es modificar el planificador para que llame a AvailMem(MEMF_CLEAR) en cada conmutación de tarea, cuando tengas una extraña corrupción de memoria que no puedas rastrear por otros medios. De esta manera forzarás un revisión de la memoria después de que cada tarea tenga su quantum de tiempo. Es lento, pero no hay modo en que el culpable pueda escapar. Memory leaks
|
Copyright © 1995-2024, The AROS Development Team. All rights reserved.
Amiga® is a trademark of Amiga Inc. All other trademarks belong to their respective owners. |