Depuração remota usando WinDbg

A depuração remota permite depurar o código em execução em um computador diferente. Este guia mostra como configurar um servidor de depuração e conectar um cliente de depuração para controlar a sessão de depuração remotamente. Você aprenderá as etapas exatas para configurar ambos os componentes.

O código que você está depurando pode ser executado no mesmo computador que o servidor de depuração ou pode ser executado em um computador separado. Se o servidor de depuração executar a depuração no modo de usuário, o processo que você está depurando poderá ser executado no mesmo computador que o servidor de depuração. Se o servidor de depuração executar a depuração no modo kernel, o código que você está depurando normalmente será executado em um computador de destino separado.

Este diagrama mostra como os três computadores funcionam juntos em uma configuração típica de depuração remota:

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

1. No computador host, abra o WinDbg e estabeleça uma sessão de depuração no modo kernel com um computador de destino. (Veja Depuração no modo kernel ao vivo usando WinDbg (clássico).)

2. Interrompa escolhendo Interromperno menu Depurar ou pressionando CTRL-Break.

3. Na janela de comando do depurador, insira o comando a seguir.

   .server tcp:porta=5005

   Observação

   O número da porta 5005 é arbitrário. Você escolhe o número da porta.

4. O WinDbg responde com uma saída semelhante à seguinte. Copie a cadeia de conexão, você precisará dela para a próxima etapa.

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

5. No computador remoto, abra o WinDbg e escolha Conectar à Sessão Remota no menu Arquivo.

6. Em Cadeia de Conexão, insira a cadeia de caracteres a seguir.

   tcp:Port=5005,Server=YourHostComputer

   onde YourHostComputer é o nome do seu computador host, que executa o servidor de depuração.

   Selecione OK.

Usando a linha de comando

Como alternativa ao procedimento na seção anterior, você pode configurar uma sessão de depuração remota na linha de comando. Suponha que você deseja estabelecer uma sessão de depuração em modo kernel entre um computador host e um computador de destino via cabo 1394 no canal 32. Use o procedimento a seguir para estabelecer uma sessão de depuração remota:

1. No computador host, digite o seguinte comando em uma janela do Prompt de Comando.

   windbg -servidor tcp:porta=5005 -k 1394:canal=32

2. Aguarde até que o servidor seja iniciado. Você verá uma mensagem de confirmação com os detalhes da conexão. Copie essa cadeia de conexão antes de prosseguir para a etapa 3.

3. No computador remoto, digite o seguinte comando em uma janela do Prompt de Comando.

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

   onde YourHostComputer é o nome do seu computador anfitrião, que executa o servidor de depuração.

Próximas etapas

Você pode estabelecer a depuração remota de várias maneiras diferentes daquelas mostradas neste tópico.

• Para obter informações completas sobre como configurar um servidor de depuração na janela de comando do depurador WinDbg, consulte .server (Criar servidor de depuração).
• Para obter informações completas sobre como iniciar o WinDbg (e estabelecer a depuração remota) na linha de comando, consulte Opções de linha de comando do WinDbg.