Configuración automática de la depuración de kernel de red KDNET

  • Artículo
  • Tiempo de lectura: 8 minutos

Herramientas de depuración para Windows admite la depuración del kernel a través de una red. En este tema se describe cómo configurar automáticamente la depuración de red mediante la kdnet.exe de instalación.

El equipo que ejecuta el depurador se denomina equipo hosty el equipo que se está depurando se denomina equipo de destino. El equipo host debe ejecutarse Windows 7 o posterior, y el equipo de destino debe ejecutarse Windows 8 o posterior.

Determinar la dirección IP del equipo host

  1. Confirme que los equipos host y de destino están conectados a un concentrador o conmutador de red mediante un cable de red adecuado.

  2. En el equipo host, abra una ventana del símbolo del sistema y escriba IPConfig para mostrar la configuración de IP.

  3. En la salida del comando, busque la dirección IPv4 del adaptador Ethernet.

...

Ethernet adapter Ethernet:
...

IPv4 Address. . . . . . . . . . . : <YourHostIPAddress>
...

4. Tome nota de la dirección IPv4 del adaptador de red que va a usar para la depuración.

Configurar los equipos host y de destino

Use la utilidad kdnet.exe para configurar automáticamente los valores del depurador en el equipo de destino siguiendo estos pasos.

  1. Confirme que las Windows de depuración están instaladas en el sistema host. Para obtener información sobre cómo descargar e instalar las herramientas del depurador, vea Descargar herramientas de depuración para Windows.

  2. Busque los kdnet.exe y VerifiedNICList.xml archivos. De forma predeterminada, se encuentran aquí.

    C:\Program Files (x86)\Windows Kits\10\Debuggers\x64

    Nota

    En estas instrucciones se da por supuesto que ambos equipos ejecutan una versión de 64 bits de Windows tanto en el destino como en el host. Si ese no es el caso, el mejor enfoque es ejecutar el mismo "valor de bits" de las herramientas en el host en el que se ejecuta el destino. Por ejemplo, si el destino ejecuta una versión de 32 Windows, ejecute una versión de 32 del depurador en el host. Para obtener más información, vea Elegir las herramientas de depuración de 32 o 64 bits.

  3. En el equipo host, copie los dos archivos en un recurso compartido de red o una unidad digital, para que estén disponibles en el equipo de destino.

  4. En el equipo de destino, cree un directorio C:\KDNET y copie los archivos kdnet.exe y VerifiedNICList.xml en ese directorio.

    Importante

    Antes de kdnet.exe para cambiar la información de arranque, es posible que tenga que suspender temporalmente Windows características de seguridad como BitLocker y Arranque seguro en el equipo de prueba. Vuelva a habilitar estas características de seguridad cuando se completen las pruebas y administre correctamente el equipo de prueba, cuando las características de seguridad estén deshabilitadas.

  5. En el equipo de destino, abra una ventana del símbolo del sistema como administrador. Escriba este comando para comprobar que el equipo de destino tiene un adaptador de red compatible.

    C:\KDNET>kdnet.exe
Network debugging is supported on the following NICs:
busparams=1.0.0, Broadcom NetXtreme Gigabit Ethernet, Plugged in.  
This Microsoft hypervisor supports using KDNET in guest VMs.

  6. Como la salida de kdnet.exe indica que se admite el adaptador de red en el destino, podemos continuar.

  7. Escriba este comando para establecer la dirección IP del sistema host y generar una clave de conexión única. Use la dirección IP o el nombre del sistema host. Elija una dirección de puerto única para cada par de destino/host con el que trabaje, dentro del intervalo recomendado de 50000 a 50039.

    C:\>kdnet.exe <HostComputerIPAddress> <YourDebugPort> 

Enabling network debugging on Intel(R) 82577LM Gigabit Network Connection.
Key=2steg4fzbj2sz.23418vzkd4ko3.1g34ou07z4pev.1sp3yo9yz874p

  8. Copie la clave devuelta en un archivo de .txt notas.

Conexión de WinDbg al destino para la depuración del kernel

En el equipo host, abra WinDbg. En el menú Archivo, elija Kernel Debug. En el cuadro de diálogo Depuración de kernel, abra la pestaña Net (Net). Pegue el número de puerto y la clave que guardó en el bloc de notas .txt archivo anterior. Seleccione Aceptar.

También puede iniciar una sesión de WinDbg abriendo una ventana del símbolo del sistema y especificando el siguiente comando, donde YourPort es el puerto que seleccionó anteriormente y YourKey es la clave devuelta por <> kdnet.exe <> anterior. Pegue la clave en la que guardó en en el bloc de notas .txt archivo anterior.

windbg -k -d net:port=<YourDebugPort>,key=<YourKey>

El parámetro -d opcional que se muestra en el ejemplo habilita la interrupción temprana. Para obtener más información, consulta WinDbg Command-Line opciones.

Si se te pide que permitas que WinDbg acceda al puerto a través del firewall, permite que WinDbg acceda al puerto para los tres tipos de red diferentes.

Alerta de seguridad de Windows: el firewall de Windows ha bloqueado algunas características de esta aplicación.

En este momento, el depurador esperará a que el destino se vuelva a conectar y se mostrará texto similar al siguiente en la ventana de comandos del depurador.

Microsoft (R) Windows Debugger Version 1.0.1908.30002 AMD64
Copyright (c) Microsoft Corporation. All rights reserved.

Using NET for debugging
Opened WinSock 2.0
Waiting to reconnect...

