Options de ligne de commande WinDbg

Les utilisateurs de WinDbg à la première fois doivent commencer par la section Débogage à l’aide de WinDbg (classique).

La ligne de commande WinDbg utilise la syntaxe suivante :

windbg [ -server ServerTransport | -remote ClientTransport ] [-lsrcpath ]
   [ -premote SmartClientTransport ] [-?] [-ee {masm|c++}] 
   [-clines lines] [-b] [-d] [-aExtension]  
   [-failinc] [-g] [-G] [-hd] [-j] [-n] [-noshell] [-o] [-openPrivateDumpByHandle Handle]
   [-Q | -QY] [-QS | -QSY] [-robp] [-secure] [-ses] [-sdce] 
   [-sicv] [-sins] [-snc] [-snul] [-sup] [-sflags 0xNumber] 
   [-T Title] [-v] [-log{o|a} LogFile] [-noinh] 
   [-i ImagePath] [-y SymbolPath] [-srcpath SourcePath] 
   [-k [ConnectType] | -kl | -kx ExdiOptions] [-c "command"] 
   [-pb] [-pd] [-pe] [-pr] [-pt Seconds] [-pv]
   [-W Workspace] [-WF Filename] [-WX] [-zp PageFile] 
   [ -p PID | -pn Name | -psn ServiceName | -z DumpFile | executable ] 

windbg -I[S] 

windbg -IU KeyString

windbg -IA[S] 

Les descriptions des options de ligne de commande WinDbg suivent. Toutes les options de ligne de commande respectent la casse, à l’exception de -j. Le trait d’union initial peut être remplacé par une barre oblique (/).

Si l’option -remote ou -server est utilisée, elle doit apparaître avant toute autre option sur la ligne de commande. Si un exécutable est spécifié, il doit apparaître en dernier sur la ligne de commande ; tout texte après que le nom de l’exécutable est transmis au programme exécutable comme ses propres paramètres de ligne de commande.

Paramètres

-serveur ServerTransport
Crée un serveur de débogage accessible par d’autres débogueurs. Pour obtenir une explication des valeurs ServerTransport possibles, consultez Activation d’un serveur de débogage. Lorsque ce paramètre est utilisé, il doit s’agir des premiers paramètres de la ligne de commande.

-lointain ClientTransport
Crée un client de débogage et se connecte à un serveur de débogage déjà en cours d’exécution. Pour obtenir une explication des valeurs ClientTransport possibles, consultez Activation d’un client de débogage. Lorsque ce paramètre est utilisé, il doit s’agir des premiers paramètres de la ligne de commande.

-premote SmartClientTransport
Crée un client intelligent et se connecte à un serveur de processus qui est déjà en cours d’exécution. Pour obtenir une explication des valeurs SmartClientTransport possibles, consultez Activation d’un client intelligent.

-un Extension
Définit la DLL d’extension par défaut. La valeur par défaut est kdextx86.dll ou kdexts.dll. Il ne doit pas y avoir d’espace après « a », et l’extension de nom de fichier .dll ne doit pas être incluse. Pour plus d’informations et d’autres méthodes de définition de cette valeur par défaut, consultez Chargement des DLL d’extension de débogueur.

-b
Cette option n’est plus prise en charge.

-c " command "
Spécifie la commande de débogueur initiale à exécuter au démarrage. Cette commande doit être placée entre guillemets. Plusieurs commandes peuvent être séparées par des points-virgules. (Si vous avez une longue liste de commandes, il peut être plus facile de les placer dans un script, puis d’utiliser l’option -c avec la commande $<, $><, $><, $, $$>< (Exécuter le fichier de script).)

Si vous démarrez un client de débogage, cette commande doit être destinée au serveur de débogage. Les commandes spécifiques au client, telles que .lsrcpath, ne sont pas autorisées.

-Clines Lignes
Définit le nombre approximatif de commandes dans l’historique des commandes qui sont accessibles pendant le débogage à distance. Pour plus d’informations et pour d’autres façons de modifier ce nombre, consultez Utilisation des commandes du débogueur.

-d
(Mode noyau uniquement) Après un redémarrage, le débogueur se décompose dans l’ordinateur cible dès qu’un module de noyau est chargé. (Ce saut est antérieur à l’arrêt de l’option -b .) Consultez Blocage et redémarrage de l’ordinateur cible pour plus d’informations et pour d’autres méthodes de modification de cet état.

