WinDbg: Inställningar, arbetsytor och sparade felsökningssessioner

WinDbg-logotyp med förstoringsglas som inspekterar bitar.

Den här artikeln beskriver hur du konfigurerar WinDbg.

WinDbg använder två typer av konfigurationsfiler:

  • Arbetsytor lagrar dina WinDbg-inställningar, till exempel tema, fönsterlayout, symbolsökvägar, källsökvägar och andra konfigurationsalternativ. Arbetsytefiler använder .xml tillägget och lagras som standard i %LOCALAPPDATA%\DBG\Workspaces. Inställningarna sparas automatiskt i standardarbetsytans fil (%LOCALAPPDATA%\DBG\DbgX.xml) när du stänger WinDbg.

  • Sparade felsökningssessioner lagrar målanslutningsinformation (till exempel vilken dumpfil som ska öppnas eller vilken process som ska kopplas till) tillsammans med motoralternativ per session. Felsökningssessionfiler använder filnamnstillägget .debugtarget och lagras som standard i %LOCALAPPDATA%\DBG\Targets. De här filerna visas i listan Senaste mål på sidan Starta felsökning .

Inställningar

Använd menyn Inställningar för att ange objekt som käll- och symbolsökvägen. Du kan också välja temat för WinDbg. De tillgängliga temalägena är:

  • System – Följer inställningen för Windows-systemtema (standard).
  • Ljus – Använder ljustemat.
  • Mörk – Använder det mörka temat.

Skärmbild av menyn WinDbg-inställningar som visar fliken Allmänt.

Det finns för närvarande sex inställningsdialogrutor:

  • Allmänt
  • Kommandofönster
  • Felsökningsinställningar
  • Demontera fönster
  • Händelser och undantag
  • Källfönster

Mer information om hur du anger sökvägar finns i Symbolsökväg för Windows-felsökning och Felsökning av källkod i WinDbg (klassisk).

Arbetsytor

Arbetsytor sparar dina WinDbg-inställningar, till exempel tema, fönsterlayout, symbolsökvägar, källsökvägar och andra konfigurationsalternativ, till en fil.

Spara och ladda arbetsytor

Du kan hantera arbetsytor via arkivmenyn :

  • Spara arbetsyta – Sparar de aktuella inställningarna i den aktiva arbetsytefilen.
  • Spara arbetsyta som – Sparar de aktuella inställningarna i en ny arbetsytefil.
  • Öppna arbetsyta – Läser in inställningar från en tidigare sparad arbetsytefil.

Inställningarna sparas också automatiskt när du stänger felsökningsprogrammet, såvida inte automatiskt sparande har inaktiverats med -Q kommandoradsalternativet.

Kommandoradsalternativ för arbetsytan

Du kan använda följande kommandoradsalternativ för att styra arbetsytans beteende:

  • -Q – Inaktiverar automatisk besparing av inställningar. Inställningar sparas bara när du uttryckligen väljer Spara arbetsyta eller Spara arbetsyta frånArkiv-menyn .
  • -WF SettingsFile – Läser in inställningar från den angivna arbetsytefilen vid start.

Sparade felsökningssessioner

Sparade felsökningssessioner lagrar målanslutningens information tillsammans med motoralternativ för varje session. Felsökningssessionsfiler använder filtillägget .debugtarget och sparas standardmässigt i %LOCALAPPDATA%\DBG\Targets.

Spara och läsa in felsökningssessioner

Du kan hantera felsökningssessioner via menyn Arkiv och kommandoraden:

  • Spara felsökningssession – Sparar aktuell målanslutningsinformation till en .debugtarget fil. Det här alternativet är bara tillgängligt när ett felsökningsmål är aktivt.
  • Senaste mål – På sidan Starta felsökning väljer du en tidigare sparad felsökningssession från listan Senaste mål för att läsa in den igen.
  • -loadSession – Läser in en sparad konfigurationsfil för felsökningssessioner från kommandoraden.

