Compartilhar via


Iniciando uma sessão de Remote.exe

Há duas maneiras de iniciar uma sessão remote.exe com KD ou CDB. Somente o segundo desses métodos funciona com NTSD.

Personalizando a janela do prompt de comando

O cliente Remote.exe e o servidor Remote.exe são executados nas janelas do Prompt de Comando.

Para se preparar para a sessão remota, você deve personalizar essa janela para aumentar sua usabilidade. Abra uma janela de Prompt de Comando. Clique com o botão direito do mouse na barra de título e selecione Propriedades. Selecione a guia Layout . Vá para a seção intitulada "Tamanho do Buffer de Tela" e digite 90 na caixa Largura e um valor entre 4000 e 9999 na caixa Altura . Isso permite barras de rolagem na sessão remota no depurador de kernel.

Altere os valores para a altura e a largura da seção "Tamanho do Windows" se você quiser alterar a forma do prompt de comando. Selecione a guia Opções . Habilite o modo quickedit Opções de Edição e o modo de inserção. Isso permite recortar e colar informações na sessão do prompt de comando. Clique em OK para aplicar as alterações. Selecione a opção para aplicar as alterações a todas as sessões futuras quando solicitado.

Iniciando o Remote.exe Server: First Method

A sintaxe geral para iniciar um servidor Remote.exe é a seguinte:

remote /s "Command_Line" Unique_Id [/f Foreground_Color] [/b Background_Color] 

Isso pode ser usado para iniciar KD ou CDB no computador remoto, como nos seguintes exemplos:

remote /s "KD [options]" MyBrokenBox 

remote /s "CDB [options]" MyBrokenApp 

Isso inicia o servidor Remote.exe na janela prompt de comando e inicia o depurador.

Você não pode usar esse método para iniciar o NTSD diretamente, porque o processo NTSD é executado em uma janela diferente daquela em que ele foi invocado.

Iniciando o Remote.exe Server: Segundo Método

Há um método alternativo que pode iniciar um servidor Remote.exe. Esse método envolve primeiro iniciar o depurador e, em seguida, usar o comando .remote (Criar Remote.exe Servidor) para iniciar o servidor.

Como o comando .remote é emitido depois que o depurador é iniciado, esse método funciona igualmente bem com KD, CDB e NTSD.

Veja um exemplo. Primeiro, inicie o depurador da maneira normal:

KD [options] 

Depois que o depurador estiver em execução, use o comando .remote :

.remote MyBrokenBox 

Isso resulta em um processo de KD que também é um servidor Remote.exe com uma ID de "MyBrokenBox", exatamente como no primeiro método.

Uma vantagem desse método é que você não precisa decidir com antecedência se pretende usar a depuração remota. Se você estiver depurando com um dos depuradores de console e decidir que prefere que alguém em um local remoto assuma o controle, poderá usar o comando .remote e, em seguida, eles poderão se conectar à sua sessão.

Iniciando o cliente Remote.exe

A sintaxe geral para iniciar um cliente Remote.exe é a seguinte:

remote /c ServerNetBIOSName Unique_ID [/l Lines_to_Get] [/f Foreground_Color] [/b Background_Color] 
```dbgcmd

For example, if the "MyBrokenBox" session, described above, was started on a local host computer whose network name was "Server2", you can connect to it with the command:

```console
remote /c server2 MyBrokenBox 

Qualquer pessoa na rede com a permissão apropriada pode se conectar a essa sessão de depuração, desde que saiba o nome do computador e a ID da sessão.

Emitindo comandos

Os comandos são emitidos por meio do cliente Remote.exe e são enviados para o servidor Remote.exe. Você pode inserir qualquer comando no cliente como se estivesse inserindo-o diretamente no depurador.

Para sair da sessão de remote.exe no Cliente Remote.exe, insira o comando @Q . Isso deixa o servidor Remote.exe e o depurador em execução.

Para encerrar a sessão do servidor, insira o comando @K no servidor Remote.exe.