Depuração remota usando KD

A depuração remota envolve dois depuradores em execução em dois locais diferentes. O depurador que executa a depuração é chamado de servidor de depuração. O segundo depurador, chamado de cliente de depuração, controla a sessão de depuração de um local remoto. Para estabelecer uma sessão remota, você deve configurar o servidor de depuração primeiro e, em seguida, ativar o cliente de depuração.

A depuração remota pode ser útil quando você deseja envolver outra pessoa ao examinar um problema, que você está depurando em um computador.

O código que está sendo depurado pode estar em execução no mesmo computador que está executando o servidor de depuração ou pode estar em execução em um computador separado. Se o servidor de depuração estiver executando a depuração no modo de usuário, o processo que está sendo depurado poderá ser executado no mesmo computador que o servidor de depuração. Se o servidor de depuração estiver executando a depuração no modo kernel, o código que está sendo depurado normalmente será executado em um computador de destino separado.

O diagrama a seguir ilustra uma sessão remota em que o servidor de depuração, em execução em um computador host, está executando a depuração no modo kernel do código que está sendo executado em um computador de destino separado.

Há vários protocolos de transporte que você pode usar para uma conexão de depuração remota: TCP, NPIPE, SPIPE, SSL e porta COM. Suponha que você tenha optado por usar tcp como o protocolo e optou por usar KD como o cliente de depuração e o servidor de depuração. Você pode usar o procedimento a seguir para estabelecer uma sessão remota de depuração em modo kernel:

1. No computador host, abra o KD e estabeleça uma sessão de depuração no modo kernel com um computador de destino. (Consulte a realização da depuração Kernel-Mode usando KD.)

2. Interrompa pressionando CRTL-Break.

3. Insira o comando a seguir.

   .server tcp:porta=5005

   Observação O número da porta 5005 é arbitrário. O número da porta é sua escolha.

4. O KD fornecerá um resultado semelhante ao seguinte.

   Server started.  Client can connect with any of these command lines
   0: <debugger> -remote tcp:Port=5005,Server=YourHostComputer
   

5. No computador remoto, abra uma janela do Prompt de Comando e insira o comando a seguir.

   kd -remote tcp:Port=5005,Server=YourHostComputer

   onde YourHostComputer é o nome do computador host, que está executando o servidor de depuração.

Informações adicionais

Para obter informações completas sobre como iniciar o KD (e estabelecer a depuração remota) na linha de comando, consulte KD Command-Line Options.