Ativando um cliente inteligente (modo Kernel)
Depois que o servidor de conexão KD tiver sido ativado, você poderá criar um cliente inteligente em outro computador e iniciar uma sessão de depuração.
Há duas maneiras de iniciar um cliente inteligente: iniciando KD ou WinDbg com o protocolo kernel kdsrv ou usando a interface gráfica WinDbg.
Você precisa especificar o protocolo de transferência remota usado pelo servidor de conexão KD. Você também pode especificar o protocolo para a conexão de kernel real entre o servidor de conexão KD e o computador de destino, ou você pode usar o padrão.
Importante
Há considerações de segurança 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 de depuração remota e considerações de segurança para ferramentas de depuração do Windows.
A sintaxe geral para iniciar um cliente inteligente depende do protocolo usado. As seguintes opções existem:
métodos de conexão recomendados, com alguns de segurança adicionais
Debugger -k kdsrv:server=@{spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]
Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]
Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]
Debugger -k kdsrv:server=@{com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]},trans=@{ConnectType} [Options]
métodos de conexão não seguros
Debugger -k kdsrv:server=@{npipe:server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]
Debugger -k kdsrv:server=@{tcp:server=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]
Debugger -k kdsrv:server=@{tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]
Para usar a interface gráfica para se conectar a um servidor de conexão KD, o WinDbg deve estar no modo inativo . Ele deve ter sido iniciado sem parâmetros de linha de comando ou deve ter terminado a sessão de depuração anterior. Selecione o arquivo | Conecte-se ao comando de menu Stub Remoto. Quando a caixa de diálogo Conectar ao Servidor Stub Remoto for exibida, insira uma das seguintes cadeias de caracteres na cadeia de caracteres Conexão caixa de texto:
métodos de conexão recomendados, com alguns de segurança adicionais
spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]
ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]
ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]
com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
métodos de conexão não seguros
npipe:server=Server,pipe=PipeName[,password=Password]
tcp:server=Server,port=Socket[,password=Password][,ipversion=6]
tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]
Como alternativa, você pode usar o botão procurar
Os parâmetros nos comandos anteriores têm os seguintes valores possíveis:
depurador
Isso pode ser KD ou WinDbg.
do servidor
Esse é o nome da rede ou o endereço IP do computador no qual o servidor de conexão KD foi criado. As duas barras iniciais (\) são opcionais na linha de comando, mas não são permitidas na caixa de diálogo WinDbg.
pipe=PipeName
Se o protocolo NPIPE ou SPIPE for usado, PipeName será o nome fornecido ao pipe quando o servidor de conexão KD foi criado.
Se você não estiver conectado ao computador cliente com uma conta que tenha acesso ao computador do servidor, deverá fornecer um nome de usuário e uma senha. No computador cliente, em uma janela do Prompt de Comando, insira o comando a seguir.
net use \\Server\ipc$ /user:UserName
em que Server é o nome do computador servidor e UserName é o nome de uma conta que tem acesso ao computador servidor.
Quando for solicitado, insira a senha para UserName.
Depois que esse comando for bem-sucedido, você poderá ativar um cliente inteligente usando -k kdsrv ou usando a interface gráfica WinDbg.
Se o protocolo TCP ou SSL for usado, soquete será o mesmo número de porta de soquete que foi usado quando o servidor de conexão KD foi criado.
clicon
Especifica que o servidor de conexão KD tentará se conectar ao cliente inteligente por meio de uma conexão inversa. O cliente deve usar clicon se e somente se o servidor estiver usando clicon. Na maioria dos casos, o cliente inteligente é iniciado antes do servidor de conexão KD quando uma conexão inversa é usada.
porta= COMPort
Se o protocolo COM for usado, COMPort especificar a porta COM a ser usada. O prefixo "COM" é opcional , por exemplo, "com2" e "2" são aceitáveis.
baud= BaudRate
Se o protocolo COM for usado, BaudRate deverá corresponder à taxa de baud escolhida quando o servidor de conexão KD foi criado.
channel= COMChannel
Se o protocolo COM for usado, COMChannel deverá corresponder ao número de canal escolhido quando o servidor de conexão KD foi criado.
Se o protocolo SSL ou SPIPE for usado, Protocolo deverá corresponder ao protocolo seguro usado quando o servidor de conexão KD foi criado.
Cert
Se o protocolo SSL ou SPIPE for usado, você deverá usar o parâmetro certuser=Cert ou machuser=parâmetro Cert usado quando o servidor de conexão KD foi criado.
password=Password
Se uma senha tiver sido usada quando o servidor de conexão KD foi criado, senha deverá ser fornecida para criar o cliente inteligente. Ele deve corresponder à senha original. As senhas diferenciam maiúsculas de minúsculas. Se a senha errada for fornecida, a mensagem de erro especificará "Erro 0x80004005".
ipversion=6
(Ferramentas de depuração para Windows 6.6.07 e somente anteriores) Força o depurador a usar o IP versão 6 em vez da versão 4 ao usar o TCP para se conectar à Internet. No Windows Vista e versões posteriores, o depurador tenta fazer o padrão automático para o IP versão 6, tornando essa opção desnecessária.
trans=@{ConnectType}
Informa ao depurador como se conectar ao destino. Os seguintes protocolos de conexão de kernel são permitidos:
com:port=ComPort,baud=BaudRate
usb2:targetname=String
com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]
com:modem
Para obter informações sobre esses protocolos, consulte Getting Configur Up for Debugging. Você pode omitir qualquer um dos parâmetros para esses protocolos , por exemplo, você pode dizer trans=@{com:} -- e o depurador usará como padrão os valores especificados pelas variáveis de ambiente no computador em que o KdSrv está em execução.
opções de
Quaisquer parâmetros de linha de comando adicionais podem ser colocados aqui. Consulte Command-Line Opções para obter uma lista completa.
Como o servidor de conexão KD simplesmente atua como um gateway para o cliente inteligente, as opções de adicionais serão as mesmas que você usaria se estivesse iniciando um depurador de kernel no computador em que o KdSrv está em execução. A exceção a isso é qualquer opção que especifique que um caminho ou nome de arquivo será tomado como um caminho no computador em que o cliente inteligente está em execução.