Opciones de línea de comandos de WinDbg

Los usuarios de WinDbg por primera vez deben comenzar con la sección Depuración mediante WinDbg (clásico).

La línea de comandos de WinDbg usa la sintaxis siguiente:

windbg [ -server ServerTransport | -remote ClientTransport ] [-lsrcpath ]
   [ -premote SmartClientTransport ] [-?] [-ee {masm|c++}] 
   [-clines lines] [-b] [-d] [-aExtension]  
   [-failinc] [-g] [-G] [-hd] [-j] [-n] [-noshell] [-o] [-openPrivateDumpByHandle Handle]
   [-Q | -QY] [-QS | -QSY] [-robp] [-secure] [-ses] [-sdce] 
   [-sicv] [-sins] [-snc] [-snul] [-sup] [-sflags 0xNumber] 
   [-T Title] [-v] [-log{o|a} LogFile] [-noinh] 
   [-i ImagePath] [-y SymbolPath] [-srcpath SourcePath] 
   [-k [ConnectType] | -kl | -kx ExdiOptions] [-c "command"] 
   [-pb] [-pd] [-pe] [-pr] [-pt Seconds] [-pv]
   [-W Workspace] [-WF Filename] [-WX] [-zp PageFile] 
   [ -p PID | -pn Name | -psn ServiceName | -z DumpFile | executable ] 

windbg -I[S] 

windbg -IU KeyString

windbg -IA[S] 

A continuación se describen las opciones de línea de comandos de WinDbg. Todas las opciones de línea de comandos distinguen mayúsculas de minúsculas, excepto -j. El guión inicial se puede reemplazar por una barra diagonal (/).

Si se usa la opción -remote o -server , debe aparecer antes de cualquier otra opción en la línea de comandos. Si se especifica un archivo ejecutable , debe aparecer en último lugar en la línea de comandos; cualquier texto después de pasar el nombre ejecutable al programa ejecutable como sus propios parámetros de línea de comandos.

Parámetros

-servidor 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. Cuando se usa este parámetro, debe ser el primer parámetro de la línea de comandos.

-remoto ClientTransport
Crea un cliente de depuración y 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.

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

-un Extensión
Establece el archivo DLL de extensión predeterminado. El valor predeterminado es kdextx86.dll o kdexts.dll. No debe haber espacio después de "a" y no se debe incluir la extensión de nombre de archivo .dll. Para obtener más información y otros métodos para establecer este valor predeterminado, consulte Carga de archivos DLL de extensión del depurador.

-b
Esta opción ya no se admite.

