Compartir a través de

Uso de comandos del depurador

Esto describe el uso de los comandos del depurador. WinDbg es un depurador que se puede usar para analizar volcados de memoria, depurar el modo de usuario activo y el código en modo kernel, y examinar los registros de CPU y la memoria. Para obtener más información, consulte Introducción a WinDbg.

Para instalar el depurador, consulte Instalación del depurador de Windows.

Para empezar a trabajar con WinDbg, consulte Introducción a la depuración de Windows.

Ventana de comando del depurador de WinDbg

Para WinDbg, "Ventana de comandos del depurador" hace referencia a la ventana titulada "Comando" en la barra de título. Esta ventana contiene dos paneles:

  • En el panel inferior pequeño, escriba comandos.

  • En el gran panel superior, se visualiza la salida del comando.

Esta ventana siempre está abierta al principio de una sesión de depuración. Puede volver a abrir o cambiar a esta ventana seleccionando Comando en el menú Ver, presionando ALT+1 o seleccionando el botón Comando (Alt+1) (Captura de pantalla del botón Ventana de comandos del depurador).

Puede usar las teclas FLECHA ARRIBA y FLECHA ABAJO para desplazarse por el historial de comandos. Cuando aparezca un comando anterior, puede editarlo y, a continuación, presionar ENTRAR para ejecutar el comando anterior (o la versión editada del comando anterior). El cursor no tiene que estar al final de la línea para que este procedimiento funcione correctamente.

KD o CDB

Para KD o CDB, la ventana "Comando del depurador" hace referencia a toda la ventana. Escriba comandos en el indicador en la barra inferior de la ventana. Si los comandos generan alguna salida, la ventana muestra la salida y, a continuación, vuelve a mostrar el símbolo del sistema.

Símbolo del comando de la ventana del depurador

Al realizar la depuración en modo de usuario, el indicador en la ventana de comandos del depurador es similar al siguiente ejemplo.

2:005>

En el ejemplo anterior, 2 es el número de proceso actual y 005 es el número de subproceso actual.

Si adjunta el depurador a más de un equipo, el número de sistema se incluye antes del número de proceso y del número de hilo, como en el ejemplo siguiente.

3:2:005>

En este ejemplo, 3 es el número de sistema actual, 2 es el número de proceso actual y 005 es el número de subproceso actual.

Al realizar la depuración en modo kernel de un equipo de destino que dispone únicamente de un procesador, el prompt aparece similar al siguiente ejemplo.

kd>

Sin embargo, si el equipo de destino tiene varios procesadores, el número del procesador actual aparece antes del mensaje, como en el ejemplo siguiente.

0: kd>

Si el depurador está ocupado procesando un comando emitido anteriormente, los nuevos comandos no se procesarán temporalmente, aunque se pueden agregar al búfer de comandos. Además, puedes seguir usando teclas de control en KD y CDB, y todavía puedes usar comandos de menú y teclas de método abreviado en WinDbg. Cuando KD o CDB se encuentra en este estado ocupado, no se muestra ningún mensaje. Cuando WinDbg está en un estado de actividad, aparecerá el siguiente indicador en lugar del prompt:

*BUSY*

Puede usar el comando .pcmd (Establecer comando del símbolo) para agregar texto a este símbolo.

Tipos de comandos

WinDbg, KD y CDB admiten una variedad de comandos. Algunos comandos se comparten entre los depuradores y algunos solo están disponibles en uno o dos de los depuradores.

Algunos comandos solo están disponibles durante la depuración en vivo, mientras que otros comandos solo se pueden utilizar al depurar un archivo de volcado.

Algunos comandos solo están disponibles durante la depuración en modo de usuario y otros comandos solo están disponibles durante la depuración en modo kernel.

Algunos comandos solo están disponibles cuando el destino se ejecuta en determinados procesadores. Para obtener más información sobre todos los comandos y sus restricciones, vea Comandos del depurador.

Comandos de edición, repetición y cancelación

Puede usar claves de edición estándar al escribir un comando:

  • Utilice las teclas FLECHA ARRIBA y FLECHA ABAJO para buscar comandos anteriores.

  • Edite el comando actual con las teclas BACKSPACE, DELETE, INSERT y LEFT ARROW y RIGHT ARROW.

  • Presione la tecla ESC para borrar la línea actual.

Puede presionar la tecla TAB para completar automáticamente la entrada de texto. En cualquiera de los depuradores, presione la tecla TAB después de escribir al menos un carácter para completar automáticamente un comando. Presione la tecla TAB repetidamente para recorrer las opciones de finalización de texto y mantenga presionada la tecla MAYÚS y presione TAB para desplazarse hacia atrás. También puede usar caracteres comodín en el texto y presionar TAB para expandirse al conjunto completo de opciones de finalización de texto. Por ejemplo, si escribe fo*!ba y, a continuación, presiona TAB, el depurador se expande al conjunto de todos los símbolos que comienzan por "ba", en todos los módulos con nombres de módulo que comienzan por "fo". Como otro ejemplo, puede completar todos los comandos de extensión que tienen "prcb" en ellos escribiendo !*prcb y presionando TAB.

