Activation d’un serveur de processus

Le serveur de processus inclus dans les outils de débogage pour Windows est appelé DbgSrv (dbgsrv.exe). Pour activer un serveur de processus, ouvrez une fenêtre d’invite de commandes avec élévation de privilèges (Exécuter en tant qu’administrateur) et entrez la commande dbgsrv .

Notez que vous pouvez activer un serveur de processus sans disposer de privilèges élevés, et les clients de débogage pourront se connecter au serveur. Toutefois, les clients ne pourront pas découvrir un serveur de processus, sauf s’il a été activé avec des privilèges élevés. Pour plus d’informations sur la découverte des serveurs de débogage, consultez Recherche de serveurs de processus.

DbgSrv prend en charge plusieurs protocoles de transport : canal nommé (NPIPE), TCP, port COM, canal sécurisé (SPIPE) et couche SSL (Secure Sockets Layer).

dbgsrv -t npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

dbgsrv -t ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password] [[-sifeo Executable] -c[s] AppCmdLine] [-x | -pc] 

Les valeurs potentielles des paramètres des commandes précédentes sont les suivantes :

pipe= PipeName
Lorsque le protocole NPIPE ou SPIPE est utilisé, PipeName est une chaîne qui servira de nom au tuyau. Chaque nom de canal doit identifier un serveur de processus unique. Si vous essayez de réutiliser un nom de tuyau, vous recevrez un message d’erreur. PipeName ne doit pas contenir d’espaces ou de guillemets. PipeName peut inclure un code de formatage numérique printf, tel que %x ou %d. Le serveur de processus remplace cela par l’ID de processus de DbgSrv. Un deuxième code de ce type sera remplacé par l’ID de thread de DbgSrv.

Notez que vous devrez peut-être activer le partage de fichiers et d’imprimantes sur l’ordinateur exécutant le serveur de processus. Dans le Panneau de configuration, accédez aux paramètres de partage avancés du >Centre réseau et partage>. Sélectionnez Activer le partage de fichiers et d’imprimantes.

port= Prise
Lorsque le protocole TCP ou SSL est utilisé, Socket est le numéro de port socket.

Il est également possible de spécifier une plage de ports séparés par un deux-points. DbgSrv vérifie chaque port de cette plage pour voir s’il est gratuit. S’il trouve un port libre et qu’aucune erreur ne se produit, le serveur de processus est créé. Le client intelligent doit spécifier le port réel utilisé pour se connecter au serveur. Pour déterminer le port réel, utilisez l’une des méthodes décrites dans La recherche de serveurs de processus . Lorsque ce serveur de processus s’affiche, le port est suivi de deux nombres séparés par un signe deux-points. Le premier nombre sera le port réel utilisé ; le second peut être ignoré. Par exemple, si le port était spécifié comme port=51:60, et que le port 53 était effectivement utilisé, les résultats de la recherche afficheront « port=53:60 ». (Si vous utilisez le paramètre clicon pour établir une connexion inversée, le client intelligent peut spécifier une plage de ports de cette façon, tandis que le serveur de processus doit spécifier le port réel utilisé.)

clicon= Client
Lorsque le protocole TCP ou SSL est utilisé et que le paramètre clicon est spécifié, une connexion inverse sera ouverte. Cela signifie que le serveur de processus tente de se connecter au client intelligent, au lieu de laisser le client lancer le contact. Cela peut être utile si vous avez un pare-feu qui empêche une connexion dans le sens habituel. Le client spécifie le nom réseau ou l’adresse IP de l’ordinateur sur lequel le client intelligent existe ou sera créé. Les deux premiers antislashs (\) sont facultatifs.

Étant donné que le serveur de processus recherche un client spécifique, vous ne pouvez pas connecter plusieurs clients au serveur si vous utilisez cette méthode. Si la connexion est refusée ou interrompue, vous devrez redémarrer le serveur de processus. Un serveur de processus de connexion inverse n’apparaît pas lorsque quelqu’un utilise l’option de ligne de commande -QR pour afficher tous les serveurs actifs.

Notez que lorsque clicon est utilisé, il est préférable de démarrer le client intelligent avant la création du serveur de processus, bien que l’ordre habituel (serveur avant le client) soit également autorisé.

port= COMPort
Lorsque 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
Lorsque le protocole COM est utilisé, BaudRate spécifie le débit binaire auquel la connexion fonctionnera.» Tout débit binaire pris en charge par le matériel est autorisé.

channel= COMChannel
Si le protocole COM est utilisé, COMChannel spécifie le canal COM à utiliser pour communiquer avec le client de débogage. Cela peut être une valeur comprise entre 0 et 254, inclusivement. Vous pouvez utiliser un seul port COM pour plusieurs connexions à l’aide de numéros de canal différents. (La différence avec l’utilisation d’un port COM pour un câble de débogage est que, dans ce cas, il n’est pas possible d’utiliser des canaux à l’intérieur d’un port COM).

