Compartir vía


WinDbg: opciones de inicio de la línea de comandos

Logotipo de WinDbg con una lupa inspeccionando bits.

Inicio de WinDbg

Una vez instalado WinDbg, WinDbgX.exe está disponible para ejecutarse desde cualquier ubicación del directorio.

Opciones de inicio de la línea de comandos

WinDbgX [options]

En estas tablas se resumen las opciones de línea de comandos disponibles.

Opciones generales

Opción Descripción
-c "comando" Ejecuta un comando después de conectar el depurador. Este comando debe incluirse entre comillas. Se pueden separar varios comandos con punto y coma.
-v Habilita la salida detallada en el depurador.
-T Title Establece el título de la ventana.
-logo LogFile Abra el registro. Comienza a registrar información en un archivo de registro. Si el archivo existe, se sobrescribirá.
-loga LogFile Añadir al registro. Comienza a registrar información en un archivo de registro. Si el archivo existe, se le añadirá contenido.
-e EventHandle Indica el evento con el identificador especificado después de la siguiente excepción en un destino.
-¿ Muestra un resumen de los comandos disponibles.

Opciones del kernel

Opción Descripción
-k [ConnectType] Inicia una sesión de depuración del kernel. Si se usa -k sin ninguna opción connectType que la siga, debe ser la entrada final en la línea de comandos.
-kqm Inicia KD en modo silencioso.
-Kl Inicia una sesión de depuración de kernel en el mismo equipo que el depurador.
-kx ExdiOptions Inicia una sesión de depuración del kernel mediante un controlador EXDI. Para obtener más información sobre EXDI, consulte Configuración del transporte del depurador EXDI.
-d Después de un reinicio, el depurador se dividirá en el equipo de destino tan pronto como se cargue un módulo de kernel.

Opciones del modo de usuario

Opción Descripción
-o Depura todos los procesos iniciados por la aplicación de destino (procesos secundarios).
-g Omite el punto de interrupción inicial en la aplicación de destino.
-G Ignora el punto de ruptura final en la aplicación objetivo.
-pv Especifica que el depurador debe asociarse al proceso de destino de forma no invasiva.
-HD Especifica que no se debe usar la pila de depuración.
-cimp Especifica que los procesos creados usarán una línea de comandos implícita establecida por el servidor en lugar de una cadena de línea de comandos dada por el usuario del cliente.

Opciones de destino

Opción Descripción
-remote ClientTransport Se conecta a un servidor de depuración que ya se está ejecutando. Para obtener una explicación de los posibles valores de ClientTransport , consulte Activación de un cliente de depuración. Cuando se usa este parámetro, debe ser el primer parámetro de la línea de comandos.
-server ServerTransport Crea un servidor de depuración al que pueden acceder otros depuradores. Para obtener una explicación de los posibles valores ServerTransport , vea Activar un servidor de depuración.
-premote SmartClientTransport Crea un cliente inteligente y se conecta a un servidor de procesos que ya se está ejecutando. Para obtener una explicación de los posibles valores de SmartClientTransport, consulte Activación de un cliente inteligente.
-p PID Especifica el identificador de proceso decimal que se va a depurar.
-tid TID Especifica el identificador de subproceso de un subproceso que se va a reanudar cuando se inicia la sesión de depuración.
-psn ServiceName Especifica el nombre del servicio contenido en el proceso que se va a depurar. Se usa para depurar un proceso que ya se está ejecutando.
-pn ProcessName Especifica el nombre del proceso que se va a depurar.
-z DumpFile Especifica el nombre de un archivo de volcado de memoria que se va a depurar. Si la ruta de acceso y el nombre de archivo contienen espacios, debe estar entre comillas.
-debugArch x86 -or- amd64 Anule el comportamiento de detección automática y establezca el tamaño de bits objetivo para el depurador.
-loadSession Cargue un archivo de configuración de sesión guardado.
-configurarReglasDeFirewall Configura las reglas de firewall necesarias en el sistema local para permitir la depuración del kernel mediante KDNET.
-openPrivateDumpByHandle Handle Solo uso interno de Microsoft. Especifica el identificador de un archivo de volcado de memoria que se va a depurar.
-benchmarkStartup Solo uso interno de Microsoft. Ejecuta una prueba comparativa de inicio y anexa el resultado a un archivo.

Opciones de símbolos

Opción Descripción
-y SymbolPath Especifica la ruta de acceso al símbolo. Separe varias rutas de acceso con punto y coma (;). Si la ruta de acceso contiene espacios, debe incluirse entre comillas. Para obtener más información y otras formas de cambiar esta ruta de acceso, consulte Ruta de acceso de símbolos.
-n Carga ruidosa de símbolos. Habilita la salida detallada del controlador de símbolos.
-i ImagePath Establece la ruta de acceso de búsqueda de imágenes que se va a usar.
-sdce Hace que el depurador muestre mensajes de error de acceso a archivo durante la carga de símbolos.
-ses Hace que el depurador realice una evaluación estricta de todos los archivos de símbolos y omita los símbolos interrogables.
-sicv Hace que el controlador de símbolos ignore el registro CV
-Pecados Hace que el depurador omita la ruta de acceso de símbolos y las variables de entorno de la ruta de acceso de la imagen ejecutable.
-snc Hace que el depurador desactive la traducción de C++.
-snul Deshabilita la carga automática de símbolos para nombres no calificados.
-súper Hace que el controlador de símbolos busque en la tabla de símbolos públicos durante cada búsqueda de símbolos.
-sflags Establece todas las opciones del controlador de símbolos a la vez.

Opciones de ruta de origen

Opción Descripción
-srcpath Especifica la ruta de acceso de origen para usar en el servidor de depuración.
-lsrcpath Especifica la ruta de acceso de origen que se va a usar en el cliente local.

Si está en una sesión de depuración local, srcpath y lsrcpath son prácticamente iguales (su “servidor” es su sesión local). Para la depuración remota, hay situaciones en las que es posible que desee asignarles valores distintos. Para obtener más información sobre la depuración remota, consulte Depuración remota.

Control de excepciones

Opción Descripción
-X Habilite el control de segunda oportunidad solo para las excepciones de infracción de acceso.
-xe Exception Habilite el control de excepciones de primera oportunidad para la excepción especificada.
-xd Exception Habilite el control de excepciones de segunda oportunidad para la excepción especificada.
-xn Exception Para la excepción dada, deshabilite el control de primera y segunda oportunidad y muestre solo un mensaje en la consola.
-xi Excepción Omita completamente la excepción dada, deshabilite el control de primera y segunda oportunidad y no produzca nada en la consola.

Para obtener una lista de excepciones que se pueden especificar, consulte Definiciones de eventos y valores predeterminados.

Post mortem

Opción Descripción
-Yo Establece WinDbg como depurador post-mortem predeterminado para el sistema.
-ES Establece WinDbg como el depurador post mortem predeterminado para el sistema de forma silenciosa, informando solo los errores.

Opciones en desuso

Opción Descripción
-Q Opción de línea de comandos en desuso.
-QY Opción de línea de comandos en desuso.
-QS Opción de línea de comandos en desuso.
-QSY Opción de línea de comandos en desuso.
-WX Opción de línea de comandos en desuso.

Para obtener información general sobre los parámetros de inicio, vea WinDbg Command-Line Options.

¿Puede usar -? para enumerar las opciones de línea de comandos admitidas.

Captura de pantalla de la salida de la línea de comandos de WinDbgX que muestra varias opciones.

Véase también

Características de WinDbg