-ee {masm|c++}
Définit l’évaluateur d’expression par défaut. Si masm est spécifié, la syntaxe d’expression MASM est utilisée. Si c++ est spécifié, la syntaxe de l’expression C++ est utilisée. Si l’option -ee est omise, la syntaxe d’expression MASM est utilisée comme valeur par défaut. Pour plus d’informations, consultez Évaluation des expressions .

-failinc
Provoque l’ignorer des symboles interrogeables. Lors du débogage d’un fichier minidump en mode utilisateur ou en mode noyau, cette option empêche également le débogueur de charger les modules dont les images ne peuvent pas être mappées. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_EXACT_SYMBOLS.

-g
(Mode utilisateur uniquement) Ignore le point d’arrêt initial dans l’application cible. Cette option entraîne l’exécution de l’application cible après le démarrage ou l’attachement de WinDbg, sauf si un autre point d’arrêt a été défini. Pour plus d’informations, consultez le point d’arrêt initial.

-G
(Mode utilisateur uniquement) Ignore le point d’arrêt final lors de l’arrêt du processus. En règle générale, la session de débogage se termine pendant le processus d’exécution de l’image. Cette option entraîne la fin de la session de débogage immédiatement lorsque l’enfant se termine. Cela a le même effet que l’entrée de la commande sxd epr. Pour plus d’informations, consultez Contrôle des exceptions et des événements.

-disque dur
(Mode utilisateur uniquement) Spécifie que le tas de débogage ne doit pas être utilisé.

-I[S]
Installe WinDbg en tant que débogueur postmortem. Pour plus d’informations, consultez Activation du débogage postmortem.

Une fois cette action tentée, un message de réussite ou d’échec s’affiche. Si S est inclus, cette procédure est effectuée en mode silencieux si elle réussit ; seuls les messages d’échec sont affichés.

Le paramètre -I ne doit pas être utilisé avec d’autres paramètres. Cette commande ne démarre pas réellement WinDbg, bien qu’une fenêtre WinDbg puisse apparaître pendant un moment.

-IA[S]
Associe WinDbg aux extensions de fichier .dmp, .mdmp et .wew dans le Registre. Une fois cette action tentée, un message de réussite ou d’échec s’affiche. Si S est inclus, cette procédure est effectuée en mode silencieux si elle réussit ; seuls les messages d’échec sont affichés. Une fois cette association effectuée, sélectionnez et maintenez (ou cliquez avec le bouton droit) un fichier avec l’une de ces extensions démarre WinDbg.

Le paramètre -IA ne doit pas être utilisé avec d’autres paramètres. Cette commande ne démarre pas réellement WinDbg, bien qu’une fenêtre WinDbg puisse apparaître pendant un moment.

-UI KeyString
Inscrit la communication à distance du débogueur en tant que type d’URL afin que les utilisateurs puissent lancer automatiquement un client distant de débogueur avec une URL. KeyString a le format remdbgeng://RemotingOption. RemotingOption est une chaîne qui définit le protocole de transport tel que défini dans la rubrique Activation d’un client de débogage. Si cette action réussit, aucun message n’est affiché ; en cas d’échec, un message d’erreur s’affiche.

Le paramètre -IU ne doit pas être utilisé avec d’autres paramètres. Bien qu’une fenêtre WinDbg apparaisse pendant un instant, cette commande ne démarre pas réellement WinDbg.

-Je ImagePath
Spécifie l’emplacement des exécutables qui ont généré l’erreur. Si le chemin contient des espaces, il doit être placé entre guillemets.

-j
Autoriser la journalisation.

-k [ConnectType]
(Mode noyau uniquement) Démarre une session de débogage de noyau. Pour plus d’informations, consultez Débogage en mode noyau en direct à l’aide de WinDbg (classique). Si -k est utilisé sans aucune option ConnectType suivante, il doit s’agir de l’entrée finale sur la ligne de commande.

-Kl
(Mode noyau uniquement) Démarre une session de débogage du noyau sur la même machine que le débogueur.

-kx ExdiOptions
(Mode noyau uniquement) Démarre une session de débogage de noyau à l’aide d’un pilote EXDI. Pour plus d’informations sur EXDI, consultez Configuration du transport du débogueur EXDI.

-log{o|a} LogFile
Commence la journalisation des informations dans un fichier journal. Si le fichier journal spécifié existe déjà, il est remplacé si -logo est utilisé. Si loga est utilisé, la sortie est ajoutée au fichier. Pour plus d’informations, consultez Conservation d’un fichier journal dans WinDbg.

