SOS デバッガ拡張 (SOS.dll)

CLRStack [-a] [-l] [-p]

マネージ コードのみのスタック トレースを提供します。

-p オプションは、マネージ関数に渡す引数を表示します。

-l オプションは、フレーム内のローカル変数に関する情報を表示します。SOS デバッガ拡張はローカル名を取得できないため、ローカル名の出力は <local address> = <value> の形式になります。

-a (すべて) オプションは、-l と -p の組み合わせへのショートカットです。

x64 ベースおよび IA-64 ベースのプラットフォーム上では、SOS デバッガ拡張で遷移フレームは表示されません。

DumpArray [-start <startIndex>] [-length <length>] [-details] [-nofields] <array object address>

または

DA [-start <startIndex>] [-length <length>] [-detail] [-nofields] array object address>

配列オブジェクトの要素を調べます。

-start オプションは、要素の表示を始めるインデックス位置を指定します。

-length オプションは、表示する要素の数を指定します。

-detail オプションは、DumpObj 形式および DumpVC 形式を使用して要素の詳細を表示します。

-nofields オプションは、配列が表示されないようにします。-detail オプションを指定した場合にのみこのオプションを使用できます。

DumpClass <EEClass address>

型に関連付けられている EEClass 構造体に関する情報を表示します。

DumpClass コマンドを実行すると静的なフィールド値は表示されますが、静的でないフィールド値は表示されません。

DumpMT、DumpObj、Name2EE、または Token2EE コマンドを使用して EEClass 構造体のアドレスを取得します。

DumpHeap [-stat] [-min <size>][-max <size>] [-thinlock] [-mt <MethodTable address>] [-type <partial type name>][start [end]]

ガベージ コレクトされたヒープと、オブジェクトの収集統計に関する情報を表示します。

ガベージ コレクタ ヒープが過剰に断片化されていることを DumpHeap コマンドが検出すると、警告が表示されます。

-stat オプションは、統計的な型の概要のみを出力するよう制限を加えます。

-min オプションは、バイト単位で指定した size パラメータ未満のオブジェクトを無視します。

-max オプションは、バイト単位で指定した size パラメータを超えるオブジェクトを無視します。

-thinlock オプションは、ThinLocks を報告します。詳細については、SyncBlk コマンドを参照してください。

-mt オプションは、指定した MethodTable 構造体に対応するオブジェクトのみを一覧表示します。

-type オプションは、指定した文字列に対して部分文字列一致する型名を持つオブジェクトのみを一覧表示します。

start パラメータは、指定したアドレスから一覧表示を開始します。

end パラメータは、指定したアドレスで一覧表示を終了します。

DumpLog [<Filename>]

メモリ内ストレス ログの内容を、指定したファイルに書き込みます。名前を指定しないと、現在のディレクトリ内に Stresslog.txt という名前のファイルが作成されます。

共通言語ランタイムは、ストレス エラーの診断に役立つメモリ内ストレス ログを提供します。このログで、ロックまたは I/O を使用せずにエラーを診断できます。ストレス ログを有効にするには、HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework の下に次のレジストリ キーを設定します。

(DWORD) StressLog = 1

(DWORD) LogFacility = 0xffffffff

(DWORD) StressLogSize = 65536

DumpMT [-MD] <MethodTable address>

指定したアドレスにあるメソッド テーブルに関する情報を表示します。-MD オプションを指定すると、オブジェクトに定義されているすべてのメソッドの一覧が表示されます。

各マネージ オブジェクトにメソッド テーブルのポインタが含まれています。

DumpModule [-mt] <Module address>

指定したアドレスにあるモジュールに関する情報を表示します。-mt オプションは、モジュール内に定義されている型とモジュールから参照される型を表示します。

DumpDomain コマンドまたは DumpAssembly コマンドを使用すると、モジュールのアドレスを取得できます。

DumpRuntimeTypes

ガベージ コレクタ ヒープの中にあるランタイムの型オブジェクトを表示し、それらに関連付けられている型名とメソッド テーブルを一覧表示します。

DumpSig <sigaddr> <moduleaddr>

指定したアドレスにある Sig 構造体に関する情報を表示します。

DumpVC <MethodTable address> <Address>

指定したアドレスにある値クラスのフィールドに関する情報を表示します。

DumpVC コマンドで MethodTable パラメータを指定すると、フィールドを正しく解釈できます。値クラスでは、最初のフィールドがメソッド テーブルになることはありません。

EEStack [-short] [-EE]

プロセス内のすべてのスレッドに対して DumpStack コマンドを実行します。

-EE オプションは、DumpStack コマンドに直接渡されます。-short パラメータは、次の種類のスレッドに制限してその内容を出力します。

1. ロックを取得しているスレッド。

2. ガベージ コレクションを実行できるように停止されているスレッド。

3. 現在マネージ コードにあるスレッド。

EHInfo [<MethodDesc address>] [<Code address>]

