Attivazione di un client di debug

Dopo aver attivato il server di debug, è possibile avviare un client di debug in un altro computer e connettersi alla sessione di debug.

Esistono due modi per avviare un client di debug: usando l'opzione della riga di comando -remote o usando l'interfaccia grafica WinDbg.

Il protocollo del client deve corrispondere al protocollo del server. La sintassi generale per l'avvio di un client di debug dipende dal protocollo usato. Esistono le opzioni seguenti:

Metodi di connessione consigliati, con alcuni di sicurezza aggiuntivi

Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

metodi di connessione non sicuri

Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password] 

Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

Per usare l'interfaccia grafica per connettersi a una sessione di debug remoto, WinDbg deve essere in modalità inattiva. Deve essere stato avviato senza parametri della riga di comando oppure deve aver terminato la sessione di debug precedente. Selezionare il file | Connettersi a Sessione remota comando di menu oppure premere il tasto di scelta rapida CTRL+R. Quando viene visualizzata la finestra di dialogo connessione alla sessione del debugger remoto , immettere una delle stringhe seguenti nella casella di testo stringa di connessione :

Metodi di connessione consigliati, con alcuni di sicurezza aggiuntivi

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] 

metodi di connessione non sicuri

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] 

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

In alternativa, è possibile usare il pulsante Sfoglia per individuare i server di debug attivi.

Parametri

I parametri nei comandi precedenti hanno i valori possibili seguenti:

debugger
Questo non deve essere lo stesso debugger usato dal client di debug: WinDbg, KD e CDB sono tutti intercambiabili ai fini del debug remoto tramite il debugger.

server
Si tratta del nome di rete o dell'indirizzo IP del computer in cui è stato creato il server di debug. Le due barre rovesciata iniziali (\) sono facoltative nella riga di comando, ma non sono consentite nella finestra di dialogo WinDbg.

pipe=PipeName
Se viene usato il protocollo NPIPE o SPIPE, PipeName è il nome assegnato alla pipe al momento della creazione del server.

Se non si è connessi al computer client con un account che ha accesso al computer server, è necessario specificare un nome utente e una password. Nel computer client, in una finestra del prompt dei comandi, immettere il comando seguente.

net use \\Server\ipc$ /user:UserName

dove Server è il nome del computer server e UserName è il nome di un account che ha accesso al computer server.

Quando richiesto, immettere la password per UserName.

Al termine di questo comando, è possibile attivare un client di debug usando l'opzione della riga di comando -remote o tramite l'interfaccia grafica WinDbg.

Nota potrebbe essere necessario abilitare la condivisione di file e stampanti nel computer server. Nel Pannello di controllo passare a Rete e Internet > Network and Sharing Center> Impostazioni avanzate di condivisione. Selezionare Attiva condivisione file e stampanti.

port=Socket
Se viene usato il protocollo TCP o SSL, Socket corrisponde allo stesso numero di porta socket utilizzato al momento della creazione del server.

clicon
Specifica che il server di debug tenterà di connettersi al client tramite una connessione inversa. Il client deve usare clicon se e solo se il server usa clicon. Nella maggior parte dei casi, il client di debug viene avviato prima del server di debug quando viene usata una connessione inversa.

port= COMPort
Se viene utilizzato il protocollo COM, COMPort specifica la porta COM da utilizzare. Il prefisso "COM" è facoltativo, ad esempio "com2" e "2" sono accettabili.

baud=BaudRate
Se viene usato il protocollo COM, BaudRate deve corrispondere alla velocità in baud scelta al momento della creazione del server.

channel= COMChannel
Se viene usato il protocollo COM, COMChannel deve corrispondere al numero di canale scelto al momento della creazione del server.

proto= protocollo
Se si usa il protocollo SSL o SPIPE, Protocollo deve corrispondere al protocollo sicuro usato al momento della creazione del server.

certificato
Se si usa il protocollo SSL o SPIPE, è necessario usare il parametro Certuser= Cert o Cert usato al momento della creazione del server.

password=password
Se è stata usata una password al momento della creazione del server, è necessario specificare password per creare il client di debug. Deve corrispondere alla password originale. Le password fanno distinzione tra maiuscole e minuscole. Se viene specificata la password errata, il messaggio di errore specifica "Errore 0x80004005". Le password devono avere una lunghezza inferiore o inferiore a dodici caratteri.

ipversion=6
(Solo strumenti di debug per Windows 6.6.07 e versioni precedenti) Forza il debugger a usare IP versione 6 anziché la versione 4 quando si usa TCP per connettersi a Internet. In Windows Vista e versioni successive il debugger tenta di impostare automaticamente l'impostazione predefinita su IP versione 6, rendendo questa opzione non necessaria.

Le opzioni della riga di comando usate per avviare nuove sessioni di debug (ad esempio -p) non possono essere usate dal client di debug, ma solo dal server. Le opzioni di configurazione ( ad esempio -n) funzioneranno dal client o dal server.