proto= Protocole
Si le protocole SSL ou SPIPE est utilisé, Protocole spécifie le protocole de canal sécurisé (S-Channel). Cela peut être l’une des chaînes tls1, pct1, ssl2 ou ssl3.

Cert
Si le protocole SSL ou SPIPE est utilisé, Cert spécifie le certificat. Il peut s’agir soit du nom du certificat, soit de l’empreinte digitale du certificat (la chaîne de chiffres hexadécimaux donnée par le snapin du certificat). Si la syntaxe certuser=Cert est utilisée, le débogueur recherchera le certificat dans le magasin système (le magasin par défaut). Si la syntaxe machuser=Cert est utilisée, le débogueur recherchera le certificat dans le magasin machine. Le certificat spécifié doit prendre en charge l’authentification du serveur.

caché
Empêche le serveur de processus d’apparaître lorsque quelqu’un utilise l’option de ligne de commande -QR pour afficher tous les serveurs actifs.

password= Mot de passe
Nécessite un client intelligent pour fournir le mot de passe spécifié afin de se connecter au serveur de processus. Password peut être une chaîne alphanumérique, jusqu’à douze caractères de longueur.

Avertissement : l’utilisation d’un mot de passe avec le protocole TCP, NPIPE ou COM offre une faible protection, car le mot de passe n’est pas chiffré. Lorsqu’un mot de passe est utilisé avec le protocole SSL ou SPIPE, il est chiffré. Si vous souhaitez établir une session à distance sécurisée, vous devez utiliser le protocole SSL ou SPIPE.

ipversion=6
(Debugging Tools for Windows 6.6.07 et versions antérieures seulement) Force le débogueur à utiliser la version IP 6 plutôt que la version 4 lors de l’utilisation de TCP pour se connecter à Internet. Dans Windows Vista et les versions ultérieures, le débogueur tente de passer automatiquement à la version IP 6, rendant cette option inutile.

IcfEnable
Force le débogueur à activer les connexions de port nécessaires pour la communication TCP ou de tuyau nommé lorsque le pare-feu de connexion Internet est actif. Par défaut, le pare-feu de connexion Internet désactive les ports utilisés par ces protocoles. Lorsque IcfEnable est utilisé avec une connexion TCP, le débogueur amène Windows à ouvrir le port spécifié par le paramètre Socket. Lorsque IcfEnable est utilisé avec une connexion de tuyau nommé, le débogueur amène Windows à ouvrir les ports utilisés pour les tuyaux nommés (ports 139 et 445). Le débogueur ne ferme pas ces ports après la fin de la connexion.

-sifeo Exécutable
Suspend la valeur IFEO (Image File Execution Option) pour l’image donnée. L’exécutable doit inclure le nom de fichier de l’image exécutable, y compris les extensions de nom de fichier. L’option -sifeo permet à DbgSrv d’être définie en tant que débogueur IFEO pour une image créée par l’option -c , sans provoquer d’appel récursif en raison du paramètre IFEO. Cette option ne peut être utilisée que si -c est utilisé.

-c
Provoque la création d’un processus DbgSrv. Vous pouvez l’utiliser pour créer un processus que vous envisagez de déboguer. Cela est similaire à la génération d’un nouveau processus à partir du débogueur, sauf que ce processus ne sera pas débogué lors de sa création. Pour déboguer ce processus, déterminez son PID et utilisez l’option -p lors du démarrage du client intelligent pour déboguer ce processus.

s
Entraîne la suspension immédiate du processus nouvellement créé. Si vous utilisez cette option, il est recommandé d’utiliser CDB comme client intelligent et de démarrer le client intelligent avec l’option de ligne de commande -pb , conjointement avec -p PID. Si vous incluez l’option -pb sur la ligne de commande, le processus reprend lorsque le débogueur s’y attache ; sinon, vous pouvez reprendre le processus avec la commande ~*m.

AppCmdLine
Spécifie la ligne de commande complète du processus à créer. AppCmdLine peut être une chaîne Unicode ou ASCII et peut inclure n’importe quel caractère imprimable. Tout le texte qui apparaît après le paramètre -c[s] sera pris pour former la chaîne AppCmdLine.

-x
Fait en sorte que le reste de la ligne de commande soit ignoré. Cette option est utile si vous lancez DbgSrv à partir d’une application qui peut ajouter du texte indésirable à sa ligne de commande.

-PC
Fait en sorte que le reste de la ligne de commande soit ignoré. Cette option est utile si vous lancez DbgSrv à partir d’une application qui peut ajouter du texte indésirable à sa ligne de commande. Une erreur de syntaxe se produit si -pc est l’élément final sur la ligne de commande DbgSrv. Outre cette restriction, -pc est identique à -x.

Vous pouvez démarrer n’importe quel nombre de serveurs de processus sur un ordinateur. Toutefois, cela n’est généralement pas nécessaire, car un serveur de processus peut être utilisé par n’importe quel nombre de clients intelligents (chacun engagé dans une session de débogage différente).