CDB のコマンドラインオプション

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

CDB または NTSD を初めて使用するユーザーは、「CDB と NTSD を使用したデバッグ」セクションから始めてください。

CDB コマンドラインは次の構文を使用します:

cdb  [ -server ServerTransport | -remote ClientTransport ] 
[ -premote SmartClientTransport ] [-log{a|au|o|ou} LogFile]
[-2] [-d] [-ddefer] [-g] [-G] [-hd] [-lines] [-myob] [-bonc] 
[-n] [-o] [-s] [-v] [-w] [-cf "filename"] [-cfr "filename"] [-c "command"] 
[-robp] [-r BreakErrorLevel]  [-t PrintErrorLevel] 
[ -x{e|d|n|i} Exception ] [-x] [-clines lines] 
[-i ImagePath]  [-y SymbolPath] [-srcpath SourcePath] 
[-aExtension] [-failinc] [-noio] [-noinh] [-noshell] [-nosqm]
[-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul] [-zp PageFile] 
[-sup] [-sflags 0xNumber] [-ee {masm|c++}]
[-e Event] [-pb] [-pd] [-pe] [-pr] [-pt Seconds] [-pv] 
[ -- | -p PID | -pn Name | -psn ServiceName | -z DumpFile | executable ] 
[-cimp] [-isd] [-kqm] [-pvr] [-version] [-vf] [-vf:<opts>] [-netsyms:{yes|no}]

cdb -iae 

cdb -iaec KeyString 

cdb -iu KeyString

cdb -QR Server 

cdb -wake pid 

cdb -?

NTSD コマンドライン構文は、CDB の構文と同じです:

ntsd  [ -server ServerTransport | -remote ClientTransport ] 
[ -premote SmartClientTransport ] [-log{a|au|o|ou} LogFile]
[-2] [-d] [-ddefer] [-g] [-G] [-hd] [-lines] [-myob] [-bonc] 
[-n] [-o] [-s] [-v] [-w] [-cf "filename"] [-cfr "filename"] [-c "command"] 
[-robp] [-r BreakErrorLevel]  [-t PrintErrorLevel] 
[ -x{e|d|n|i} Exception ] [-x] [-clines lines] 
[-i ImagePath]  [-y SymbolPath] [-srcpath SourcePath] 
[-aExtension] [-failinc] [-noio] [-noinh] [-noshell] [-nosqm]
[-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul] [-zp PageFile] 
[-sup] [-sflags 0xNumber] [-ee {masm|c++}] 
[-e Event] [-pb] [-pd] [-pe] [-pr] [-pt Seconds] [-pv] 
[ -- | -p PID | -pn Name | -psn ServiceName | -z DumpFile | executable ] 
[-cimp] [-isd] [-kqm] [-pvr] [-version] [-vf] [-vf:<opts>] [-netsyms:{yes|no}]

ntsd -iae 

ntsd -iaec KeyString 

ntsd -iu KeyString

ntsd -QR Server 

ntsd -wake PID 

ntsd -?

NTSD と CDB の唯一の違いは、NTSD が新しいコンソールウィンドウを生成するのに対し、CDB は呼び出されたウィンドウを継承する点です。 start コマンドを使用して新しいコンソールウィンドウを生成することもできるため、次の 2 つの構造で同じ結果が得られます。

start cdb [parameters]
ntsd [parameters]

CDB と NTSD コマンドラインオプションの説明は次のとおりです。 -remote、-server、-g、-G オプションでのみ大文字と小文字が区別されます。最初のハイフンはスラッシュ (/) に置き換えることができます。追加のパラメーターを取らないオプションは連結できます。そのため、"cdb -o -d -G -g winmine" は "cdb -odGg winmine" と記述できます。

-remote または -server オプションを使用する場合は、コマンドラインの他のオプションの前に表示する必要があります。 実行可能ファイルを指定する場合は、コマンドラインの最後に表示する必要があります。実行可能ファイル名の後のテキストは、独自のコマンドラインパラメーターとして実行可能プログラムに渡されます。

