Depuración básica de AML
El depurador de AMLI admite dos tipos de comandos especializados: extensiones del depurador de AMLI y comandos del depurador de AMLI.
Al realizar la depuración de AML, debe distinguir cuidadosamente entre dos tipos diferentes de avisos que aparecerán en la ventana Comando del depurador:
Cuando vea el símbolo del sistema kd> , está controlando el depurador de kernel. Todos los comandos y extensiones del depurador de kernel estándar están disponibles. Además, también están disponibles las extensiones del depurador de AMLI. Estas extensiones tienen una sintaxis del comando !amli. Los comandos del depurador de AMLI no están disponibles en este modo.
Cuando vea AMLI (? para obtener ayuda):> se le pedirá que controle el depurador de AMLI. (Cuando se usa WinDbg, este mensaje aparecerá en el panel superior de la ventana Comando del depurador y un El mensaje de entrada> aparecerá en el panel inferior). Desde este símbolo del sistema, puede escribir cualquier comando del depurador de AMLI. También puede escribir cualquier extensión del depurador de AMLI; estas extensiones no deben tener el prefijo !amli. Los comandos de depuración de kernel estándar no están disponibles en este modo.
Cuando no ve ningún mensaje, el equipo de destino se está ejecutando.
Al principio de cualquier sesión de depuración, debe establecer las opciones del depurador de AMLI con la extensión !amli set. Las opciones verboseon, traceon y errbrkon también son muy útiles. Debe considerar la posibilidad de activar la opción spewon . Consulte la página de referencia de la extensión para obtener más información.
Hay varias maneras de que el depurador de AMLI se active:
Si se encuentra un punto de interrupción en el código AML, ACPI se dividirá en el depurador de AMLI.
Si se produce un error grave o una excepción en el código AML (por ejemplo, un int 3), ACPI se dividirá en el depurador de AMLI.
Si se ha establecido la opción errbrkon , cualquier error de AML hará que ACPI se interrumpa en el depurador de AMLI.
Si desea dividir deliberadamente en el depurador de AMLI, use la extensión del depurador !amli y, a continuación, el comando g (Go). La próxima vez que el intérprete ejecute cualquier código AML, el depurador de AMLI tomará el control.
Cuando se encuentra en el símbolo del sistema del depurador de AMLI, puede escribir q para volver al depurador de kernel o escribir g para reanudar la ejecución normal.
Las siguientes extensiones son especialmente útiles para la depuración de AML:
La extensión dns !amli muestra el espacio de nombres ACPI para un objeto determinado, el árbol de espacios de nombres subordinado a ese objeto o incluso el árbol de espacio de nombres completo. Este comando es especialmente útil para determinar qué es un objeto de espacio de nombres determinado, ya sea un método, una unidad de campo, un dispositivo u otro tipo de objeto.
La extensión !amli find toma el nombre de cualquier objeto de espacio de nombres y devuelve su ruta de acceso completa.
La extensión !amli u desembla el código AML.
La extensión !amli lc muestra información breve sobre todos los contextos ACPI activos.
La extensión !amli r muestra información detallada sobre el contexto actual del intérprete. Esto resulta útil cuando aparece el mensaje del depurador de AMLI después de detectar un error.
Los puntos de interrupción se pueden establecer y controlar dentro del código AML. Use !amli bp para establecer un punto de interrupción, !amli bc para borrar un punto de interrupción, !amli bd para deshabilitar un punto de interrupción, !amli ser para volver a habilitar un punto de interrupción y !amli bl para enumerar todos los puntos de interrupción.
El depurador de AMLI puede ejecutar, realizar pasos y seguimientos a través del código AML. Use los comandos run, p y t para realizar estas acciones.
Para obtener una lista completa de extensiones y comandos, consulte Uso de extensiones del depurador de AMLI y Uso de comandos del depurador de AMLI.