Partager via

Options de ligne de commande DbgSrv

  • Article

La ligne de commande DbgSrv utilise la syntaxe suivante.

dbgsrv -t ServerTransport [-sifeo image.ext] -c[s] AppCmdLine [-x | -pc] 

dbgsrv -?

Toutes les options respectent la casse.

Paramètres

-t ServerTransport
Spécifie le protocole de transport. Pour obtenir la liste des protocoles possibles et de la syntaxe de ServerTransport dans chaque cas, consultez Activation d’un serveur de processus.

-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
Entraîne l’utilisation du reste de la ligne de commande comme « ligne de commande implicite » comme création de processus en attente. Cette ligne de commande est utilisée si un débogueur est connecté à ce serveur de processus avec « -cimp ». Par exemple, l’exécution dbgsrv -t <ServerTransport> -pc notepad.exe, puis l’exécution ntsd -premote <Transport> -cimp entraîne la connexion à dbgsrv et le lancement de notepad.exe

- ?
Affiche une zone de message avec du texte d’aide pour la ligne de commande DbgSrv.

Pour plus d’informations sur l’utilisation de DbgSrv, consultez Serveurs de processus (mode utilisateur).