WinDbg Command-Line Options

Les utilisateurs de WinDbg pour 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 toutes les autres options de 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 passé au programme exécutable en tant que ses propres paramètres de ligne de commande.

Paramètres

-serverServerTransport
Crée un serveur de débogage accessible à d’autres débogueurs. Pour obtenir une explication des valeurs possibles de ServerTransport , 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.

-remoteClientTransport
Crée un client de débogage et se connecte à un serveur de débogage qui est 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.

-prémoteSmartClientTransport
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.

-aExtension
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 pour d’autres méthodes permettant de définir 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 initiale du débogueur à 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 connaître d’autres façons de modifier ce nombre, consultez Utilisation de commandes de débogueur.

-d
(Mode noyau uniquement) Après un redémarrage, le débogueur s’insère dans l’ordinateur cible dès qu’un module de noyau est chargé. (Cet arrêt est antérieur à l’arrêt de l’option -b.) Pour plus d’informations et pour plus d’informations sur les autres méthodes de modification de cette status, consultez Blocage et redémarrage de l’ordinateur cible.

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

-failinc
Entraîne le débogueur à ignorer tous les symboles douteux. 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 tous les modules dont les images ne peuvent pas être mappées. Pour plus d’informations et pour connaître les 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 la poursuite de l’exécution de l’application cible après son démarrage ou l’attachement de WinDbg à celle-ci, sauf si un autre point d’arrêt a été défini. Pour plus d’informations, consultez Point d’arrêt initial .

-G
(Mode utilisateur uniquement) Ignore le point d’arrêt final à 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.

-Hd
(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 post-mortem. Pour plus d’informations, consultez Activation du débogage post-mortem.

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 instant.

-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 établie, la sélection et la conservation (ou le clic droit) d’un fichier avec l’une de ces extensions démarrent 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 instant.

-IUKeyString
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 puisse apparaître pendant un instant, cette commande ne démarre pas réellement WinDbg.

-iImagePath
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 du noyau. Pour plus d’informations, consultez Débogage en direct Kernel-Mode à l’aide de WinDbg (classique). Si -k est utilisé sans aucune option ConnectType , 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.

-kxExdiOptions
(Mode noyau uniquement) Démarre une session de débogage du 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 sera 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 pour 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 connaître les 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 User-Mode à 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 pendant qu’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 démarrée. Pour plus d’informations et pour connaître 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 comme ils le font normalement.

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

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

-Pb
(Mode utilisateur uniquement) Empêche le débogueur de demander une interruption initiale 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’intégration dans la cible.

-pd
(Mode utilisateur uniquement) Empêche 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à en cours de débogage. Pour plus d’informations, consultez Nouvelle attachement à l’application cible .

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

-Pr
(Mode utilisateur uniquement) Provoque le débogueur à démarrer le processus cible en cours d’exécution lorsqu’il s’y attache. Cela peut être utile si l’application est déjà suspendue et que vous souhaitez qu’elle reprenne l’exécution.

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

-ptSecondes
Spécifie le délai d’expiration de la pause, 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 non invasive. Pour plus d’informations, consultez Débogage non invasif (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 automatiquement rechargés.

-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 le débogueur à afficher les messages d’erreur d’accès aux fichiers lors du chargement du symbole. Pour plus d’informations et pour connaître les autres méthodes de contrôle, consultez SYMOPT_FAIL_CRITICAL_ERRORS.

-Sécurisé
Active le mode sécurisé.

-ses
Oblige le débogueur à effectuer une évaluation stricte de tous les fichiers de symboles et à ignorer tous les symboles douteux. Pour plus d’informations et pour connaître les autres méthodes de contrôle, consultez SYMOPT_EXACT_SYMBOLS.

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

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

-Péchés
Fait que le débogueur ignore les variables d’environnement du chemin d’accès du symbole et du chemin d’accès d’image exécutable. Pour plus d’informations, consultez SYMOPT_IGNORE_NT_SYMPATH.

-Snc
Entraîne 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.

-srcpathSourcePath
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 connaître d’autres façons de modifier ce chemin d’accès, consultez Chemin d’accès source.

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

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

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

Espace de travail-W
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 aurez la possibilité de créer un espace de travail portant ce nom ou d’abandonner la tentative de chargement. Pour plus d’informations, consultez Utilisation d’espaces de travail - WinDbg (Classique).

-WFFilename
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 aurez la possibilité de créer un fichier d’espace de travail portant 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).

-ySymbolPath
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 connaître d’autres façons de modifier ce chemin d’accès, consultez Chemin du symbole.

-zDumpFile
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, celui-ci 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 User-Mode ou Analyse d’un fichier de vidage Kernel-Mode avec WinDbg.

-zpPageFile
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 spécialement modifiés peuvent être utilisés.

Exécutable
Spécifie la ligne de commande d’un processus exécutable. Cela permet de lancer un nouveau processus et de le déboguer. Il doit s’agir de l’élément final de la ligne de commande. Tout le texte après que 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 User-Mode à l’aide de WinDbg.

-?
Cette fenêtre d’aide HTML s’affiche.

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