Activation d’un client de débogage

Une fois le serveur de débogage activé, vous pouvez démarrer un client de débogage sur un autre ordinateur et vous connecter à la session de débogage.

Il existe deux façons de démarrer un client de débogage : à l’aide de l’option de ligne de commande -remote ou à l’aide de l’interface graphique WinDbg.

Le protocole du client doit correspondre au protocole du serveur. La syntaxe générale du démarrage d’un client de débogage dépend du protocole utilisé. Voici les options disponibles :

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] 

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] 

Pour utiliser l’interface graphique pour se connecter à une session de débogage à distance, WinDbg doit être en mode dormant : il doit soit avoir été démarré avec aucun paramètre de ligne de commande, soit avoir terminé la session de débogage précédente. Sélectionnez le fichier | Commande de menu Se connecter à la session à distance ou appuyez sur la touche de raccourci Ctrl+R. Lorsque la boîte de dialogue Se connecter à une session de débogueur distant s’affiche, entrez l’une des chaînes suivantes dans la zone de texte Chaîne de connexion :

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] 

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] 

Vous pouvez également utiliser le bouton Parcourir pour localiser les serveurs de débogage actifs.

Les paramètres des commandes précédentes ont les valeurs possibles suivantes :

Débogueur
Il ne doit pas s’agir du même débogueur que celui utilisé par le client de débogage : WinDbg, KD et CDB sont tous interchangeables à des fins de débogage à distance via le débogueur.

Serveur
Il s’agit du nom réseau ou de l’adresse IP de l’ordinateur sur lequel le serveur de débogage a été créé. Les deux barres obliques inverses initiales (\) sont facultatives sur la ligne de commande, mais ne sont pas autorisées dans la boîte de dialogue WinDbg.

pipe=PipeName
Si le protocole NPIPE ou SPIPE est utilisé, PipeName est le nom qui a été donné au canal lors de la création du serveur.

Si vous n’êtes pas connecté à l’ordinateur client avec un compte qui a accès à l’ordinateur serveur, vous devez fournir un nom d’utilisateur et un mot de passe. Sur l’ordinateur client, dans une fenêtre d’invite de commandes, entrez la commande suivante.

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

où Server est le nom de l’ordinateur serveur et UserName est le nom d’un compte qui a accès à l’ordinateur serveur.

Lorsque vous y êtes invité, entrez le mot de passe pour UserName.

Une fois cette commande réussie, vous pouvez activer un client de débogage à l’aide de l’option de ligne de commande -remote ou à l’aide de l’interface graphique WinDbg.

Note Vous devrez peut-être activer le partage de fichiers et d’imprimantes sur l’ordinateur serveur. Dans Panneau de configuration, accédez à Network and Internet Network and Sharing > Center Advanced sharing Center>. Sélectionnez Activer le partage de fichiers et d’imprimantes.

port=Socket
Si le protocole TCP ou SSL est utilisé, Socket est le même numéro de port de socket que celui utilisé lors de la création du serveur.

clicon
Spécifie que le serveur de débogage tente de se connecter au client via une connexion inverse. Le client doit utiliser clicon si et uniquement si le serveur utilise clicon. Dans la plupart des cas, le client de débogage est démarré avant le serveur de débogage lorsqu’une connexion inverse est utilisée.

port=COMPort
Si le protocole COM est utilisé, COMPort spécifie le port COM à utiliser. Le préfixe « COM » est facultatif. Par exemple, « com2 » et « 2 » sont acceptables.

baud=BaudRate
Si le protocole COM est utilisé, BaudRate doit correspondre au taux de bauds choisi lors de la création du serveur.

channel=COMChannel
Si le protocole COM est utilisé, COMChannel doit correspondre au numéro de canal choisi lors de la création du serveur.

proto=Protocol
Si le protocole SSL ou SPIPE est utilisé, le protocole doit correspondre au protocole sécurisé utilisé lors de la création du serveur.

Cert
Si le protocole SSL ou SPIPE est utilisé, vous devez utiliser le paramètre certuser=Cert ou machuser=Cert identique qui a été utilisé lors de la création du serveur.

password=Password=Password
Si un mot de passe a été utilisé lors de la création du serveur, le mot de passe doit être fourni pour créer le client de débogage. Il doit correspondre au mot de passe d’origine. Les mots de passe respectent la casse. Si le mot de passe incorrect est fourni, le message d’erreur spécifie « 0x80004005 d’erreur ». Les mots de passe doivent contenir douze caractères ou moins.

ipversion=6
(Outils de débogage pour Windows 6.6.07 et versions antérieures uniquement) Force le débogueur à utiliser IP version 6 plutôt que version 4 lors de l’utilisation de TCP pour se connecter à Internet. Dans Windows Vista et les versions ultérieures, le débogueur tente d’utiliser automatiquement la version IP 6, ce qui rend cette option inutile.

Les options de ligne de commande utilisées pour démarrer de nouvelles sessions de débogage (telles que -p) ne peuvent pas être utilisées par le client de débogage, mais uniquement par le serveur. Les options de configuration (telles que -n) fonctionnent à partir du client ou du serveur.