パラメーター

-serverServerTransport
他のデバッガーからアクセスできるデバッグサーバーを作成します。使用可能な ServerTransport 値の説明については、「デバッグサーバーのアクティブ化」を参照してください。このパラメーターを使用する場合は、コマンドラインの最初のパラメーターにする必要があります。

-remoteClientTransport
デバッグクライアントを作成し、既に実行されているデバッグサーバーに接続します。可能な ClientTransport 値の説明については、「デバッグクライアントのアクティブ化」を参照してください。このパラメーターを使用する場合は、コマンドラインの最初のパラメーターにする必要があります。

-premoteSmartClientTransport
スマートクライアントを作成し、すでに実行されているプロセスサーバーに接続します。可能な SmartClientTransport 値の説明については、「スマートクライアントのアクティブ化」を参照してください。

-2
ターゲットアプリケーションがコンソールアプリケーションの場合、このオプションを選択すると、新しいコンソールウィンドウに表示されます。 (既定では、ターゲットコンソールアプリケーションが CDB または NTSD とウィンドウを共有するようになっています)。

--
クライアントサーバーランタイムサブシステム (CSRSS) をデバッグします。詳細については、「CSRSS のデバッグ」を参照してください。

-aExtension
既定の拡張 DLL を設定します。既定値は userexts です。 "a" の後にスペースを入れてはいけません。また、拡張子 .dll を含めてはなりません。この既定値の詳細と、他の設定方法については、「デバッガー拡張 DLL の読み込み」を参照してください。

-bonc
このオプションを指定した場合、セッションが開始されるとすぐにデバッガーがターゲットに分割されます。これは、現在ターゲットに分割されていない可能性があるデバッグサーバーに接続する場合に特に便利です。

-c "command"
起動時に実行する初期デバッガーコマンドを指定します。このコマンドは引用符で囲む必要があります。複数のコマンドはセミコロンで区切ることができます。 (長いコマンドリストがある場合は、スクリプトに含め、$<、$><、$><、$$>< (スクリプトファイルの実行) コマンドで -c オプションを使用する方が簡単な場合があります)。

デバッグクライアントを起動する場合、このコマンドはデバッグサーバーを対象とする必要があります。 .lsrcpath などのクライアント固有のコマンドは使用できません。

-cf "filename"
スクリプトファイルのパスと名前を指定します。このスクリプトファイルは、デバッガーが開始されるとすぐに実行されます。 filename にスペースが含まれる場合は、引用符で囲む必要があります。パスを省略すると、現在のディレクトリが想定されます。 -cf オプションを使用しない場合は、現在のディレクトリ内の ntsd.ini ファイルがスクリプトファイルとして使用されます。ファイルが存在しない場合、エラーは発生しません。詳細については「スクリプトファイルの使用」を参照してください。

-cfr "filename"
スクリプトファイルのパスと名前を指定します。このスクリプトファイルは、デバッガーが開始されるとすぐに実行され、ターゲットが再起動されるたびに実行されます。 filename にスペースが含まれる場合は、引用符で囲む必要があります。パスを省略すると、現在のディレクトリが想定されます。ファイルが存在しない場合、エラーは発生しません。詳細については「スクリプトファイルの使用」を参照してください。

-cimp
実行する明示的なプロセスではなく、DbgSrv の暗黙的なコマンドラインで開始するように CDB/NTSD に指示します。このオプションは、dbgsrv -pc のクライアント側です。

-clineslines
リモートデバッグ中にアクセスできるコマンド履歴内のコマンドの概数を設定します。詳細およびこの番号を変更するその他の方法については、「デバッガーコマンドの使用」を参照してください。

-d
このデバッガーの制御をカーネルデバッガーに渡します。 CSRSS をデバッグする場合、-d が指定されていなくても、この制御リダイレクトは常にアクティブになります。 (このオプションは、リモートデバッグ中は使用できません。代わりに -ddefer を使用してください)。詳細については、「カーネルデバッガーからのユーザーモードデバッガーの制御」を参照してください。このオプションは、-ddefer オプションや -noio オプションと組み合わせて使用することはできません。