指定したメソッドの例外処理ブロックを表示します。このコマンドを使用すると、句ブロック (try ブロック) およびハンドラ ブロック (catch ブロック) のコード アドレスとオフセットが表示されます。

FindAppDomain <Object address>

指定したアドレスにあるオブジェクトのアプリケーション ドメインを確認します。

GCHandleLeaks

プロセスの強力なガベージ コレクタ ハンドルおよび固定されたガベージ コレクタ ハンドルへの参照についてメモリ内を検索し、結果を表示します。ハンドルが見つかった場合、GCHandleLeaks コマンドは参照のアドレスを表示します。メモリ内にハンドルが見つからない場合、このコマンドは通知を表示します。

GCRoot [-nostacks] <Object address>

指定したアドレスにあるオブジェクトへの参照 (またはルート) に関する情報を表示します。

GCRoot コマンドは、マネージ ヒープ全体と、スタック上の他のオブジェクトおよびハンドル内にあるハンドルから成るハンドル テーブルを調べます。次に、オブジェクトへのポインタについて各スタックを検索し、さらにファイナライザ キューも検索します。

このコマンドは、スタック ルートが有効かまたは破棄されているかどうかを確認しません。スタック ルートが使用中であるかどうかを確認するには、CLRStack コマンドと U コマンドを使用して、ローカルまたは引数の値が属するフレームを逆アセンブルします。

-nostacks オプションは、ガベージ コレクタ ハンドルおよび到達可能なオブジェクトのみを検索するよう制限を加えます。

IP2MD <Code address>

Just-In-Time (JIT) コンパイルされているコード内の指定したアドレスにある MethodDesc 構造体を表示します。

Name2EE <module name> <type or method name>

または

Name2EE <module name>!<type or method name>

指定したモジュール内の指定した型またはメソッドの MethodTable 構造体および EEClass 構造体を表示します。

指定したモジュールをプロセスに読み込む必要があります。

適切な型名を取得するには、MSIL 逆アセンブラ (Ildasm.exe) を使用してモジュールを参照します。また、* を module name パラメータとして渡すと、読み込まれているすべてのマネージ モジュールを検索できます。module name パラメータには、mscorlib、image00400000 など、デバッガのモジュールの名前も指定できます。

このコマンドは、Windows のデバッガ構文 <module>!<type> をサポートします。型は、完全修飾する必要があります。

PrintException [-nested] [<Exception object address>]

または

PE [-nested] [<Exception object address>]

指定したアドレスにある Exception クラスから派生したすべてのオブジェクトのフィールドが表示および書式設定されます。アドレスを指定しないで PrintException コマンドを使用すると、現在のスレッドで最後にスローされた例外が表示されます。

-nested オプションは、入れ子になった例外オブジェクトに関する詳細を表示します。

このコマンドを使用すると、バイナリ配列の _stackTrace フィールドを書式設定して表示できます。

RCWCleanupList <RCWCleanupList address>

指定したアドレスにあり、クリーンアップを待っているランタイム呼び出し可能ラッパーの一覧を表示します。

StopOnException [-derived] [-create | -create2] <Exception> <Pseudo-register number>

指定した例外がスローされたときにデバッガを停止しますが、それ以外の例外がスローされたときは実行を続行します。

-derived オプションは、指定した例外、および指定した例外から派生したすべての例外をキャッチします。

ThreadPool

キュー内の作業要求の数、完了ポート スレッドの数、タイマの数を含め、マネージ スレッド プールに関する情報を表示します。

Threads [-live] [-special]

プロセス内のすべてのマネージ スレッドを表示します。

Threads コマンドを使用すると、デバッガの短縮 ID、共通言語ランタイムのスレッド ID、およびオペレーティング システムのスレッド ID が表示されます。さらに、Threads コマンドでは、スレッドを実行しているアプリケーション ドメインを示すドメイン列、COM アパートメント モードが表示される APT 列、およびスレッド内の最後にスローされた例外が表示される例外列が表示されます。

-live オプションは、ライブ スレッドに関連付けられているスレッドを表示します。

-special オプションは、CLR で作成されたすべての特殊なスレッドを表示します。特殊なスレッドには、同時実行 GC およびサーバー GC のガベージ コレクション (GC: Garbage Collection) スレッド、デバッガ ヘルパー スレッド、ファイナライザ スレッド、AppDomain アンロード スレッド、およびスレッドプール タイマ スレッドがあります。

U [-gcinfo] [-ehinfo] <MethodDesc address> | <Code address>

メソッドの MethodDesc 構造体ポインタまたはメソッド本体のコード アドレスで指定したマネージ メソッドの注釈付き逆アセンブリを表示します。U コマンドを使用すると、開始から終了までのすべてのメソッドが、メタデータ トークンを名前に変換する注釈付きで表示されます。

U コマンドの -gcinfo オプションを指定すると、メソッドの GCInfo 構造体が表示されます。

-ehinfo オプションは、メソッドの例外情報を表示します。この情報は EHInfo コマンドでも取得できます。

VMMap

仮想アドレス空間を走査し、各領域に適用されている保護方法の種類を表示します。