.server (Criar servidor de depuração)
O comando .server inicia um servidor de depuração, permitindo uma conexão remota com a sessão de depuração atual.
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 Considerações de segurança para ferramentas de depuração do Windows.
Métodos de conexão recomendados, com alguns de segurança adicionais
.server spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password]
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password]
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password]
Métodos de conexão não seguros
.server npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable]
.server tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable]
.server tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6]
.server com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password]
Parâmetros
PipeName
Quando o protocolo NPIPE ou SPIPE é usado, PipeName é uma cadeia de caracteres que servirá como o nome do pipe. Cada nome de pipe deve identificar um servidor de depuração exclusivo. Se você tentar reutilizar um nome de pipe, receberá uma mensagem de erro.
PipeName não deve conter espaços ou aspas.
PipeName pode incluir um código numérico de formato printf-style, como %x ou %d. O depurador substituirá isso pela ID do processo do depurador. Um segundo código desse tipo será substituído pelo ID do thread do depurador.
Soquete
Quando o protocolo TCP ou SSL é usado, Socket é o número da porta do soquete.
Também é possível especificar um intervalo de portas separadas por dois pontos. O depurador verificará cada porta neste intervalo para ver se está livre. Se encontrar uma porta livre e não ocorrer nenhum erro, o servidor de depuração será criado. O cliente de depuração terá que especificar a porta real que está sendo usada para se conectar ao servidor. Para determinar a porta real, use qualquer um dos métodos descritos em Searching for Debugging Servers; Quando este servidor de depuração é exibido, a porta será seguida por dois números separados por dois pontos. O primeiro número será a porta real utilizada; o segundo pode ser ignorado. Por exemplo, se a porta foi especificada como port=51:60 e a porta 53 foi realmente usada, os resultados da pesquisa mostrarão "port=53:60". (Se você estiver usando o parâmetro clicon para estabelecer uma conexão reversa, o cliente de depuração poderá especificar um intervalo de portas dessa maneira, enquanto o servidor deverá especificar a porta real usada.)
clicon= Cliente
Quando o protocolo TCP ou SSL é usado e o parâmetro \\) são opcionais.
Quando clicon é usado, é melhor iniciar o cliente de depuração antes que o servidor de depuração seja criado, embora a ordem usual (servidor antes do cliente) também seja permitida. Um servidor de conexão reversa não aparecerá quando outro depurador exibir todos os servidores ativos.
COMPort
Quando o protocolo COM é usado, COMPort especifica a porta COM a ser usada. O prefixo COM é opcional (por exemplo, "com2" e "2" são aceitáveis).
BaudRate
Quando o protocolo COM é usado, BaudRate especifica a taxa de transmissão na qual a conexão será executada. Qualquer taxa de transmissão suportada pelo hardware é permitida.
COMChannel
Se o protocolo COM for usado, COMChannel especifica o canal COM a ser usado na comunicação com o cliente de depuração. Pode ser qualquer valor entre 0 e 254, inclusive.
Protocolo
Se o protocolo SSL ou SPIPE for usado, protocolo especifica o protocolo Secure Channel (S-Channel). Pode ser qualquer uma das strings tls1, pct1, ssl2 ou ssl3.
Cert
Se o protocolo SSL ou SPIPE for usado, Cert especifica o certificado. Pode ser o nome do certificado ou a impressão digital do certificado (a cadeia de dígitos hexadecimais fornecida pelo snapin do certificado). Se a sintaxe certuser=Cert for usada, o depurador procurará o certificado no armazenamento do sistema (o repositório padrão). Se a sintaxe machuser=Cert for usada, o depurador procurará o certificado no armazenamento da máquina. O certificado especificado deve oferecer suporte à autenticação do servidor.
escondido
Impede que o servidor apareça quando outro depurador exibe todos os servidores ativos.
password=Password
Requer um cliente de depuração para fornecer a senha especificada para se conectar à sessão de depuração.
de senha pode ser qualquer cadeia alfanumérica, com até doze caracteres.
ipversion=6
(Somente Ferramentas de Depuração para Windows 6.6.07 e versões anteriores) Força o depurador a usar IP versão 6 em vez de versão 4 ao usar TCP para se conectar à Internet. No Windows Vista e versões posteriores, o depurador tenta definir automaticamente o padrão para IP versão 6, tornando essa opção desnecessária.
IcfEnable
Faz com que o depurador habilite as conexões de porta necessárias para comunicação TCP ou pipe nomeado quando o Firewall de Conexão com a Internet estiver ativo. Por padrão, o Firewall de Conexão com a Internet desativa as portas usadas por esses protocolos. Quando IcfEnable é usado com uma conexão TCP, o depurador faz com que o Windows abra a porta especificada pelo parâmetro Socket. Quando IcfEnable é usado com uma conexão de pipe nomeado, o depurador faz com que o Windows abra as portas usadas para pipes nomeados (portas 139 e 445). O depurador não fecha essas portas após o término da conexão.
Meio Ambiente
| Número | Descrição |
|---|---|
| Modos | Modo de usuário, modo kernel |
| Objetivos | Ao vivo, despejo de memória |
| Plataformas | Tudo |
Informação Adicional
Para obter detalhes completos sobre como iniciar um servidor de depuração, consulte ativando um servidor de depuração. Para obter exemplos, consulte Exemplos de cliente e servidor.
Comentários
Este comando transforma o depurador atual em um servidor de depuração. Isso permite que você inicie o servidor depois que o depurador já estiver em execução, enquanto a opção de linha de comando -server só pode ser emitida quando o depurador for iniciado.
Isso permite que um cliente de depuração se conecte à sessão de depuração atual. Observe que é possível iniciar vários servidores usando diferentes opções, permitindo que diferentes tipos de clientes de depuração participem da sessão.
Importante
Usar uma senha com protocolo TCP, NPIPE ou COM oferece apenas uma pequena quantidade de proteção, porque a senha não é criptografada. Quando utiliza uma palavra-passe juntamente com um protocolo SSL ou SPIPE, a palavra-passe é encriptada. Se você quiser estabelecer uma sessão remota segura, você deve usar o protocolo SSL ou SPIPE .