Activation d’un client intelligent (mode noyau)

Une fois le serveur de connexion KD activé, vous pouvez créer un client intelligent sur un autre ordinateur et commencer une session de débogage.

Il existe deux façons de démarrer un client intelligent : en démarrant KD ou WinDbg avec le protocole noyau kdsrv, ou à l’aide de l’interface graphique WinDbg.

Vous devez spécifier le protocole de transfert à distance utilisé par le serveur de connexion KD. Vous pouvez également spécifier le protocole pour la connexion de noyau réelle entre le serveur de connexions KD et l’ordinateur cible, ou vous pouvez utiliser la valeur par défaut.

Important

Il existe des considérations importantes en matière de sécurité lors de l’utilisation du débogage à distance. Pour plus d’informations, notamment sur l’activation du mode sécurisé, consultez Sécurité pendant le débogage à distance et considérations relatives à la sécurité pour les outils de débogage Windows.

La syntaxe générale pour démarrer un client intelligent dépend du protocole utilisé. Les options suivantes existent :

méthodes de connexion recommandées, avec des de sécurité supplémentaires

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éthodes de connexion non sécurisées

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]

Pour utiliser l’interface graphique pour se connecter à un serveur de connexions KD, WinDbg doit être en mode dormant . Il doit avoir été démarré sans paramètres de ligne de commande, ou il doit avoir terminé la session de débogage précédente. Sélectionnez le fichier | Connectez-vous à la commande de menu Stub distant. Lorsque la boîte de dialogue Se connecter au serveur stub distant s’affiche, entrez l’une des chaînes suivantes dans la chaîne de connexion zone de texte :

méthodes de connexion recommandées, avec des de sécurité supplémentaires

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éthodes de connexion non sécurisées

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] 

Vous pouvez également utiliser le bouton Parcourir pour localiser les serveurs de connexion KD actifs.

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

du débogueur
Il peut s’agir de KD ou WinDbg.

Server
Il s’agit du nom réseau ou de l’adresse IP de l’ordinateur sur lequel le serveur de connexion KD 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é attribué au canal lors de la création du serveur de connexion KD.

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 de UserName.

Une fois cette commande réussie, vous pouvez activer un client intelligent à l’aide de -k kdsrv ou à l’aide de l’interface graphique WinDbg.

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 de connexion KD.

clicon
Spécifie que le serveur de connexion KD tente de se connecter au client intelligent par le biais d’une connexion inverse. Le client doit utiliser clicon si et uniquement si le serveur utilise clicon. Dans la plupart des cas, le client intelligent est démarré avant le serveur de connexion KD lorsqu’une connexion inversée 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 baud choisi lors de la création du serveur de connexion KD.

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

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

certificat
Si le protocole SSL ou SPIPE est utilisé, vous devez utiliser le même paramètre certuser=Cert ou paramètre Cert utilisé lors de la création du serveur de connexions KD.

password=Mot de passe
Si un mot de passe a été utilisé lors de la création du serveur de connexions KD, mot de passe doit être fourni pour créer le client intelligent. 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 « Erreur 0x80004005 ».

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

trans=@{ConnectType}
Indique au débogueur comment se connecter à la cible. Les protocoles de connexion de noyau suivants sont autorisés :

com:port=ComPort,baud=BaudRate 
usb2:targetname=String 
com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]
com:modem 

Pour plus d’informations sur ces protocoles, consultez Mise en route pour le débogage. Vous pouvez omettre l’un des paramètres de ces protocoles , par exemple, vous pouvez dire trans=@{com :} - et le débogueur est défini par défaut sur les valeurs spécifiées par les variables d’environnement sur l’ordinateur sur lequel KdSrv est en cours d’exécution.

options
Tous les paramètres de ligne de commande supplémentaires peuvent être placés ici. Consultez Command-Line options pour obtenir une liste complète.

Étant donné que le serveur de connexion KD agit simplement comme une passerelle pour le client intelligent, les options supplémentaires seront identiques à celles que vous utiliseriez si vous démarrez un débogueur de noyau sur l’ordinateur où KdSrv est en cours d’exécution. L’exception à cette option est toute option qui spécifie un chemin d’accès ou un nom de fichier est considérée comme un chemin d’accès sur l’ordinateur sur lequel le client intelligent est en cours d’exécution.