Partilhar via


Controlando uma sessão de depuração remota

Uma vez iniciada a sessão remota, os comandos podem ser inseridos no servidor de depuração ou no cliente de depuração. Se houver vários clientes, qualquer um deles pode inserir comandos. Uma vez que ENTER é pressionado, o comando é transmitido para o servidor de depuração e executado.

Sempre que um usuário insere um comando, todos os usuários verão o próprio comando e sua saída. Se esse comando foi emitido a partir de um cliente de depuração, todos os outros usuários verão uma identificação, precedendo o comando, de qual usuário emitiu o comando. Os comandos emitidos a partir do servidor de depuração não têm esse prefixo.

Depois que um comando é executado por um usuário, outros usuários que estão conectados através do KD ou CDB não verão um novo prompt de comando. Por outro lado, os usuários do WinDbg verão o prompt no painel inferior da janela de comando do depurador continuamente, mesmo quando o mecanismo do depurador estiver em execução. Nenhuma destas situações deve ser motivo de alarme; Qualquer usuário pode inserir um comando a qualquer momento, e o mecanismo executará esses comandos na ordem em que foram recebidos.

As ações feitas através da interface WinDbg também serão executadas pelo servidor de depuração.

comunicação entre utilizadores

Sempre que um novo cliente de depuração se conectar à sessão, todos os outros usuários verão uma mensagem informando que esse cliente se conectou. Nenhuma mensagem é exibida quando um cliente se desconecta.

O comando .clients (List Debugging Clients) listará todos os clientes atualmente conectados à sessão de depuração.

O comando .echo (Echo Comment) é útil para enviar mensagens de um usuário para outro.

Áreas de Trabalho WinDbg

Quando o WinDbg está sendo usado como um cliente de depuração, seu espaço de trabalho salvará apenas os valores definidos através da interface gráfica. As alterações feitas através da janela de comando do depurador não serão salvas. (Isso garante que apenas as alterações feitas pelo cliente local serão refletidas, uma vez que a janela Comando do Depurador aceitará entradas de todos os clientes, bem como do servidor de depuração.)

caminhos de arquivo

O caminho do símbolo, o caminho da imagem executável e o caminho da DLL de extensão são interpretados como caminhos de arquivo relativos à pasta de instalação das Ferramentas de Depuração para Windows no servidor de depuração.

Quando o WinDbg é usado como um cliente de depuração, ele também tem seu próprio caminho de origem local . Todos os comandos relacionados ao código-fonte acessarão os arquivos de origem no computador local. Portanto, os caminhos adequados devem ser definidos em qualquer cliente ou servidor que usará comandos de origem.

Esse sistema de vários caminhos permite que um cliente de depuração use comandos relacionados ao código-fonte sem realmente compartilhar os arquivos de origem com outros clientes ou com o servidor. Isso é útil se houver arquivos de origem privados ou confidenciais aos quais um dos usuários tenha acesso.

Cancelar o servidor de depuração

O comando .endsrv (End Debugging Server) pode ser usado para encerrar um servidor de depuração. Se o depurador tiver estabelecido vários servidores de depuração, você poderá cancelar alguns deles enquanto deixa outros em execução.

Encerrar um servidor impedirá que futuros clientes se conectem a ele. Ele não cortará nenhum cliente que esteja atualmente conectado através do servidor.

Sair do depurador e encerrar a sessão

Para sair de um cliente de depuração sem encerrar o servidor, deverá emitir um comando a partir desse cliente específico. Se este cliente for KD ou CDB, use a tecla CTRL+B para sair. Se você estiver usando um script para executar KD ou CDB, use .remote_exit (Exit Debugging Client). Se este cliente for o WinDbg, escolha Sair no menu Arquivo para sair.

Para encerrar toda a sessão e sair do servidor de depuração, use o comando q (Quit). Este comando pode ser inserido a partir de qualquer servidor ou cliente e encerrará toda a sessão para todos os usuários.

Importante

Há considerações de segurança adicionais importantes ao usar a depuração remota, para obter mais informações, incluindo informações sobre como habilitar o modo seguro, consulte Segurança durante a depuração remota e Considerações de segurança para ferramentas de depuração do Windows.