注: カーネルデバッガーとして WinDbg を使用する場合、WinDbg の使い慣れた機能の多くは、このシナリオでは使用できません。たとえば、[ローカル] ウィンドウ、[逆アセンブリ] ウィンドウ、または [呼び出し履歴] ウィンドウを使用することはできません。また、ソースコードをステップずつ実行することもできません。これは、WinDbg がターゲットコンピューターで実行されているデバッガー (NTSD または CDB) のビューアーとしてのみ機能するためです。

-ddefer
デバッグクライアントが接続されていない限り、このデバッガーの制御をカーネルデバッガーに渡します。 (これは、デバッグサーバーから使用できる -d のバリエーションです)。詳細については、「カーネルデバッガーからのユーザーモードデバッガーの制御」を参照してください。このオプションは、-d オプションや -noio オプションと組み合わせて使用することはできません。

-eEvent
指定したイベントが発生したことをデバッガーに通知します。このオプションは、デバッガーをプログラムで起動する場合にのみ使用されます。

-ee {masm|c++}
既定の式エバリュエーターを設定します。 masm を指定すると、MASM 式の構文が使用されます。 c++ を指定すると、C++ 式の構文が使用されます。 -ee オプションを省略すると、MASM 式の構文が既定として使用されます。詳細については、「式の評価」を参照してください。

-failinc
デバッガーが疑わしいシンボルを無視するようにします。また、ユーザーモードまたはカーネルモードのミニダンプファイルをデバッグする場合、このオプションでは、イメージをマップできないモジュールをデバッガーが読み込めなくなります。詳細およびその他の制御方法については、「SYMOPT_EXACT_SYMBOLS」を参照してください。

-g
ターゲットアプリケーションの最初のブレークポイントを無視します。このオプションを使用すると、別のブレークポイントが設定されていない限り、ターゲットアプリケーションの起動後、または CDB のアタッチ後もターゲットアプリケーションが実行を継続します。詳細については、「初期ブレークポイント」を参照してください。

-G
プロセス終了時の最終的なブレークポイントを無視します。既定では、CDB はイメージのランダウンプロセス中に停止します。このオプションでは、子が終了したときに CDB は直ちに終了します。これは、コマンド sxd epr を入力する場合と同じ効果があります。詳細については、「例外とイベントの制御」を参照してください。

-hd
デバッグヒープを使用しないことを指定します。詳細については、「CDB を使用したユーザーモードプロセスのデバッグ」を参照してください。

-iImagePath
エラーを生成した実行可能ファイルの場所を指定します。パスにスペースが含まれる場合は、引用符で囲む必要があります。

-iae
事後分析デバッガーとして CDB をインストールします。詳細については、「事後デバッグの有効化」を参照してください。

このアクションが成功した場合、メッセージは表示されません。失敗した場合は、エラーメッセージが表示されます。

-iae パラメーターは、他のパラメーターと共に使用しないでください。このコマンドは実際には CDB を開始しません。

-iaecKeyString
事後分析デバッガーとして CDB をインストールします。 KeyString の内容は、AeDebug レジストリキーの末尾に追加されます。 KeyString にスペースが含まれる場合は、引用符で囲む必要があります。詳細については、「事後デバッグの有効化」を参照してください。

このアクションが成功した場合、メッセージは表示されません。失敗した場合は、エラーメッセージが表示されます。

-iaec パラメーターは、他のパラメーターと共に使用しないでください。このコマンドは実際には CDB を開始しません。

-isd
プロセスの作成に対して CREATE_IGNORE_SYSTEM_DEFAULT フラグをオンにします。