-lsrcpath
Définit le chemin d’accès source local d’un client distant. Cette option doit suivre -remote sur la ligne de commande.

-n
Chargement de symboles bruyants : active la sortie détaillée du gestionnaire de symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_DEBUG.

-noinh
(Mode utilisateur uniquement) Empêche les processus créés par le débogueur d’hériter des handles du débogueur. Pour obtenir d’autres méthodes de contrôle, consultez Débogage d’un processus en mode utilisateur à l’aide de WinDbg.

-noprio
Empêche toute modification de priorité. Ce paramètre empêche WinDbg de prendre la priorité pour le temps processeur lorsqu’il est actif.

-noshell
Interdit toutes les commandes .shell . Cette interdiction durera tant que le débogueur est en cours d’exécution, même si une nouvelle session de débogage est commencée. Pour plus d’informations et pour d’autres façons de désactiver les commandes de l’interpréteur de commandes, consultez Utilisation des commandes shell.

-o
(Mode utilisateur uniquement) Débogue tous les processus lancés par l’application cible (processus enfants). Par défaut, les processus créés par celui que vous déboguez s’exécutent normalement.

-openPrivateDumpByHandle Manche
Spécifie le handle d’un fichier de vidage sur incident à déboguer.

-p PID
Spécifie l’ID de processus décimal à déboguer. Il est utilisé pour déboguer un processus déjà en cours d’exécution.

-Pb
(Mode utilisateur uniquement) Empêche le débogueur de demander un arrêt initial lors de l’attachement à un processus cible. Cela peut être utile si l’application est déjà suspendue ou si vous souhaitez éviter de créer un thread d’arrêt dans la cible.

-
(Mode utilisateur uniquement) Provoque l’arrêt de l’application cible à la fin de la session de débogage. Pour plus d’informations, consultez Fin d’une session de débogage dans WinDbg (classique).

-Pe
(Mode utilisateur uniquement) Indique que l’application cible est déjà déboguée. Pour plus d’informations, voir Re-attachement à l’application cible.

-Pn Nom
Spécifie le nom du processus à déboguer. (Ce nom doit être unique.) Il est utilisé pour déboguer un processus déjà en cours d’exécution.

-Pr
(Mode utilisateur uniquement) Provoque le démarrage du débogueur du processus cible en cours d’exécution lors de son attachement. Cela peut être utile si l’application est déjà suspendue et que vous souhaitez reprendre l’exécution.

-Psn ServiceName
Spécifie le nom d’un service contenu dans le processus à déboguer. Il est utilisé pour déboguer un processus déjà en cours d’exécution.

-Pt Secondes
Spécifie le délai d’attente d’arrêt, en secondes. La valeur par défaut est 30. Pour plus d’informations, consultez Contrôle de la cible .

-Pv
(Mode utilisateur uniquement) Spécifie que le débogueur doit s’attacher au processus cible de manière nonvasive. Pour plus d’informations, consultez Débogage nonvasif (mode utilisateur).

-Q
Supprime la boîte de dialogue « Enregistrer l’espace de travail ? ». Les espaces de travail ne sont pas enregistrés automatiquement. Pour plus d’informations, consultez Utilisation d’espaces de travail - WinDbg (classique).

-QS
Supprime la boîte de dialogue « Recharger la source ? ». Les fichiers sources ne sont pas rechargés automatiquement.

-QSY
Supprime la boîte de dialogue « Recharger la source ? » et recharge automatiquement les fichiers sources.

-QY
Supprime la boîte de dialogue « Enregistrer l’espace de travail ? » et enregistre automatiquement les espaces de travail. Pour plus d’informations, consultez Utilisation d’espaces de travail - WinDbg (classique).

-robp
Cela permet à CDB de définir un point d’arrêt sur une page de mémoire en lecture seule. (La valeur par défaut est l’échec d’une telle opération.)

-sdce
Provoque l’affichage des messages d’erreur d’accès aux fichiers pendant le chargement des symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_FAIL_CRITICAL_ERRORS.

-sûr
Active le mode sécurisé.

-ses
Fait en sorte que le débogueur effectue une évaluation stricte de tous les fichiers de symboles et ignore les symboles questionnables. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_EXACT_SYMBOLS.

