Compartir a través de


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 "command" Ejecuta una línea de comandos después de adjuntar el depurador. Este comando debe ir 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 Anexar registro. Comienza a registrar información en un archivo de registro. Si el archivo existe, se anexará a .
-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 de kernel

Opción Descripción
-k [ConnectType] Inicia una sesión de depuración de kernel. Si se usa -k sin ninguna opción connectType que lo 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 la misma máquina que el depurador.
-kx ExdiOptions Inicia una sesión de depuración de kernel mediante un controlador EXDI. Para obtener más información sobre EXDI, vea Configuring the EXDI Debugger Transport.
-d Después de un reinicio, el depurador se dividirá en el equipo de destino en cuanto 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 Omite el punto de interrupción final de la aplicación de destino.
-Pv Especifica que el depurador debe asociarse al proceso de destino de forma novasiva.
-Hd Especifica que no se debe usar el montón 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 especificada 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 de 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 -o- amd64 Invalide el comportamiento de detección automática y establezca el valor de bits de destino para el depurador.
-loadSession Cargue un archivo de configuración de sesión guardado.
-setupFirewallRules 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 que se va a usar. Separe varias rutas de acceso con un punto y coma (;). Si la ruta de acceso contiene espacios, debe ir entre comillas. Para obtener más información y otras formas de cambiar esta ruta de acceso, vea Ruta de acceso de símbolos.
-n Carga de símbolos ruidosos. Habilita la salida detallada del controlador de símbolos.
-i ImagePath Establece la ruta de búsqueda de imágenes que se va a usar.
-sdce Hace que el depurador muestre los mensajes "Error de acceso a archivos" 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 omita el registro CV.
-Pecados Hace que el depurador omita la ruta de acceso del símbolo y las variables de entorno de ruta de acceso de imagen ejecutables.
-Snc Hace que el depurador desactive la traducción de C++.
-snul Deshabilita la carga automática de símbolos para nombres no completos.
-súper Hace que el controlador de símbolos busque en la tabla de símbolos públicas durante cada búsqueda de símbolos.
-sflags Establece todas las opciones del controlador de símbolos a la vez.

Opciones de ruta de acceso de origen

Opción Descripción
-Srcpath Especifica la ruta de acceso de origen que se va a 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 se encuentra en una sesión del depurador local, srcpath y lsrcpath son eficazmente iguales (el "servidor" es la sesión local). Para la depuración remota hay lugares en los que es posible que desee establecerlos en valores diferentes. 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 (excepción) 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 solo muestre 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, vea Definiciones de eventos y valores predeterminados.

Post Mortem

Opción Descripción
-I Establece WinDbg como el depurador post mortem predeterminado para el sistema.
-ES Establece WinDbg como el depurador post mortem predeterminado para el sistema de forma silenciosa, con solo los errores que se notifican.

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, consulte Opciones de WinDbg Command-Line.

¿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.

Consulte también

Características de WinDbg