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 cliente de depuração, controla a sessão de depuração a partir 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ê gostaria de envolver outra pessoa na análise de um problema, que você está depurando em um PC.

O código que está sendo depurado pode estar sendo executado no mesmo computador que está executando o servidor de depuração ou pode estar sendo executado 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 depuração em modo kernel de 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 COM Port. Suponha que você tenha escolhido usar TCP como o protocolo e tenha escolhido usar o 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 de depuração remota em modo kernel:

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

2. Invada pressionando CRTL-Break.

3. Digite o seguinte comando.

   TCP .server:porta=5005

   Nota O número da porta 5005 é arbitrário. O número da porta é a sua escolha.

4. O KD responderá com 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 de Prompt de Comando e digite o seguinte comando.

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

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

Informação Adicional

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