WinDbg - 設定とワークスペース

[アーティクル]
03/19/2024

このセクションでは、WinDbg デバッガーをセットアップおよび構成する方法について説明します。

設定

設定メニューを使用して、ソースやシンボルパスなどを設定したり、デバッガーの明るいテーマと暗いテーマを選択したりできます。

現在、6 つの設定ダイアログパネルがあります。

全般
[コマンド] ウィンドウ
デバッグ設定
分解窓
イベント&イクセプション
ソースウィンドウ

パスの設定の詳細については、「Windows デバッガーのシンボルパス」および「WinDbg (クラシック) でのソースコードのデバッグ」を参照してください。

ワークスペース

ワークスペースを使用すると、構成情報をターゲット接続情報ファイルに保存できます。

ワークスペース内のオプションは、デバッガを閉じるときに保存されるか、[ファイル] -> [ワークスペースの保存] を使用して手動で保存できます。

ワークスペースは、最近のターゲットリストから起動するときに自動的にロードされます。または、ファイルメニューで手動でロードすることもできます。

ターゲット接続情報に加えて、次の設定がワークスペースファイルに保存されます。

全般設定

Note

このリストと形式は最終的なものではなく、変更される可能性があります。

設定	Default	説明
FinalBreak	true	true の場合、最後のブレークポイント (-g コマンドラインオプション) が無視されます。
SourceDebugging	true	ソースモードとアセンブリモードを切り替えます。
DebugChildProcesses	false	(ユーザーモードのみ) true の場合、ターゲットアプリケーションによって起動された子プロセスがデバッグされます。 (-o コマンドラインオプション)。
非侵襲的	false	非侵襲的な接続を指定します (-pv コマンドラインオプション)。
NoDebugHeap	false	デバッグヒープを使用しないことを指定します (-hd コマンドラインオプション)。
詳細	false	詳細モードをオンにすると、一部の表示コマンド (レジスタダンプなど) はより詳細な出力を生成します。 (-v コマンドラインオプション)。
昇格	-	WinDbg によって内部的に使用されます - 変更しないでください。
再起動可能	-	WinDbg によって内部的に使用されます - 変更しないでください。
UseImplicitCommandLine	false	暗黙的なコマンドライン (-cimp コマンドラインオプション) を使用します。これにより、明示的なプロセスの実行ではなく、暗黙的なコマンドラインを使用してデバッガーが起動されます。

コマンドラインオプションの詳細については、「WinDbg コマンドラインオプション」を参照してください。

シンボルの設定

設定	Default	説明
SymbolOptionsOverride	0	単一の 16 進数の形式の明示的なシンボルオプションマスク。
ShouldOverrideSymbolOptions	false	True に設定すると、以下にリストされているすべてのシンボルオプションが、上記で説明した提供されたシンボルオプションマスクでオーバーライドされます。
SymOptExactSymbols	false	このオプションを使用すると、デバッガーはすべてのシンボルファイルの厳密な評価を実行します。
SymOptFailCriticalErrors	false	このシンボルオプションを使用すると、ファイルアクセスエラーダイアログボックスが非表示になります。
SymOptIgnoreCvRec	false	このオプションを使用すると、シンボルハンドラーはシンボルを検索するときに、読み込まれたイメージヘッダー内の CV レコードを無視します。
SymOptIgnoreNtSympath	false	このオプションを使用すると、デバッガーはシンボルパスと実行可能イメージパスの環境変数設定を無視します。
SymOptNoCpp	false	このシンボルオプションは C++ 変換をオフにします。このシンボルオプションを設定すると、すべてのシンボルの :: が __ に置き換えられます。
SymOptNoUnqualifiedLoads	false	このシンボルオプションは、シンボルハンドラーによるモジュールの自動ロードを無効にします。このオプションが設定されており、デバッガがシンボルの一致を試みる場合、すでにロードされているモジュールのみが検索されます。
SymOptAutoPublics	false	このシンボルオプションにより、DbgHelp は最後の手段としてのみ .pdb ファイル内のパブリックシンボルテーブルを検索します。プライベートシンボルデータの検索時に一致するものが見つかった場合、パブリックシンボルは検索されません。これにより、シンボルの検索速度が向上します。
SymOptDebug	false	このシンボルオプションは、ノイズの多いシンボルの読み込みをオンにします。これは、シンボルの検索に関する情報を表示するようにデバッガーに指示します。

シンボルオプションの詳細については、「シンボルオプション」を参照してください。

ウィンドウレイアウトの設定

ウィンドウレイアウトはグローバルに保存され、ワークスペースファイルには保存されません。

ワークスペース XML ファイル

ワークスペースとターゲットの接続情報は XML 形式で保存されます。

次のファイルは、ワークスペース構成ファイルの例を示しています。

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

WinDbg デバッガーにさらに多くの機能が追加されるにつれて、このファイル形式は進化し続けることに注意してください。

参照

WinDbg の機能

次の方法で共有