.dump (ダンプ ファイルの作成)

.Dumpコマンドは、ユーザーモードまたはカーネルモードのクラッシュダンプファイルを作成します。

.dump [options] FileName
.dump /?

パラメーター

[オプション]
次の1つ以上のオプションを表します。

/a
すべてのプロセスのダンプを作成します (-u が必要です)。

/b [a]
CAB にダンプをパッケージ化し、ダンプを削除します。 オプションが指定されている 場合、追加 情報が含まれます。

/c < コメント>
コメントを追加します (すべての形式でサポートされていません)。

/j < アドレス>
JIT_DEBUG_INFO アドレスを指定してください。

/o
同じ名前の既存のダンプファイルを上書きします。 このオプションを使用せず、同じファイル名のファイルが存在する場合は、ダンプファイルは書き込まれません。

/u
一意の識別子をダンプ名に追加します。

/f [FullOptions]
(カーネルモード:) メモリダンプ全体を作成します。

(ユーザーモード:) 完全なユーザーモードダンプを作成します。 詳細については、「 種類が User-Mode ダンプファイル」を参照してください。 名前にかかわらず、最大のミニダンプファイルには、完全なユーザーモードダンプよりも多くの情報が含まれています。 たとえば、 . dump/mf または . dump/ma は、 ダンプ/fよりも大きいファイルを作成します。 ユーザーモードでは、 . dump/m [minioptions] が常に優先され ます。ダンプ/f

ダンプファイルの内容を変更するには、次の FullOptions を追加します。オプションでは大文字と小文字が区別されます。

すべてのもの 結果
y ダンプファイルに AVX register 情報を追加します。

/m [minioptions]
小さいメモリダンプ(カーネルモードの場合) またはミニダンプ(ユーザーモード) を作成する詳細については、「ユーザーモードのダンプファイル」を参照してください。 /F/mも指定しない場合、 /mが既定値になります。

ユーザーモードでは、別のミニオプションを使用して、ダンプに含める追加のデータを指定できますMinioptionsが含まれていない場合、ダンプにはモジュール、スレッド、およびスタックの情報が含まれますが、追加のデータは含まれません。 次のいずれかの ミニオプション を追加して、ダンプファイルの内容を変更できます。大文字と小文字が区別されます。

MiniOption 結果
a すべてのオプションの追加を使用してミニダンプを作成します。 /Ma オプションは、/mfFhut に相当します。これは、完全なメモリデータの追加、データの処理、モジュール情報のアンロード、基本的なメモリ情報、およびスレッド時間情報をミニダンプに追加します。 参照できないメモリの読み取りに失敗すると、ミニダンプ生成が終了します。
A /Ma オプションは、/ma に相当します。ただし、利用できないメモリの読み取りに失敗した場合は無視され、ミニダンプの生成は続行されます。
f ミニダンプにメモリデータ全体を追加します。 ターゲットアプリケーションが所有している、アクセス可能なすべてのコミット済みページが含まれます。
F すべての基本メモリ情報をミニダンプに追加します。 これにより、有効なメモリに関する情報だけでなく、すべての基本的なメモリ情報を含むミニダンプにストリームが追加されます。 これにより、ミニダンプのデバッグ中に、デバッガーがプロセスの完全な仮想メモリレイアウトを再構築できます。
h ターゲットアプリケーションに関連付けられているハンドルに関するデータをミニダンプに追加します。
u アンロードされたモジュール情報をミニダンプに追加します。 これは、Windows Server 2003 以降のバージョンの Windows でのみ使用できます。
t ミニダンプにスレッド情報を追加します。 これにはスレッド時間が含まれます。これは、ミニダンプのデバッグ時に、! ランナウェイ拡張子または. ttime ([スレッド時間の表示)] コマンドを使用して表示できます。
i ミニダンプにセカンダリメモリを追加します。 セカンダリメモリは、スタックまたはバッキングストアのポインターによって参照される任意のメモリと、このアドレスを囲む小さい領域で参照されます。
p プロセス環境ブロック (PEB) とスレッド環境ブロック (TEB) のデータをミニダンプに追加します。 これは、アプリケーションのプロセスとスレッドに関する Windows システム情報にアクセスする必要がある場合に便利です。
コミットされたすべての読み取り/書き込みプライベートページをミニダンプに追加します。
d 実行可能イメージ内のすべての読み取り/書き込みデータセグメントをミニダンプに追加します。
c イメージ内にコードセクションを追加します。
r スタックの各部分をミニダンプから削除し、スタックトレースの再作成には役立たないメモリを格納します。 ローカル変数とその他のデータ型の値も削除されます。 このオプションを使用すると、ミニダンプのサイズが小さくなりません (これらのメモリセクションは単にゼロになっているため)。ただし、他のアプリケーションのプライバシーを保護する場合に便利です。
R ミニダンプから完全なモジュールパスを削除します。 モジュール名だけが含まれます。 これは、ユーザーのディレクトリ構造のプライバシーを保護する場合に便利なオプションです。
ダンプファイルに AVX register 情報を追加します。