Reiniciar el equipo de destino

Una vez que el depurador está en "Esperando volver a conectar..." stage, reinicie el equipo de destino. Una manera de reiniciar el equipo es usar este comando desde el símbolo del sistema de un administrador.

shutdown -r -t 0

Una vez reiniciado el equipo de destino, el depurador debe conectarse automáticamente.

Sugerencias para la solución de problemas

La aplicación de depuración debe permitirse a través del firewall

El depurador debe tener acceso a través del firewall. Use Panel de control para permitir el acceso a través del firewall.

  1. Abra Panel de control Sistema y seguridad y seleccione Permitir una aplicación a través de Windows Firewall.

  2. En la lista de aplicaciones, busque Windows depurador simbólico de GUI y Windows depurador de kernel.

  3. Use las casillas para permitir a esas dos aplicaciones los tres tipos de red diferentes a través del firewall.

  4. Desplácese hacia abajo y seleccione Aceptarpara guardar los cambios del firewall. Reinicie el depurador.

    Configuración del firewall del panel de control de windows Windows el depurador simbólico de gui Windows kernel con los tres tipos de red habilitados.

Uso de Ping para probar la conectividad

Si el depurador tiene tiempo de espera y no se conecta, use el comando ping en el equipo de destino para comprobar la conectividad.

   C:\>Ping <HostComputerIPAddress>

Elegir un puerto para la depuración de red

Si el depurador tiene tiempo de espera y no se conecta, podría deberse a que el número de puerto predeterminado 50000 ya está en uso o está bloqueado.

Puede elegir cualquier número de puerto entre 49152 y 65535. El intervalo recomendado está entre 50000 y 50039. El puerto que elija se abrirá para el acceso exclusivo por el depurador que se ejecuta en el equipo host.

Nota El intervalo de números de puerto que se pueden usar para la depuración de red puede estar limitado por la directiva de red de la empresa. Para determinar si la directiva de su empresa limita el intervalo de puertos que se pueden usar para la depuración de red, consulte con los administradores de red.

Adaptadores de red admitidos

Si se muestra "No se admite la depuración de red en ninguna de las NIC de esta máquina" al ejecutar kdnet.exe, significa que no se admite el adaptador de red.

El equipo host puede usar cualquier adaptador de red, pero el equipo de destino debe usar un adaptador de red compatible con Herramientas de depuración para Windows. Para obtener una lista de adaptadores de red compatibles, consulte NIC Ethernet compatibles para la depuración de kernel de red en Windows 10 y NIC Ethernet compatibles para la depuración de kernel de red en Windows 8.1.

Habilitación de tipos de depuración adicionales

A partir de Windows 10 actualización de octubre de 2020 (20H2), se admiten las siguientes opciones para habilitar cuatro tipos de depuración.

b: habilita la depuración de bootmgr. Para obtener más información, vea BCDEdit /bootdebug.

w: habilita la depuración de winload. Para obtener más información, vea BCDEdit /bootdebug.

h: habilita la depuración del hipervisor. Para obtener más información, vea BCDEdit /hypervisorsettings.

k: habilita la depuración del kernel. Para obtener más información, Tareas iniciales con WinDbg (modo kernel).

Se puede especificar cualquier combinación de tipos de depuración.

Si no se especifica ningún tipo de depuración, se habilitará la depuración del kernel.

Si tanto el hipervisor como la depuración del kernel están habilitados, el puerto del hipervisor se establecerá en el valor port+1.

Ejemplo de uso

Use la opción - b boot para habilitar la depuración de bootmgr, kernel y winload.

C:\>kdnet.exe <HostComputerIPAddress> <YourDebugPort> -bkw

Enabling network debugging on Intel(R) 82577LM Gigabit Network Connection.
Key=2steg4fzbj2sz.23418vzkd4ko3.1g34ou07z4pev.1sp3yo9yz874p

Resumen de las opciones de tipo de depuración

Opción KNDET Descripción Comando set equivalente
b habilita la depuración de bootmgr bcdedit /bootdebug {bootmgr} en
h habilita la depuración del hipervisor bcdedit /set hypervisordebug on
K habilita la depuración del kernel bcdedit /debug on
w habilita la depuración de winload bcdedit /bootdebug en

Especificación de parámetros de bus

Si kdnet no puede determinar automáticamente los parámetros de bus para el transporte, es necesario especificarlos en la línea de comandos con la opción /busparams con esta sintaxis.

kdnet.exe /busparams [b.d.f] [host] [port] [-[b][h][k][w]]

[b.d.f] especifica los parámetros de bus del dispositivo que se va a configurar.

Use Administrador de dispositivos en el equipo de destino para determinar los números de bus, dispositivo y función PCI para el adaptador que desea usar para la depuración. Para los parámetros de bus, escriba b. d. f donde b, dy f son el número de bus, el número de dispositivo y el número de función del adaptador. Estos valores se muestran en Administrador de dispositivos ubicación en la pestaña General.

Por ejemplo:

C:\>kdnet.exe /busparams 0.29.7 <HostComputerIPAddress> <YourDebugPort> -bkw

Nic Ethernet admitidas para la depuración de kernel de red en Windows 10

Nic Ethernet admitidas para la depuración de kernel de red en Windows 8.1

Configuración manual de la depuración de kernel de red KDNET

Tareas iniciales con WinDbg (modo kernel)

Depurar controladores universales: laboratorio paso a paso (modo kernel de eco)