Cuando utilizas la tecla TAB para completar el texto, si tu fragmento de texto comienza con un punto (.), el texto se asocia a un comando 'dot'. Si el fragmento de texto comienza con un signo de exclamación (!), el texto coincide con un comando de extensión. De lo contrario, el texto coincide con un símbolo. Cuando se usa la tecla TAB para escribir símbolos, al presionar la tecla TAB se completa el código y los símbolos de tipo y los nombres de módulo. Si no aparece ningún nombre de módulo, se completan los símbolos locales y los nombres de módulo. Si se proporciona un módulo o un patrón de módulo, la finalización de símbolos completa el código y los símbolos de tipo de todas las coincidencias.

Puede seleccionar y mantener presionado (o hacer clic con el botón derecho) en la ventana de comandos del depurador para pegar automáticamente el contenido del portapapeles en el comando que está escribiendo.

La longitud máxima del comando es de 4096 caracteres. Sin embargo, si controla el depurador en modo de usuario desde el depurador de kernel, la longitud máxima de línea es de 512 caracteres.

En CDB y KD, presione la tecla ENTRAR por sí misma para repetir el comando anterior. En WinDbg, puede habilitar o deshabilitar este comportamiento. Para obtener más información sobre este comportamiento, vea ENTRAR (Repetir último comando).

Si el último comando que emitió presenta una pantalla larga y desea cortarla, use la tecla CTRL+C en CDB o KD. En WinDbg, use Depurar | Interrumpa o presione CTRL+BREAK.

En la depuración en modo kernel, puede cancelar comandos desde el teclado del equipo de destino presionando CTRL+C.

Puede usar el comando .cls (Borrar pantalla) para borrar todo el texto de la ventana Comando del depurador. Este comando borra todo el historial de comandos. En WinDbg, puede borrar el historial de comandos utilizando Clear History en la pestaña Command de la barra, o seleccionando Clear command history en el menú contextual (clic con el botón derecho) de la ventana de Comandos.

Sintaxis de expresión

Muchos comandos y comandos de extensión aceptan expresiones como argumentos. El depurador evalúa estas expresiones antes de ejecutar el comando. Para obtener más información sobre las expresiones, vea Evaluación de expresiones.

Alias

Los alias son macros de texto que puede usar para evitar tener que volver a escribir frases complejas. Hay dos tipos de alias. Para obtener más información sobre los alias, consulte Uso de alias.

Comandos Auto-repetitivos

Puede usar los siguientes comandos para repetir una acción o ejecutar condicionalmente otros comandos:

Para obtener más información sobre cada comando, consulte los temas de comandos individuales.

Control de desplazamiento

Puede usar la barra de desplazamiento para ver los comandos anteriores y su salida.

Cuando se usa CDB o KD, cualquier entrada de teclado se desplaza automáticamente hacia abajo de la ventana Comando del depurador hacia la parte inferior.

En WinDbg, la pantalla se desplaza automáticamente hacia abajo hasta la parte inferior cada vez que un comando genera una salida o presiona la tecla ENTRAR. Si desea deshabilitar este desplazamiento automático, desactive el botón Auto Scroll (Desplazamiento automático) en la pestaña de la cinta De comandos o haga clic con el botón derecho en la ventana Comando y desactive Desplazamiento automático.

Características de texto de WinDbg

En WinDbg, puede usar varias características adicionales para cambiar cómo se muestra el texto en la ventana Comando del depurador. Puede acceder a algunas de estas características desde la pestaña de la cinta De comandos y algunas desde el menú contextual (haga clic con el botón derecho) en la ventana Comando.

  • El comando Ajuste de palabras del menú contextual activa y desactiva el estado del ajuste de palabras. Este comando afecta a toda la ventana, no solo los comandos que se usan después de cambiar este estado. Dado que muchos comandos y extensiones producen pantallas con formato, normalmente no se recomienda el ajuste de texto.

  • El botón Resaltar selección de la pestaña de la cinta de opciones Comando (o Resaltar selección en el menú contextual) resalta o desactiva la selección de texto actual (Ctrl+Alt+H).

  • El botón Borrar selección de la pestaña Comando de la cinta de opciones (o Borrar texto seleccionado en el menú contextual) borra el texto seleccionado actualmente del historial de la línea de comandos.

  • Puede navegar entre las secciones de comandos mediante Ir a Anterior (Ctrl+[) y Ir a Siguiente (Ctrl+]) en la pestaña Cinta de comandos , o Seleccionar comando anterior y Seleccionar comando siguiente en el menú contextual.

  • Puede personalizar los colores que se usan para el texto y el fondo de la ventana Comando del depurador. Puede especificar colores diferentes para diferentes tipos de texto. Por ejemplo, puede mostrar la salida del registro automático en un color, mensajes de error en otro color y mensajes dbgPrint en un tercer color.

  • Puedes usar todas las características comunes a las ventanas de información de depuración de WinDbg, como personalizar las fuentes y usar comandos de edición especiales.

Depuración remota

Al realizar la depuración remota a través del depurador, el cliente de depuración puede acceder a un número limitado de comandos. Para cambiar el número de comandos a los que puede acceder el cliente, use la opción de línea de comandos-clines o la variable de entorno _NT_DEBUG_HISTORY_SIZE.

  • Last updated on