-iuKeyString
ユーザーが URL を使用してデバッガーリモートクライアントを自動起動できるように、デバッガーリモート処理を URL の種類として登録します。 KeyString の形式は remdbgeng://RemotingOption になります。 RemotingOption は、「デバッグクライアントのアクティブ化」に関するトピックで定義されているトランスポートプロトコルを定義する文字列です。このアクションが成功した場合、メッセージは表示されません。失敗した場合は、エラーメッセージが表示されます。

-iu パラメーターは、他のパラメーターと共に使用しないでください。このコマンドは実際には CDB を開始しません。

-kqm
CDB/NTSD を静音モードで起動します。

-lines
ソース行のデバッグを有効にします。このオプションを省略した場合、ソースデバッグを許可する前に、.lines (ソース行のサポートの切り替え) コマンドを使用する必要があります。これを制御するその他の方法については、「SYMOPT_LOAD_LINES」を参照してください。

-log{a|au|o|ou} LogFile
ログファイルへの情報の記録を開始します。指定したファイルが既に存在する場合、-logo が使用されている場合は上書きされ、-loga が使用されている場合は出力がファイルに追加されます。 -logau オプションと -logou オプションはそれぞれ -loga および -logo に似ていますが、ログファイルが Unicode ファイルである点が異なります。詳細については、「CDB にログファイルを保存する」を参照してください。

-myob
dbghelp.dll とバージョンが一致しない場合、デバッガーは引き続き実行されます。 (-myob スイッチがない場合、これは致命的なエラーと見なされます)。

-n
ノイズシンボルの読み込み: シンボルハンドラーからの詳細な出力を有効にします。詳細およびその他の制御方法については、「SYMOPT_DEBUG」を参照してください。

-netsyms {yes|no}
ネットワークパスからのシンボルの読み込みを許可または禁止します。

-noinh
デバッガーによって作成されたプロセスがデバッガーからハンドルを継承できないようにします。これを制御する他の方法については、「CDB を使用したユーザーモードプロセスのデバッグ」を参照してください。

-noio
デバッグサーバーが入力または出力に使用されないようにします。入力はデバッグクライアント (および -c コマンドラインオプションで指定された初期コマンドまたはコマンドスクリプト) からのみ受け入れられます。

すべての出力はデバッグ・クライアントに向けられます。サーバーにNTSDが使用されている場合、コンソールウィンドウはまったく作成されない。詳細については、「デバッグサーバーのアクティブ化」を参照してください。このオプションは、-d オプションや -ddefer オプションと組み合わせて使用することはできません。

-noshell
すべての .shell コマンドを禁止します。この禁止は、新しいデバッグセッションが開始された場合でも、デバッガーが実行されている限り続きます。詳細およびシェル コマンドを無効にするその他の方法については、「シェルコマンドの使用」を参照してください。

-nosqm
テレメトリデータの収集とアップロードを無効にします。

-o
ターゲットアプリケーションによって起動されたすべてのプロセス (子プロセス) をデバッグします。既定では、デバッグしているプロセスによって作成されたプロセスは、通常どおりに実行されます。これを制御する他の方法については、「CDB を使用したユーザーモードプロセスのデバッグ」を参照してください。

-pPID
デバッグする 10 進数のプロセス ID を指定します。これは、すでに実行中のプロセスをデバッグするために使用されます。詳細については、「CDB を使用したユーザーモードプロセスのデバッグ」を参照してください。

-pb
ターゲットプロセスにアタッチするときにデバッガーが最初のブレークインを要求できないようにします。これは、アプリケーションが既に中断されている場合や、ターゲットにブレークインスレッドを作成しないようにする場合に便利です。

-pd
デバッグセッションの終了時にターゲットアプリケーションが終了しないようにします。詳細については、「CDB でのデバッグセッションの終了」を参照してください。

-pe
ターゲットアプリケーションが既にデバッグ中であることを示します。詳細については、「ターゲットアプリケーションへの再アタッチ」を参照してください。

-pnName
デバッグするプロセスの名前を指定します。 (この名前は一意である必要があります) これは、既に実行されているプロセスをデバッグするために使用されます。

