Opciones de Command-Line KD

Los usuarios de KD por primera vez deben comenzar con la sección Depuración mediante KD y NTKD .

La línea de comandos KD usa la sintaxis siguiente.

kd [ -server ServerTransport | -remote ClientTransport ] 
   [-b | -x] [-d] [-bonc] [-m] [-myob] [-lines] [-n] [-r] [-s] 
   [-v] [-clines lines] [-failinc] [-noio] [-noshell] 
   [-secure] [-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul]
   [-sup] [-sflags 0xNumber] [-log{a|au|o|ou} LogFile] 
   [-aExtension] [-zp PageFile] 
   [-i ImagePath] [-y SymbolPath]  [-srcpath SourcePath] 
   [-k ConnectType | -kl | -kqm | -kx ExdiOptions] [-ee {masm|c++}] 
   [-z DumpFile] [-cf "filename"] [-cfr "filename"] [-c "command"] 
   [-t PrintErrorLevel] [-version] 

kd -iu KeyString

kd -QR Server 

kd -wake PID 

kd -?

A continuación se describen las descripciones de las opciones de la línea de comandos de KD. Solo las opciones -remote y -server distinguen mayúsculas de minúsculas. El guión inicial se puede reemplazar por una barra diagonal (/). Las opciones que no toman parámetros adicionales se pueden concatenar, por lo que kd -r -n -v se puede escribir como kd -rnv.

Si se usa la opción -remote o -server , debe aparecer antes de cualquier otra opción en la 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 del posible 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.

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

-bonc
Si se especifica esta opción, el depurador se dividirá en el destino en cuanto se inicie la sesión. Esto es especialmente útil al conectarse a un servidor de depuración que podría no dividirse actualmente en el destino.

-c "command"
Especifica el comando inicial del depurador que se va a ejecutar en el inicio. Este comando debe estar rodeado de 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.

-cf "filename"
Especifica la ruta de acceso y el nombre de un archivo de script. Este archivo de script se ejecuta en cuanto se inicia el depurador. Si el nombre de archivo contiene espacios, debe ir entre comillas. Si se omite la ruta de acceso, se asume el directorio actual. Si no se usa la opción -cf, el archivo ntsd.ini en el directorio actual se usa como archivo de script. Si el archivo no existe, no se produce ningún error. Para más información, consulte Uso de archivos de script.

-cfr "filename"
Especifica la ruta de acceso y el nombre de un archivo de script. Este archivo de script se ejecuta en cuanto se inicia el depurador y cada vez que se reinicia el destino. Si el nombre de archivo contiene espacios, debe ir entre comillas. Si se omite la ruta de acceso, se asume el directorio actual. Si el archivo no existe, no se produce ningún error. Para más información, consulte Uso de archivos de script.

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

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

-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. Este comando no iniciará realmente KD.

-kConnectType
Indica al depurador cómo conectarse al destino. Para obtener más información, consulte Depuración mediante KD y NTKD.

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

-kqm
Inicia KD en modo silencioso.

-kxExdiOptions
Inicia una sesión de depuración del kernel mediante un controlador EXDI. Los controladores EXDI no se describen en esta documentación. Si tiene una interfaz EXDI para el sondeo de hardware o el simulador de hardware, póngase en contacto con Microsoft para obtener información de depuración.

-Líneas
Habilita la depuración de líneas de origen. Si se omite esta opción, se tendrá que usar el comando .lines (Alternar compatibilidad con líneas de origen) antes de permitir la depuración de origen. Para ver otros métodos de control, consulte SYMOPT_LOAD_LINES.

-log{a|au|o|ou} LogFile
Comienza a registrar información en un archivo de registro. Si LogFile ya existe, se sobrescribirá si se usa -logo o la salida se anexará al archivo si se usa -loga . Las opciones -logau y -logou funcionan de forma similar a -loga y -logo respectivamente, salvo que el archivo de registro es un archivo Unicode. Para obtener más información, consulte Mantener un archivo de registro en KD.

-M
Indica que el puerto serie está conectado a un módem. Indica al depurador que watch para la señal de detección del operador.

-Myob
Si hay un error de coincidencia de versión con dbghelp.dll, el depurador seguirá ejecutándose. (Sin el modificador -myob , esto se considera un error irrecuperable).

Un efecto secundario de esta opción es que la advertencia que aparece normalmente al dividir en el equipo de destino se suprime.

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

-noio
Impide que el servidor de depuración se use para la entrada o salida. La entrada solo se aceptará desde el cliente de depuración (además de cualquier comando inicial o script de comando especificado por la opción de línea de comandos -c ).

Toda la salida se dirigirá al cliente de depuración. Para obtener más información, consulte Activación de un servidor de depuración.

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

-Servidor QR
Enumera todos los servidores de depuración que se ejecutan en el servidor de red especificado. La barra diagonal inversa doble (\\) anterior al servidor es opcional. Consulte Búsqueda de servidores de depuración para obtener más información.

El parámetro -QR no se debe usar con ningún otro parámetro. Este comando no iniciará realmente KD.

-R
Muestra los registros.

-s
Deshabilita la carga diferida de símbolos. Esto ralentizará el inicio del proceso. Para más información y para otros métodos de control, consulte SYMOPT_DEFERRED_LOADS.

-sdce
Hace que el depurador muestre los cuadros de diálogo de error de acceso a archivos 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.

-tPrintErrorLevel
Especifica el nivel de error que hará que el depurador muestre un mensaje de error. Se trata de un número decimal igual a 0, 1, 2 o 3. Los valores se describen de la siguiente manera:

Valor	Constante	Significado
0	Ninguno	No muestre ningún error.
1	ERROR	Mostrar eventos de depuración de nivel de ERROR.
2	MINORERROR	Muestra los eventos de depuración de nivel MINORERROR y ERROR.
3	WARNING	Muestra los eventos de depuración de nivel WARNING, MINORERROR y ERROR.

Este nivel de error solo tiene significado en las compilaciones activadas de Microsoft Windows. El valor predeterminado es 1. Las compilaciones comprobadas estaban disponibles en versiones anteriores de Windows, antes de Windows 10 versión 1803.

-V
Genera mensajes detallados para cargas, cargas diferidas y descargas.

-Versión
Imprime la cadena de versión del depurador.

-wakePID
Hace que el modo de suspensión finalice para el depurador en modo de usuario cuyo identificador de proceso se especifica mediante PID. Este comando debe emitirse en la máquina de destino durante el modo de suspensión. Consulte Control del depurador de User-Mode desde el depurador de kernel para obtener más información.

El parámetro -wake no se debe usar con ningún otro parámetro. Este comando no iniciará realmente KD.

-X
Hace que el depurador se interrumpa cuando se produce una excepción por primera vez, en lugar de permitir que la aplicación o el módulo que provocó el trato de excepción con él. (Igual que -b, excepto con un eb nt inicial! NtGlobalFlag 9; Comando g ).

-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, vea 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 Kernel-Mode con KD.

-zpPageFile
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 especialmente modificados.

-?
Muestra el texto de ayuda de la línea de comandos.

KD detectará automáticamente la plataforma en la que se ejecuta el destino. No es necesario especificar el destino en la línea de comandos de KD. La sintaxis anterior (con el nombre I386KD o IA64KD) está obsoleta.