「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。
目次 †
概要 †
- sysinternalsのツールの一つ。
- UMPDの後継ツール(?)
- .NETのダンプも取得可能。
詳細 †
デバッグ †
一般的な取得方法 †
一般的な、クラッシュ・ダンプの取得方法。
procdump.exe -ma -e XXXXX.exe
プロセスIDで取得 †
プロセスIDでの、クラッシュ・ダンプの取得方法。
procdump -a -r -ma <プロセス ID> <出力先フォルダ>
マルチ・プロセスの場合 †
メッセージ・ループのハング †
procdump.exe –ma –h XXXXX.exe
リソース系のハング †
オプション †
ダンプの種類 †
# | オプション | 説明 | 詳細 |
1 | -mm | 'Mini' dump | |
2 | -ma | 'Full' dump | |
3 | -mp | 'MiniPlus?' dump | |
4 | -mc Mask | 'Custom' dump | MINIDUMP_TYPE(16進数)で定義されたメモリを含める。 |
5 | -md Callback_DLL | 'Callback' dump | コールバック・ルーチンで定義されたメモリを含める。 |
6 | -mk | 'Kernel' dump | |
入力と出力 †
入力はプロセス、出力はファイル。
- 出力:ファイル or フォルダ
Dump_Folder
- 入力:対象プロセス(-wで起動待ち可能)
- Process_Name
- Service_Name
- PID
[-e [1 [-g] [-b]]]
- eオプション
指定プロセスがクラッシュ(未処理の例外が発生)した際にダンプを取得
- 関連オプション
# | オプション | 説明 |
1 | 1 | ファースト・チャンス例外のキャプチャ |
2 | -g | ネイティブ・デバッガとして実行 |
3 | -b | デバッグ・ブレーク・ポイントを例外として処理 |
[-h ...]
- hオプション
指定プロセスがハングアップした場合(ウィンドウメッセージに5秒間以上応答していない場合)にダンプを取得
- 関連オプション
# | オプション | 説明 |
1 | -s Seconds | Seconds 秒以上、以下のダンプ取得の条件が続いた際にダンプを取得 |
2 | -c CPU_Usage | CPU使用率が n %を超えた際にダンプを取得 |
3 | -cl CPU_Usage | CPU使用率が n %を下回った際にダンプを取得 |
4 | -p Counter_Threshold | パフォーマンス・カウンタが閾値を超えた際にダンプを取得 |
5 | -pl Counter_Threshold | パフォーマンス・カウンタが閾値を下回った際にダンプを取得 |
6 | -m Commit_Usage | メモリコミット閾値(MB単位)を超えた際にダンプを取得 |
7 | -ml Commit_Usage | メモリコミット閾値(MB単位)を下回った際にダンプを取得 |
8 | -u | -c、-clに続け、CPU使用率を、シングルコアを基準とした値とみなす |
出力オプション †
# | オプション | 説明 |
1 | -o | 既存のダンプファイルを上書 |
2 | -n | 書き込むダンプの数を指定 |
3 | -t | プロセスの終了時にダンプを作成する |
4 | -wer | ダンプをWindowsエラー報告のキューに入れる。 |
5 | -64 | 64ビットのダンプを作成する |
デバッガ †
# | オプション | 説明 |
1 | -l | プロセスのデバッグ・ログを表示 |
2 | -f Include_Filter, ... | 例外およびデバッグ・ログの内容を組込フィルタ |
3 | -fx Exclude_Filter, ... | 例外およびデバッグ・ログの内容を除外フィルタ |
4 | -i | ProcDump を AeDebug事後検証デバッガとしてインストール |
5 | -u | AeDebug事後検証デバッガのアンインストール(以前の構成を復元) |
- Uninstall Usage:
procdump.exe -u
クローン †
Windows 7、Windows 2012 R2に導入されたの
プロセスリフレクション(Proces Reflection)により、
プロセスをクローン、クローンからメモリのスナップショットを
ダンプすることで、取得後のプロセスを継続させることが出来る。
# | オプション | 説明 |
1 | -r [1..5] | プロセスをリフレクト(同時制限はオプション 1..5) |
2 | -a | -rに続け、負荷による停止を避けるケースで利用 |
参考 †
概要 †
詳細 †
その他 †
Tags: :インフラストラクチャ, :Windows, :障害対応, :デバッグ, :ツール類