-pr
デバッガーがターゲットプロセスにアタッチしたときに、ターゲットプロセスの実行を開始させます。これは、アプリケーションが既に中断されていて、実行を再開したい場合に便利です。

-psnServiceName
デバッグするプロセスに含まれるサービスの名前を指定します。これは、すでに実行中のプロセスをデバッグするために使用されます。

-ptSeconds
ブレークタイムアウトを秒単位で指定します。既定値は 30 です。詳細については、「ターゲットの制御」を参照してください。

-pv
デバッガーがターゲットプロセスに非侵襲的に接続することを指定します。詳細については、「非侵襲的デバッグ (ユーザーモード)」を参照してください。

-pvr
ターゲットプロセスが中断されていないことを除き、-pv と同様に動作します。

-QRServer
指定したネットワークサーバーで実行されているすべてのデバッグサーバーを一覧表示します。 サーバーの前の二重円記号 (\) は省略可能です。詳細については、「デバッグサーバーの検索」を参照してください。

-QR パラメーターは、他のパラメーターと共に使用できません。このコマンドは実際には CDB を開始しません。

-rBreakErrorLevel
ターゲットがデバッガーに侵入する原因となるエラーレベルを指定します。これは、0、1、2、または 3 に等しい 10 進数です。使用できる値は次のとおりです。

Value	定数	説明
0	NONE	エラーが発生しても中断しないでください。
1	ERROR	ERROR レベルのデバッグイベントで中断します。
2	MINORERROR	MINORERROR および ERROR レベルのデバッグイベントで中断します。
3	警告	WARNING、MINORERROR および ERROR レベルのデバッグイベントで中断します。

このエラーレベルは、Microsoft Windows のチェックビルドでのみ意味を持ちます。既定値は 1です。チェックビルドは、Windows 10 バージョン 1803 以前の古いバージョンの Windows で使用することができました。

-robp
これにより、CDB は読み取り専用メモリページにブレークポイントを設定できます。 (既定では、このような操作は失敗します)。

-s
遅延シンボル読み込みを無効にします。これにより、プロセスの起動が遅くなります。詳細およびその他の制御方法については、「SYMOPT_DEFERRED_LOADS」を参照してください。

-sdce
シンボルのロード中にデバッガーに ファイルアクセスエラー メッセージを表示させます。詳細およびその他の制御方法については、「SYMOPT_FAIL_CRITICAL_ERRORS」を参照してください。

-ses
デバッガーがすべてのシンボルファイルを厳密に評価し、疑わしいシンボルを無視するようにします。詳細およびその他の制御方法については、「SYMOPT_EXACT_SYMBOLS」を参照してください。

-sflags 0xNumber
すべてのシンボルハンドラーオプションを一度に設定します。数値は 0x で始まる 16 進数にする必要があります。0x を含まない 10 進数は許可されますが、シンボルオプションはバイナリフラグであるため、16 進数をお勧めします。このオプションは、すべてのシンボルハンドラーの既定値をオーバーライドするため、注意して使用する必要があります。詳細については、「シンボルオプションの設定」を参照してください。

-sicv
シンボルハンドラーが CV レコードを無視するようにします。詳細およびその他の制御方法については、SYMOPT_IGNORE_CVREC を参照してください。

-sins
デバッガーがシンボルパスと実行可能イメージパスの環境変数を無視するようにします。詳細については、「SYMOPT_IGNORE_NT_SYMPATH」を参照してください。

-snc
デバッガーが C++ 変換をオフにします。詳細およびその他の制御方法については、「SYMOPT_NO_CPP」を参照してください。

-snul
修飾されていない名前の自動シンボル読み込みを無効にします。詳細およびその他の制御方法については、「SYMOPT_NO_UNQUALIFIED_LOADS」を参照してください。

-srcpathSourcePath
ファイルの検索パスを指定します。複数のパスはセミコロン (;) で区切ります。パスにスペースが含まれる場合は、引用符で囲む必要があります。このパスを変更する方法の詳細については、「ソースパス」を参照してください。

