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

DbgSrv コマンド ラインでは、次の構文を使用します。

dbgsrv -t ServerTransport [-sifeo image.ext] -c[s] AppCmdLine [-x | -pc] 

dbgsrv -? 

すべてのオプションでは大文字と小文字が区別されます。

パラメーター

-t ServerTransport
トランスポート プロトコルを指定します。 使用可能なプロトコルの一覧と各ケースでの ServerTransport の構文については、「プロセス サーバーのアクティブ化」を参照してください。

-sifeo 実行可能
指定されたイメージのイメージ ファイル実行オプション (IFEO) 値を一時停止します。 Executable には、ファイル名拡張子を含む実行可能イメージのファイル名を含める必要があります。 -sifeo オプションを使用すると、IFEO 設定による再帰呼び出しを発生させることなく、-c オプションで作成されたイメージの IFEO デバッガーとして DbgSrv を設定できます。 このオプションは、-c が使用されている場合にのみ使用できます。

-c
DbgSrv で新しいプロセスを作成します。 これを使用して、デバッグするプロセスを作成できます。 これは、デバッガーから新しいプロセスを生成するのと似ていますが、このプロセスは作成時にデバッグされない点が異なります。 このプロセスをデバッグするには、その PID を特定し、スマート クライアントを起動してこのプロセスをデバッグするときに -p オプションを使用します。


新しく作成されたプロセスが直ちに一時停止します。 このオプションを使用する場合は、CDB をスマート クライアントとして使用し、-pb コマンド ライン オプションと -p PID を組み合わせてスマート クライアントを起動することをお勧めします。 コマンド ラインに -pb オプションを含めると、デバッガーがアタッチされたときにプロセスが再開されます。それ以外の場合は、~*m コマンドを使用してプロセスを再開できます。

AppCmdLine
作成するプロセスの完全なコマンド ラインを指定します。 AppCmdLine には Unicode 文字列または ASCII 文字列を指定でき、任意の印刷可能な文字を含めることができます。 -c[s] パラメーターの後に表示されるすべてのテキストは、文字列 AppCmdLine を形成するために取得されます。

-x
コマンド ラインの残りの部分が無視されます。 このオプションは、コマンド ラインに不要なテキストを追加する可能性があるアプリケーションから DbgSrv を起動する場合に便利です。

-pc
保留中のプロセス作成時に、コマンド ラインの残りを「暗黙的なコマンド ライン」として使用します。 このコマンド ラインは、デバッガーが "-cimp" を使用してこのプロセス サーバーに接続されている場合に使用されます。 たとえば、dbgsrv -t <ServerTransport> -pc notepad.exe を実行してから ntsd -premote <Transport> -cimp を実行すると、ntsd が dbgsrv に接続して notepad.exe を起動します。

-?
DbgSrv コマンド ラインのヘルプ テキストを含むメッセージ ボックスを表示します。

DbgSrv の使用については、「プロセス サーバー (ユーザー モード)」を参照してください。