-c " command "
Especifica el comando inicial del depurador que se va a ejecutar en el inicio. Este comando debe incluirse entre comillas. Se pueden separar varios comandos con punto y coma. (Si tiene una lista larga de comandos, puede ser más fácil colocarlos en un script y, a continuación, usar la opción -c con el comando $<, $, $><><, $, $$>< (Ejecutar archivo de script).

Si va a iniciar un cliente de depuración, este comando debe estar diseñado para el servidor de depuración. No se permiten comandos específicos del cliente, como .lsrcpath.

-clines lineas
Establece el número aproximado de comandos en el historial de comandos al que se puede acceder durante la depuración remota. Para obtener más información y otras formas de cambiar este número, consulte Uso de comandos del depurador.

-d
(solo en modo kernel) Después de un reinicio, el depurador se dividirá en el equipo de destino tan pronto como se cargue un módulo de kernel. (Este salto es anterior a la interrupción de la opción -b ). Consulte Bloqueo y reinicio del equipo de destino para obtener más información y otros métodos para cambiar este estado.

-ee {masm|c++}
Establece el evaluador de expresiones predeterminado. Si se especifica masm , se usará la sintaxis de expresión MASM. Si se especifica c++ , se usará la sintaxis de expresión de C++. Si se omite la opción -ee , se usa la sintaxis de expresión MASM como valor predeterminado. Consulte Evaluación de expresiones para obtener más información.

-failinc
Hace que el depurador omita los símbolos interrogables. Al depurar un archivo minidump en modo de usuario o en modo kernel, esta opción también impedirá que el depurador cargue los módulos cuyas imágenes no se puedan asignar. Para obtener más información y otros métodos para controlar esto, consulte SYMOPT_EXACT_SYMBOLS.

-g
(Solo modo de usuario) Omite el punto de interrupción inicial en la aplicación de destino. Esta opción hará que la aplicación de destino continúe ejecutándose después de que se inicie o WinDbg se adjunte a ella, a menos que se haya establecido otro punto de interrupción. Consulte Punto de interrupción inicial para obtener más información.

-G
(Solo modo de usuario) Omite el punto de interrupción final en la finalización del proceso. Normalmente, la sesión de depuración finaliza durante el proceso de degradación de la imagen. Esta opción hará que la sesión de depuración finalice inmediatamente cuando finalice el elemento secundario. Esto tiene el mismo efecto que escribir el comando sxd epr. Para obtener más información, vea Controlar excepciones y eventos.

-disco duro
(Solo modo de usuario) Especifica que no se debe usar el montón de depuración.

-I[S]
Instala WinDbg como depurador postmortem. Para obtener más información, consulte Habilitación de la depuración postmortem.

Después de intentar esta acción, se muestra un mensaje correcto o de error. Si se incluye S , este procedimiento se realiza de forma silenciosa si se realiza correctamente; solo se muestran los mensajes de error.

El parámetro -I no se debe usar con ningún otro parámetro. Este comando no iniciará realmente WinDbg, aunque puede aparecer una ventana de WinDbg durante un momento.

-IA[S]
Asocia WinDbg con las extensiones de archivo .dmp, .mdmp y .wew en el Registro. Después de intentar esta acción, se muestra un mensaje correcto o de error. Si se incluye S , este procedimiento se realiza de forma silenciosa si se realiza correctamente; solo se muestran los mensajes de error. Una vez realizada esta asociación, al seleccionar y mantener (o hacer clic con el botón derecho) un archivo con una de estas extensiones iniciará WinDbg.

El parámetro -IA no se debe usar con ningún otro parámetro. Este comando no iniciará realmente WinDbg, aunque puede aparecer una ventana de WinDbg durante un momento.

-IU KeyString
Registra la comunicación remota del depurador como un tipo de dirección URL para que los usuarios puedan iniciar automáticamente un cliente remoto del depurador con una dirección URL. KeyString tiene el formato remdbgeng://RemotingOption. RemotingOption es una cadena que define el protocolo de transporte tal como se define en el tema Activación de un cliente de depuración. Si esta acción se realiza correctamente, no se muestra ningún mensaje; si se produce un error, se muestra un mensaje de error.

El parámetro -IU no debe usarse con ningún otro parámetro. Aunque una ventana de WinDbg puede aparecer por un momento, este comando no iniciará realmente WinDbg.

-Yo ImagePath
Especifica la ubicación de los ejecutables que generaron el error. Si la ruta de acceso contiene espacios, debe incluirse entre comillas.

-j
Permitir el registro en diario.

-k [ConnectType]
(solo en modo kernel) Inicia una sesión de depuración del kernel. Para obtener más información, consulte Depuración en modo kernel en vivo mediante WinDbg (clásico). Si se usa -k sin ninguna opción connectType que la siga, debe ser la entrada final en la línea de comandos.

-Kl
(solo en modo kernel) Inicia una sesión de depuración de kernel en la misma máquina que el depurador.

-kx ExdiOptions
(solo en modo kernel) 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.

-log{o|a} LogFile
Comienza a registrar información en un archivo de registro. Si el archivo de registro especificado ya existe, se sobrescribirá si se usa -logo . Si se usa loga , la salida se anexará al archivo. Para obtener más información, consulta Mantener un archivo de registro en WinDbg.

-lsrcpath
Establece la ruta de acceso de origen local para un cliente remoto. Esta opción debe seguir -remote en la línea de comandos.

-n
Carga de símbolos ruidosos: habilita la salida detallada del controlador de símbolos. Para obtener más información y otros métodos de control, consulte SYMOPT_DEBUG.

-noinh
(Solo modo de usuario) Impide que los procesos creados por el depurador hereden identificadores del depurador. Para obtener otros métodos para controlar esto, consulte Depuración de un proceso en modo de usuario mediante WinDbg.

-noprio
Impide cualquier cambio de prioridad. Este parámetro impedirá que WinDbg tenga prioridad durante el tiempo de CPU mientras está activo.

-noshell
Prohíbe todos los comandos .shell . Esta prohibición durará siempre que se ejecute el depurador, incluso si se inicia una nueva sesión de depuración. Para obtener más información y otras formas de deshabilitar los comandos de shell, consulte Uso de comandos de Shell.

-o
(Solo modo de usuario) Depura todos los procesos iniciados por la aplicación de destino (procesos secundarios). De forma predeterminada, los procesos creados por la depuración se ejecutarán como lo hacen normalmente.

-openPrivateDumpByHandle Asa
Especifica el identificador de un archivo de volcado de memoria que se va a depurar.

-p PID
Especifica el identificador de proceso decimal que se va a depurar. Se usa para depurar un proceso que ya se está ejecutando.

-Pb
(Solo modo de usuario) Impide que el depurador solicite un salto inicial al asociarse a un proceso de destino. Esto puede ser útil si la aplicación ya está suspendida o si desea evitar la creación de un subproceso de interrupción en el destino.

-Pd
(Solo modo de usuario) Hace que la aplicación de destino no finalice al final de la sesión de depuración. Consulta Finalizar una sesión de depuración en WinDbg (clásico) para obtener más información.

-pei
(Solo modo de usuario) Indica que la aplicación de destino ya se está depurando. Consulte Volver a asociar a la aplicación de destino para obtener más información.

-Pn Nombre
Especifica el nombre del proceso que se va a depurar. (Este nombre debe ser único). Se usa para depurar un proceso que ya se está ejecutando.

-Pr
(Solo modo de usuario) Hace que el depurador inicie el proceso de destino en ejecución cuando se asocia a él. Esto puede ser útil si la aplicación ya está suspendida y desea reanudar la ejecución.

-Psn ServiceName
Especifica el nombre de un servicio contenido en el proceso que se va a depurar. Se usa para depurar un proceso que ya se está ejecutando.

-Pt Sobras
Especifica el tiempo de espera de interrupción, en segundos. El valor predeterminado es 30. Consulte Controlar el destino para obtener más información.

-Pv
(Solo modo de usuario) Especifica que el depurador debe asociarse al proceso de destino de forma novasiva. Para obtener más información, consulte Depuración novasiva (modo de usuario).

-Q
Suprime el cuadro de diálogo "Guardar área de trabajo?". Las áreas de trabajo no se guardan automáticamente. Consulte Uso de áreas de trabajo: WinDbg (clásico) para obtener más información.

-QS
Suprime el cuadro de diálogo "Volver a cargar origen?" Los archivos de origen no se vuelven a cargar automáticamente.

-QSY
Suprime el cuadro de diálogo "Volver a cargar el origen?" y vuelve a cargar automáticamente los archivos de origen.

-QY
Suprime el cuadro de diálogo "Guardar área de trabajo?" y guarda automáticamente las áreas de trabajo. Consulte Uso de áreas de trabajo: WinDbg (clásico) para obtener más información.

-robp
Esto permite a CDB establecer un punto de interrupción en una página de memoria de solo lectura. (El valor predeterminado es para que se produzca un error en dicha operación).

-sdce
Hace que el depurador muestre los mensajes de error de acceso a archivos durante la carga de símbolos. Para obtener más información y otros métodos de control, consulte SYMOPT_FAIL_CRITICAL_ERRORS.

-seguro
Activa el modo seguro.

-Ses
Hace que el depurador realice una evaluación estricta de todos los archivos de símbolos y omita los símbolos interrogables. Para obtener más información y otros métodos para controlar esto, consulte SYMOPT_EXACT_SYMBOLS.

-sflags 0x Número
Establece todas las opciones del controlador de símbolos a la vez. Number debe ser un número hexadecimal con el prefijo 0x : se permite un decimal sin el 0x , pero las opciones de símbolo son marcas binarias y, por tanto, se recomienda hexadecimal. Esta opción se debe usar con cuidado, ya que invalidará todos los valores predeterminados del controlador de símbolos. Para obtener más información, consulte Configuración de opciones de símbolos.

-sicv
Hace que el controlador de símbolos ignore el registro CV. Para obtener más información y otros métodos de control, consulte SYMOPT_IGNORE_CVREC.

-Pecados
Hace que el depurador omita la ruta de acceso de símbolo y las variables de entorno de ruta de acceso de la imagen ejecutable. Para obtener más información, consulte SYMOPT_IGNORE_NT_SYMPATH.

-snc
Hace que el depurador desactive la traducción de C++. Para obtener más información y otros métodos de control, consulte SYMOPT_NO_CPP.

-snul
Deshabilita la carga automática de símbolos para nombres no calificados. Para obtener más información y otros métodos de control, consulte SYMOPT_NO_UNQUALIFIED_LOADS.

-srcpath SourcePath
Especifica la ruta de búsqueda del archivo de origen. 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 origen.

-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. Para obtener más información y otros métodos de control, consulte SYMOPT_AUTO_PUBLICS.

-T Título
Establece el título de la ventana winDbg.

-v
Habilita la salida detallada del depurador.

-W Área de trabajo
Carga el área de trabajo con nombre especificada. Si el nombre del área de trabajo contiene espacios, escríbalo entre comillas. Si no existe ningún área de trabajo de este nombre, se le dará la opción de crear una nueva área de trabajo con este nombre o abandonar el intento de carga. Para obtener más información, consulte Uso de áreas de trabajo: WinDbg (clásico).

-WF Nombre
Carga el área de trabajo desde el archivo especificado. El nombre de archivo debe incluir el archivo y la extensión (normalmente .wew). Si el nombre del área de trabajo contiene espacios, escríbalo entre comillas. Si no existe ningún archivo de área de trabajo con este nombre, se le dará la opción de crear un nuevo archivo de área de trabajo con este nombre o abandonar el intento de carga. Para obtener más información, consulte Uso de áreas de trabajo: WinDbg (clásico).

-WX
Deshabilita la carga automática del área de trabajo. Para obtener más información, consulte Uso de áreas de trabajo: WinDbg (clásico).

-y SymbolPath
Especifica la ruta de acceso de búsqueda de símbolos. 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.

-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. Es posible abrir varios archivos de volcado a la vez mediante la inclusión de varias opciones -z, cada una seguida de un valor DumpFile diferente. Para obtener más información, consulta Analizar un archivo de volcado en modo de usuario o Analizar un archivo de volcado en modo kernel con WinDbg.

-zp PageFile
Especifica el nombre de un archivo de página modificado. Esto resulta útil si está depurando un archivo de volcado de memoria y desea usar el comando .pagein (Page In Memory). No se puede usar -zp con un archivo de página estándar de Windows; solo se pueden usar archivos de página modificados especialmente.

ejecutable
Especifica la línea de comandos de un proceso ejecutable. Se usa para iniciar un nuevo proceso y depurarlo. Debe ser el elemento final de la línea de comandos. Todo el texto después de pasar el nombre del archivo ejecutable al ejecutable como cadena de argumento. Para obtener más información, consulte Depuración de un proceso en modo de usuario mediante WinDbg.

-?
Abre esta ventana de ayuda HTML.

Cuando ejecute el depurador desde la línea de comandos, especifique argumentos para la aplicación de destino después del nombre de archivo de la aplicación. Por ejemplo:

windbg myexe arg1 arg2