-sup
シンボルハンドラーが、シンボル検索のたびにパブリックシンボルテーブルを検索するようにします。詳細およびその他の制御方法については、「SYMOPT_AUTO_PUBLICS」を参照してください。

-tPrintErrorLevel
デバッガーにエラーメッセージを表示させるエラーレベルを指定します。これは、0、1、2、または 3 に等しい 10 進数です。使用できる値は次のとおりです。

Value	定数	説明
0	NONE	エラーを表示しません。
1	ERROR	ERROR レベルのデバッグイベントを表示します。
2	MINORERROR	MINORERROR および ERROR レベルのデバッグイベントを表示します。
3	警告	WARNING、MINORERROR、および ERROR レベルのデバッグイベントを表示します。

このエラーレベルは、Microsoft Windows のチェックビルドでのみ意味を持ちます。チェックビルドは、Windows 10 バージョン 1803 より前の古いバージョンの Windowsで利用できました。既定値は 1です。

-v
デバッガーからの詳細出力を有効にします。

-version
デバッガーのバージョン文字列を出力します。

-vf
ApplicationVerifier の既定の設定を有効にします。

-vf:<opts>
指定された ApplicationVerifier 設定を有効にします。

-w
別の VDM で 16 ビットアプリケーションをデバッグするように指定します。

-wakePID
プロセス ID が PID で指定されているユーザーモードデバッガーのスリープモードを終了させます。このコマンドは、スリープモード中にターゲットコンピューターで発行する必要があります。詳細については、「カーネルデバッガーからのユーザーモードデバッガーの制御」を参照してください。

-wake パラメーターは、他のパラメーターと共に使用しないでください。このコマンドは実際には CDB を開始しません。

-x{e|d|n|i} 例外
指定したイベントが発生したときのデバッガーの動作を制御します。例外には、例外番号またはイベントコードを指定します。このオプションを複数回指定して、さまざまなイベントを制御できます。この設定の詳細と、これらを制御する他の方法については、「例外とイベントの制御」を参照してください。

-x
アクセス違反の例外に対する初回中断を無効にします。 2 回目にアクセス違反が発生すると、デバッガーが中断されます。この設定は -xd av と同じです。

-ySymbolPath
シンボルの検索パスを指定します。複数のパスはセミコロン (;) で区切ります。パスにスペースが含まれる場合は、引用符で囲む必要があります。詳細およびこのパスを変更する他の方法については、「シンボルパス」を参照してください。

-zDumpFile
デバッグするクラッシュダンプファイルの名前を指定します。パスとファイル名にスペースが含まれる場合は、引用符で囲む必要があります。複数の -z オプションを含め、その後にそれぞれ異なる DumpFile 値を追加することで、複数のダンプファイルを一度に開くことができます。詳細については、「ユーザーモードダンプファイルの分析」を参照してください。

-zpPageFile
変更されたページファイルの名前を指定します。これは、ダンプファイルをデバッグしていて、.pagein (Page In Memory) コマンドを使用する場合に便利です。標準の Windows ページファイルで -zp を使用することはできません。特別に変更されたページファイルのみを使用できます。

executable
実行可能プロセスのコマンドラインを指定します。これは、新しいプロセスを起動してデバッグするために使用されます。これは、コマンドラインの最後の項目である必要があります。実行可能ファイル名の後のすべてのテキストは、その引数文字列として実行可能ファイルに渡されます。

-?
コマンドラインのヘルプテキストを表示します。

[スタート | 実行] またはコマンドプロンプトウィンドウからデバッガーを起動する場合、アプリケーションのファイル名の後にターゲットアプリケーションの引数を指定します。次に例を示します。

cdb myexe arg1arg2

CDB のコマンドラインオプション

パラメーター

フィードバック

フィードバック

その他のリソース

CDB のコマンドライン オプション

パラメーター

フィードバック

フィードバック

その他のリソース

CDB のコマンドラインオプション