Opciones de Command-Line winDbg

Los usuarios de WinDbg deben comenzar por primera vez 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 descripciones de 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

-server ServerTransport
Crea un servidor de depuración al que pueden acceder otros depuradores. Para obtener una explicación de los posibles valores serverTransport , consulte Activación de un servidor de depuración. Cuando se usa este parámetro, debe ser el primer parámetro de la línea de comandos.

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

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

-aExtensió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 ir 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 pensado para el servidor de depuración. No se permiten comandos específicos del cliente, como .lsrcpath.

-clineslines
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 para ver otras formas de cambiar este número, consulte Uso de comandos del depurador.

-d
(solo modo kernel) Después de un reinicio, el depurador se dividirá en el equipo de destino en cuanto 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 minivolcado en modo de usuario o modo kernel, esta opción también impedirá que el depurador cargue los módulos cuyas imágenes no se pueden asignar. Para más información y para otros métodos de control, consulte SYMOPT_EXACT_SYMBOLS.

-G
(Solo modo 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 iniciarla 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 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.

-Hd
(Solo modo 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 de operación correcta 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 una ventana de WinDbg puede aparecer 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 de operación correcta 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, 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 una ventana de WinDbg puede aparecer durante un momento.

-IUKeyString
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 se debe usar con ningún otro parámetro. Aunque una ventana de WinDbg puede aparecer por un momento, este comando no iniciará realmente WinDbg.

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

-J
Permitir el registro en diario.

-k [ConnectType]
(solo modo kernel) Inicia una sesión de depuración del kernel. Para obtener más información, consulte Live Kernel-Mode Debugging Using WinDbg (Classic). Si se usa -k sin ninguna opción connectType después, debe ser la entrada final en la línea de comandos.

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

-kxExdiOptions
(solo modo kernel) Inicia una sesión de depuración del kernel mediante un controlador EXDI. Para obtener más información sobre EXDI, vea 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 más información y para otros métodos de control, consulte SYMOPT_DEBUG.

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

-noprio
Evita cualquier cambio de prioridad. Este parámetro impedirá que WinDbg tome 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 comandos de shell, consulte Uso de comandos de Shell.

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

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

-pPID
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 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 crear un subproceso de interrupción en el destino.

-Pd
(Solo modo 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.

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

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

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

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

-Pv
(Solo modo 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 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 al archivo durante la carga de símbolos. Para más información y para 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 más información y para otros métodos de control, consulte SYMOPT_EXACT_SYMBOLS.

-sflags 0xNumber
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 lo tanto, se recomienda hexadecimal. Esta opción debe usarse 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 más información y para 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 imagen ejecutables. Para más información, consulte SYMOPT_IGNORE_NT_SYMPATH.

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

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

-srcpathSourcePath
Especifica la ruta de acceso de búsqueda del archivo de origen. 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, 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 más información y para otros métodos de control, consulte SYMOPT_AUTO_PUBLICS.

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

-V
Habilita la salida detallada del depurador.

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

-WFNombre de archivo
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).

-ySymbolPath
Especifica la ruta de acceso de búsqueda de símbolos. 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, consulte Ruta de acceso de símbolos.

-zDumpFile
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, consulte Análisis de un archivo de volcado de User-Mode o Análisis de un archivo de volcado de Kernel-Mode con WinDbg.

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

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 en la línea de comandos. Todo el texto después de pasar el nombre ejecutable al ejecutable como cadena de argumento. Para obtener más información, consulte Depuración de un proceso de User-Mode 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