.server (Criar servidor de depuração)
O comando .server inicia um servidor de depuração, permitindo uma conexão remota à sessão de depuração atual.
.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]
.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]
Parâmetros
Nome do Tubo
Quando o protocolo NPIPE ou SPIPE é usado, o 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 tentar reutilizar um nome de pipe, você receberá uma mensagem de erro. O PipeName não deve conter espaços ou aspas. O PipeName pode incluir um código de formato de estilo printf-style, como %x ou %d. O depurador substituirá isso pelo ID do processo do depurador. Um segundo código 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.
É possível também especificar um intervalo de portas separadas por dois pontos. O depurador verificará cada porta nesse intervalo para ver se está livre. Se ele 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 em si que está sendo usada para se conectar ao servidor. Para determinar a porta real, use qualquer um dos métodos descritos em Procurando servidores de depuração; quando esse servidor de depuração for exibido, a porta será seguida por dois números separados por dois pontos. O primeiro número será a porta real usada; a segunda pode ser ignorada. 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 forma, enquanto o servidor deverá especificar a porta real usada.)
clicon=Client
Quando o protocolo TCP ou SSL é usado e o parâmetro clicon é especificado, uma conexão reversa será aberta. Isso quer dizer que o servidor de depuração tentará se conectar ao cliente de depuração, em vez de permitir que o cliente inicie o contato. Isso pode ser útil se você tiver um firewall que esteja impedindo conexão na direção usual. O Client especifica o nome de rede da máquina na qual o cliente de depuração existe ou será criado. As duas barras invertidas iniciais (\) 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 normal (servidor antes do cliente) também seja permitida. Um servidor de conexão reversa não aparecerá quando outro depurador mostrar 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).
Taxa de Baud
Quando o protocolo COM é usado, BaudRate especifica a taxa de transmissão em que a conexão será executada. Qualquer taxa de transmissão compatível com o hardware é permitida.
COMChannel
Se o protocolo COM for usado, COMChannel especificará o canal COM a ser usado na comunicação com o cliente da depuração. Esse pode ser qualquer valor entre 0 e 254, inclusivo.
Protocolo
Se o protocolo SSL ou SPIPE for usado, Protocol especificará o protocolo Secure Channel (S-Channel). Pode ser qualquer cadeia de caracteres tls1, pct1, ssl2 ou ssl3.
Cert
Se o protocolo SSL ou SPIPE for usado, Cert especificará o certificado. Pode ser o nome do certificado ou a impressão digital do certificado (a cadeia de caracteres de dígitos hexadecimais fornecida pelo snapin do certificado). Se a sintaxe certuser=Cert for usada, o depurador buscará o certificado no repositório do sistema (o repositório padrão). Se a sintaxe machuser=Cert for usada, o depurador buscará o certificado no armazenamento da máquina. O certificado especificado deve dar suporte à autenticação do servidor.
escondido
Evita que o servidor apareça quando outro depurador mostra todos os servidores ativos.
password=Password
Exige que um cliente de depuração forneça a senha especificada para se conectar à sessão de depuração. A Senha pode ser qualquer cadeia alfanumérica com até doze caracteres.
ipversion=6
(Ferramentas de depuração para o Windows 6.6.07 e versões anteriores somente) Força o depurador a usar IP versão 6 em vez da versão 4 ao usar TCP para se conectar à Internet. No Windows Vista e versões superiores, o depurador tenta padronizar automaticamente o IP versão 6, tornando essa opção desnecessária.
IcfHabilitar
Faz com que o depurador ative 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 desabilita as portas usadas por esses protocolos. Quando IcfEnable é usado com conexão TCP, o depurador faz com que o Windows abra a porta especificada pelo parâmetro Socket. Quando IcfEnable é usado com 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 a conexão ser encerrada.
Ambiente
| Item | Descrição |
|---|---|
| Modos | Modo de usuário, modo kernel |
| Destinos | Ao vivo, despejo de memória |
| Plataformas | Tudo |
Informações Adicionais
Para detalhes completos sobre como iniciar um servidor de depuração, consulte Ativando um servidor de depuração. Para ver exemplos, consulte Exemplos de cliente e servidor.
Comentários
Este comando transforma o depurador atual em um servidor de depuração. Isso lhe permite iniciar 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 é iniciado.
Isso permite um cliente de depuração se conectar à sessão de depuração atual. Observe que é possível iniciar diversos servidores usando opções diferentes, permitindo que diferentes tipos de clientes de depuração ingressem na sessão.