カーネルモードオプション

カーネルモードでは、次のオプションを使用できます。

/k
カーネルメモリのみを使用してダンプを作成します。

/ka
アクティブなカーネルとユーザーモードのメモリを使用してダンプを作成します。

追加情報

カーネルモードのダンプファイルとその使用方法の説明については、「 カーネルモードダンプファイル」を参照してください。 ユーザーモードのダンプファイルとその使用方法の説明については、「 ユーザーモードのダンプファイル」を参照してください。

注釈

このコマンドは、さまざまな状況で使用できます。

  • このコマンドは、ユーザーモードのライブデバッグ中に、ダンプファイルを生成するように対象アプリケーションに指示しますが、ターゲットアプリケーションは終了しません。

  • このコマンドは、カーネルモードのデバッグ中にダンプファイルを生成するように対象のコンピュータに指示しますが、ターゲットコンピュータはクラッシュしません。

  • クラッシュ ダンプのデバッグ中に、このコマンドは古いクラッシュ ダンプ ファイルから新しいクラッシュ ダンプ ファイルを作成します。 これは、クラッシュ ダンプ ファイルが大きく、より小さいファイルを作成する場合に便利です。

生成されるダンプ ファイルの種類を制御できます。

  • カーネル モードでは、完全なメモリ ダンプ を生成するには/f オプションを使用 します。 小さなメモリ ダンプを生成するには/m オプション (またはオプションなし) を使用します。 .dump コマンドでは、カーネル メモリ ダンプを生成できません

  • ユーザー モードでは、 .dump/m[MiniOptions] が最適な選択肢です。 "m" は "minidump" を表しますが、この MiniOption を使用して作成されるダンプ ファイルのサイズは、非常に小さいサイズから非常に大きいサイズまでさまざまです。 適切な MiniOptions を指定することで、 含まれる情報を正確に制御できます。 たとえば、 .dump /ma は 、多くの情報を含むダンプを生成します。 以前のコマンド .dump /f は、中程度の大きな "標準ダンプ" ファイルを生成し、カスタマイズすることはできません。

ダンプするプロセスを指定することはできません。 実行中のすべてのプロセスがダンプされます。

ダンプ ファイルに例外とコンテキスト情報を格納するには、/xc、/xr/xp、/xt のオプションを使用します。 これにより、. ecxr (例外 コンテキスト レコードの表示) コマンドをこのダンプ ファイルで実行できます。

次の例では、フル メモリとハンドル情報を含むユーザー モード ミニdump を作成します。

0:000> .dump /mfh myfile.dmp

ハンドル情報は、!handle 拡張コマンド を使用して読み 取り可能です。

参照

さまざまなカーネルモード ダンプ ファイル