Felsöka sessionsinställningar

Förutom målanslutningsinformationen lagras följande inställningar i den sparade felsökningssessionsfilen (.debugtarget filnamnstillägget).

Allmänna inställningar

Anmärkning

Den här listan och formatet är inte slutgiltigt och kan komma att ändras.

Inställning Förinställning Beskrivning
FinalBreak true Om trueignorerar du den sista brytpunkten (-g kommandoradsalternativet).
SourceDebugging true Växlar mellan käll- eller sammansättningsläge.
DebugChildProcesses false (Endast användarläge.) Om true är aktivt, kan felsöka underordnade processer som startats av målprogrammet (-o kommandoradsalternativ).
Noninvasive false Anger icke-invasiv bifoga (-pv kommandoradsalternativ).
NoDebugHeap false Ange att felsökningshög inte ska användas (-hd kommandoradsalternativ).
Verbose false När utförligt läge är aktiverat ger mer detaljerade utdata (-v kommandoradsalternativ) för vissa visningskommandon (till exempel registerdumpning).
Elevate - Används internt av WinDbg. Ändra inte.
Restartable - Används internt av WinDbg. Ändra inte.
UseImplicitCommandLine false Använder underförstådd kommandorad (-cimp kommandoradsalternativ). Den här inställningen startar felsökningsprogrammet med en implicit kommandorad i stället för en explicit process att köra.

Mer information om kommandoradsalternativen finns i WinDbg-kommandoradsalternativ.

Symbolinställningar

Inställning Förinställning Beskrivning
SymbolOptionsOverride 0 Den här explicita symbolalternativmasken är i form av ett enda hexnummer.
ShouldOverrideSymbolOptions false Om värdet trueär inställt på åsidosätter du alla symbolalternativ som anges i den här tabellen med den angivna symbolalternativmasken, som beskrivs i föregående tabell.
SymOptExactSymbols false Det här alternativet gör att felsökaren utför en strikt utvärdering av alla symbolfiler.
SymOptFailCriticalErrors false Det här symbolalternativet gör att dialogrutor för filåtkomstfel ignoreras.
SymOptIgnoreCvRec false Det här alternativet gör att symbolhanteraren ignorerar CV-posten i det inlästa bildhuvudet när du söker efter symboler.
SymOptIgnoreNtSympath false Det här alternativet gör att felsökaren ignorerar miljövariabelinställningarna för symbolsökvägen och den körbara bildsökvägen.
SymOptNoCpp false Det här symbolalternativet inaktiverar C++-översättning. När det här symbolalternativet har angetts ersätter __:: i alla symboler.
SymOptNoUnqualifiedLoads false Det här symbolalternativet inaktiverar symbolhanterarens automatiska inläsning av moduler. När det här alternativet har angetts försöker felsökaren matcha en symbol. Den söker bara igenom moduler som redan har lästs in.
SymOptAutoPublics false Det här symbolalternativet gör att DbgHelp endast söker i tabellen med offentliga symboler i en .pdb-fil som en sista utväg. Om några matchningar hittas när du söker efter privata symboldata genomsöks inte de offentliga symbolerna. Den här inställningen förbättrar symbolsökningshastigheten.
SymOptDebug false Det här symbolalternativet aktiverar störande symbolinläsning. Den här inställningen instruerar felsökaren att visa information om dess sökning efter symboler.

Mer information om symbolalternativ finns i Symbolalternativ.

Felsöka SESSIONS-XML-fil

Felsökningssessionens målanslutningsinformation lagras i XML-format med filnamnstillägget .debugtarget.

Följande fil visar ett exempel på konfigurationsfilen för felsökningssessioner.

<?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>

Det här filformatet fortsätter att utvecklas i takt med att fler funktioner läggs till i WinDbg.

Relaterat innehåll

  • Last updated on