Partager via


WinDbg : Paramètres et espaces de travail

logo WinDbg avec une loupe inspectant les bits.

Cet article explique comment installer et configurer WinDbg.

Paramètres

Utilisez le menu Paramètres pour définir des éléments tels que la source et le chemin d’accès aux symboles. Vous pouvez également choisir le thème clair ou sombre pour WinDbg.

Capture d’écran du menu Paramètres WinDbg affichant l’onglet Général.

Il existe actuellement six boîtes de dialogue Paramètres :

  • Généralités
  • Fenêtre commande
  • Paramètres de débogage
  • Fenêtres de désassemblage
  • Événements &exceptions
  • Fenêtre source

Pour plus d'informations sur la définition des chemins, consultez Chemins des symboles pour le débogueur Windows et le débogage du code source dans WinDbg (Classique).

Espaces de travail

Avec les espaces de travail, vous pouvez enregistrer les informations de configuration dans le fichier d’informations de connexion cible.

Les options des espaces de travail sont enregistrées lorsque vous fermez le débogueur. Pour les enregistrer manuellement, sélectionnez Fichier>Enregistrer l'Espace de travail.

Les espaces de travail sont automatiquement chargés si vous les ouvrez à partir de la liste des cibles récentes. Vous pouvez également les charger manuellement dans le menu Fichier .

Outre les informations de connexion cible, les paramètres suivants sont stockés dans le fichier d’espace de travail.

Paramètres généraux

Remarque

Cette liste et ce format ne sont pas définitifs et peuvent être modifiés.

Réglage Par défaut Descriptif
FinalBreak true Si true, ignore le point d’arrêt final (-g option de ligne de commande).
SourceDebugging true Bascule entre le mode source ou assembly.
DebugChildProcesses false (Mode utilisateur uniquement.) Si true, débogue les processus enfants démarrés par l’application cible (-o option de ligne de commande).
Noninvasive false Spécifie l’attachement noninvasif (option en ligne de commande -pv).
NoDebugHeap false Spécifie que le tas de débogage ne doit pas être utilisé (option de ligne de commande -hd).
Verbose false Lorsque le mode détaillé est activé, il produit une sortie plus détaillée grâce à l'option de ligne de commande (-v) pour certaines commandes d’affichage, comme le vidage des registres.
Elevate - Utilisé en interne par WinDbg. Ne modifiez pas.
Restartable - Utilisé en interne par WinDbg. Ne modifiez pas.
UseImplicitCommandLine false Utilise la ligne de commande implicite (-cimp option de ligne de commande). Ce paramètre démarre le débogueur avec une ligne de commande implicite au lieu d’un processus explicite à exécuter.

Pour plus d’informations sur les options de ligne de commande, consultez les options de ligne de commande WinDbg.

Paramètres de symbole

Réglage Par défaut Descriptif
SymbolOptionsOverride 0 Ce masque d’option de symbole explicite se présente sous la forme d’un seul nombre hexadécimal.
ShouldOverrideSymbolOptions false Si la valeur est définie true, remplace toutes les options de symbole répertoriées dans ce tableau par le masque d’option de symbole fourni, qui est décrit dans le tableau précédent.
SymOptExactSymbols false Cette option permet au débogueur d’effectuer une évaluation stricte de tous les fichiers de symboles.
SymOptFailCriticalErrors false Cette option de symbole entraîne la suppression des boîtes de dialogue d’erreur d’accès aux fichiers.
SymOptIgnoreCvRec false Cette option permet au gestionnaire de symboles d’ignorer l’enregistrement CV dans l’en-tête d’image chargé lors de la recherche de symboles.
SymOptIgnoreNtSympath false Cette option permet au débogueur d’ignorer les paramètres de variable d’environnement pour le chemin du symbole et le chemin d’accès de l’image exécutable.
SymOptNoCpp false Cette option de symbole désactive la traduction C++. Lorsque cette option de symbole est définie, __ remplace :: dans tous les symboles.
SymOptNoUnqualifiedLoads false Cette option de symbole désactive le chargement automatique du gestionnaire de symboles des modules. Lorsque cette option est définie, le débogueur tente de faire correspondre un symbole. Il recherche uniquement les modules déjà chargés.
SymOptAutoPublics false Cette option de symbole permet à DbgHelp de rechercher la table de symboles publics dans un fichier .pdb uniquement en dernier recours. Si des correspondances sont trouvées lors de la recherche des données de symboles privés, les symboles publics ne sont pas recherchés. Ce paramètre améliore la vitesse de recherche de symboles.
SymOptDebug false Cette option de symbole active le chargement de symboles bruyants. Ce paramètre indique au débogueur d’afficher des informations sur sa recherche de symboles.

Pour plus d’informations sur les options de symbole, consultez Options de symbole.

Paramètres de disposition de fenêtre

Les paramètres de disposition de fenêtre sont enregistrés globalement et ne sont pas enregistrés dans le fichier d’espace de travail.

Fichier XML d’espace de travail

L’espace de travail et les informations de connexion cible sont stockées au format XML.

Le fichier suivant montre un exemple de fichier de configuration d’espace de travail.

<?xml version="1.0" encoding="utf-8"?>
<TargetConfig Name="C:\paint.dmp" LastUsed="2017-08-03T21:34:20.1013837Z">
  <EngineConfig />
  <EngineOptions>
    <Property name="FinalBreak" value="true" />
    <Property name="SourceDebugging" value="true" />
    <Property name="DebugChildProcesses" value="false" />
    <Property name="Noninvasive" value="false" />
    <Property name="NoDebugHeap" value="false" />
    <Property name="Verbose" value="false" />
    <Property name="SymbolOptionsOverride" value="0" />
    <Property name="ShouldOverrideSymbolOptions" value="false" />
    <Property name="SymOptExactSymbols" value="false" />
    <Property name="SymOptFailCriticalErrors" value="false" />
    <Property name="SymOptIgnoreCvRec" value="false" />
    <Property name="SymOptIgnoreNtSympath" value="false" />
    <Property name="SymOptNoCpp" value="false" />
    <Property name="SymOptNoUnqualifiedLoads" value="false" />
    <Property name="SymOptAutoPublics" value="false" />
    <Property name="SymOptDebug" value="false" />
    <Property name="Elevate" value="false" />
    <Property name="Restartable" value="true" />
    <Property name="UseImplicitCommandLine" value="false" />
  </EngineOptions>
  <TargetOptions>
    <Option name="OpenDump">
      <Property name="DumpPath" value="C:\paint.dmp" />
    </Option>
  </TargetOptions>
</TargetConfig>

Ce format de fichier continue d’évoluer à mesure que d’autres fonctionnalités sont ajoutées à WinDbg.