-sflags 0x Nombre
Définit toutes les options du gestionnaire de symboles à la fois. Le nombre doit être un nombre hexadécimal précédé de 0x : un nombre décimal sans 0x est autorisé, mais les options de symbole sont des indicateurs binaires et, par conséquent, hexadécimal est recommandé. Cette option doit être utilisée avec précaution, car elle remplace tous les gestionnaires de symboles par défaut. Pour plus d’informations, consultez Définition des options de symbole.

-sicv
Provoque l’ignorer du gestionnaire de symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_IGNORE_CVREC.

-Péchés
Le débogueur ignore le chemin d’accès aux symboles et les variables d’environnement de chemin d’accès d’image exécutables. Pour plus d’informations, consultez SYMOPT_IGNORE_NT_SYMPATH.

-snc
Provoque la désactivation de la traduction C++ par le débogueur. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_NO_CPP.

-snul
Désactive le chargement automatique des symboles pour les noms non qualifiés. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_NO_UNQUALIFIED_LOADS.

-srcpath SourcePath
Spécifie le chemin de recherche du fichier source. Séparez plusieurs chemins d’accès par un point-virgule ( ;). Si le chemin contient des espaces, il doit être placé entre guillemets. Pour plus d’informations et pour d’autres façons de modifier ce chemin d’accès, consultez Chemin d’accès source.

-souper
Provoque la recherche du gestionnaire de symboles dans la table de symboles publiques pendant chaque recherche de symboles. Pour plus d’informations et pour d’autres méthodes de contrôle, consultez SYMOPT_AUTO_PUBLICS.

-T Titre
Définit le titre de la fenêtre WinDbg.

-v
Active la sortie détaillée du débogueur.

-W Espace
Charge l’espace de travail nommé donné. Si le nom de l’espace de travail contient des espaces, placez-le entre guillemets. Si aucun espace de travail de ce nom n’existe, vous avez la possibilité de créer un espace de travail avec ce nom ou d’abandonner la tentative de chargement. Pour plus d’informations, consultez Utilisation d’espaces de travail - WinDbg (classique).

-WF Fichier
Charge l’espace de travail à partir du fichier donné. Le nom de fichier doit inclure le fichier et l’extension (généralement .wew). Si le nom de l’espace de travail contient des espaces, placez-le entre guillemets. Si aucun fichier d’espace de travail portant ce nom n’existe, vous avez la possibilité de créer un fichier d’espace de travail avec ce nom ou d’abandonner la tentative de chargement. Pour plus d’informations, consultez Utilisation d’espaces de travail - WinDbg (classique).

-WX
Désactive le chargement automatique de l’espace de travail. Pour plus d’informations, consultez Utilisation d’espaces de travail - WinDbg (classique).

-y SymbolPath
Spécifie le chemin de recherche de symboles. Séparez plusieurs chemins d’accès par un point-virgule ( ;). Si le chemin contient des espaces, il doit être placé entre guillemets. Pour plus d’informations et pour d’autres façons de modifier ce chemin, consultez Chemin d’accès aux symboles.

-z DumpFile
Spécifie le nom d’un fichier de vidage sur incident à déboguer. Si le chemin d’accès et le nom de fichier contiennent des espaces, cela doit être entouré de guillemets. Il est possible d’ouvrir plusieurs fichiers de vidage à la fois en incluant plusieurs options -z, chacune suivie d’une valeur DumpFile différente. Pour plus d’informations, consultez Analyse d’un fichier de vidage en mode utilisateur ou analyse d’un fichier de vidage en mode noyau avec WinDbg.

-zp PageFile
Spécifie le nom d’un fichier de page modifié. Cela est utile si vous déboguez un fichier de vidage et que vous souhaitez utiliser la commande .pagein (page en mémoire). Vous ne pouvez pas utiliser -zp avec un fichier de page Windows standard. Seuls les fichiers de page modifiés spécialement peuvent être utilisés.

exécutable
Spécifie la ligne de commande d’un processus exécutable. Il est utilisé pour lancer un nouveau processus et le déboguer. Il doit s’agir de l’élément final sur la ligne de commande. Tout le texte après le nom de l’exécutable est passé à l’exécutable en tant que chaîne d’argument. Pour plus d’informations, consultez Débogage d’un processus en mode utilisateur à l’aide de WinDbg.

- ?
Affiche cette fenêtre d’aide HTML.

Lorsque vous exécutez le débogueur à partir de la ligne de commande, spécifiez des arguments pour l’application cible après le nom de fichier de l’application. Exemple :

windbg myexe arg1 arg2