winedbg-development - クラウドでオンライン

プログラム：

NAME

winedbg - ワインデバッガー

SYNOPSIS

ワインデブ [ オプション ] [ プログラム名 [ プログラム引数 ] | wpid ]

ワインデブ --gdb [ オプション ] [ プログラム名 [ プログラム引数 ] | wpid ]

ワインデブ --自動 wpid

ワインデブ --ミニダンプ [ ファイル.mdmp ] wpid

ワインデブ ファイル.mdmp

DESCRIPTION

ワインデブ Wine のデバッガです。 それにより次のことが可能になります。
+ ネイティブ Win32 アプリケーションのデバッグ
+ Winelib アプリケーションのデバッグ
+ ワトソン博士のドロップイン後継者であること

モード

ワインデブ XNUMXつのモードで使用できます。 プログラムの最初の引数はモードを決定します
winedbg が実行されます。

デフォルト
明示的モードがない場合、これが標準です ワインデブ 動作モード。 ワインデブ 意志
ユーザーのフロントエンドとして機能します。

--gdb ワインデブ のプロキシとして使用されます GDB. GDB コマンドのフロントエンドになります
取り扱い、そして ワインデブ すべてのデバッグリクエストをプロキシします GDB Win32 API に。

--自動 このモードは次の場合に使用されます。 ワインデブ に設置されています Aeデバッグ デフォルトとしてのレジストリ エントリ
デバッガ。 ワインデブ クラッシュに関する基本情報が表示されます。 これは便利です
クラッシュをデバッグしたくないが、関連情報を収集したいユーザー向け
開発者に送信されるクラッシュについて。

--ミニダンプ
このモードは、 --自動 XNUMX つは、印刷する代わりに、
画面上の情報 ( --自動 する)、ミニダンプ ファイルに保存されます。 の
ファイルの名前はコマンドラインで渡されるか、によって生成されます。 ワインデータベース いつ
何も与えられません。 このファイルは後で再ロードされる可能性があります ワインデブ さらなる
検査。

ファイル.mdmp
このモードでは ワインデブ に保存されているデバッグ対象の状態をリロードします。
ミニダンプファイル。 次のいずれかを参照してください。 ミニダンプ 以下のコマンド、または --ミニダンプ モード.

OPTIONS

ときで デフォルト モードでは、次のオプションが利用可能です。

- 指図 文字列
ワインデブ コマンドを実行します 文字列 winedbg コマンドラインでキー入力されたかのように、
そして終了します。 これは、実行中のプロセスの PID を取得するのに便利です。
(winedbg --command "info proc")。

- ファイル ファイル名
ワインデブ ファイル filename に含まれるコマンドのリストを、次のように実行します。
winedbg コマンドラインでキーが入力された後、終了します。

ときで GDB プロキシ モードでは、次のオプションが利用可能です。

--開始しない
GDB は自動的には開始されません。 始めるための関連情報 GDB is
画面に印刷されます。 これは、直接使用しない場合に何らかの形で役立ちます GDB しかし、いくつかの
グラフィカル フロントエンドなど DDD or kgbd.

--with-xterm
これは実行されます GDB 現在の Unix コンソールを使用する代わりに、独自の xterm で
テキスト表示。

すべてのモードで、コマンドラインの残りの部分が渡されると、どのモードがどれであるかを識別するために使用されます。
プログラムがある場合は、デバッグする必要があります。

プログラム名
これは、デバッグ セッションのために開始する実行可能ファイルの名前です。 ワインデブ 意志
実際にこの実行可能ファイルを使用してプロセスを作成します。 もしも プログラム_引数 またある
指定された場合、それらはデバッグ対象のプロセスを作成するための引数として使用されます。

wpid ワインデブ Windows pid が指定されているプロセスにアタッチされます wpid。 使用 info PROC
内のコマンド ワインデブ 実行中のプロセスとその Windows PID をリストします。

デフォルト
何も指定しない場合は、実行もアタッチも行わずにデバッガーに入ります。
プロセス。 その仕事は自​​分で行う必要があります。

コマンド

デフォルト モード、 & while リロード a ミニダンプ ファイル：
で使用されるコマンドのほとんどは、 ワインデブ のものと似ています GDB。 を参照してください GDB
詳細についてはドキュメントを参照してください。 を参照してください。 GDB の違い セクションを後で取得して、
からのバリエーションのリスト GDB コマンド。

その他。 コマンド

アボート デバッガを中止します。

やめます デバッガを終了します。

アタッチ N
Wine プロセスにアタッチ (N は Windows ID、数値または XNUMX 進数です)。 ID は次のとおりです。
を使用して取得した info プロセス 指図。 注意してください info プロセス コマンドは戻ります
XNUMX進値

デタッチ Wine プロセスから切り離します。

カスタマーサービス コマンド

助けます コマンドに関するヘルプを出力します。

助けます info
info コマンドに関するヘルプを出力します。

Flow コントロール コマンド

CONT 次のブレークポイントまたは例外まで実行を継続します。

パス 例外イベントをフィルター チェーンに渡します。

手順 コードの次の C 行まで実行を継続します (関数呼び出しに入る)

次の コードの次の C 行まで実行を継続します (関数呼び出しには入りません)

ステピ 次のアセンブリ命令を実行（関数呼び出しに入る）

次へ 次のアセンブリ命令を実行します（関数呼び出しには入りません）

仕上げ 現在の関数の戻りに達するまで実行します。

CONT, 手順, 次の, ステピ, 次へ 接尾辞として数字 (N) を付けることができます。これは、コマンドが
制御がユーザーに返される前に、N 回実行する必要があります。

ブレークポイント、 ウォッチポイント

enable N
(ブレーク|ウォッチ)ポイントを有効にします N

disable N
(ブレーク|ウォッチ)ポイントを無効にします N

削除 N
(ブレーク|ウォッチ)ポイントを削除します N

条件 N (break|watch)-point までの既存の条件を削除します。 N

条件 N 式
条件を追加します 式 (ブレイク|ウォッチ)ポイントまで N. 式 毎回評価されます
(break|watch)-ポイントがヒットしました。 結果がゼロ値の場合、ブレークポイントは無効です。
引き金になった。

破る * N
アドレスにブレークポイントを追加します N

破る id
シンボルのアドレスにブレークポイントを追加します id

破る id N
行にブレークポイントを追加します N 内側のシンボル id.

破る N
行にブレークポイントを追加します N 現在のソースファイルの。

破る 現在のブレークポイントを追加します $ PC 住所。

watch * N
アドレスに監視コマンド (書き込み時) を追加します N (4 バイト上)。

watch id
シンボルのアドレスに監視コマンド (書き込み時) を追加します。 id。 サイズはサイズによって異なります
of id.

時計 * N
アドレスに監視コマンド (読み取り時) を追加します N (4 バイト上)。

時計 id
シンボルのアドレスに監視コマンド (読み取り時) を追加します。 id。 サイズはサイズによって異なります
id.

info 破る
すべての (break|watch) ポイントを (その状態とともに) リストします。

シンボルを使用できます エントリーポイント DLL のエントリ ポイントを表します。

(ブレーク|ウォッチ) ポイントを設定する場合 id、シンボルが見つからない場合 (たとえば、
シンボルはまだロードされていないモジュールに含まれています)、 ワインデブ の名前を思い出すだろう
シンボルがあり、新しいモジュールがロードされるたびに（ロードされるまで）ブレークポイントの設定を試みます。
成功します）。

スタック 操作

bt 現在のスレッドの呼び出しスタックを表示します。

bt N ID のスレッドの呼び出しスタックを表示します N。 注: これによって位置は変わりません。
によって操作される現在のフレーム up & dn コマンド)。

up 現在のスレッドのスタックで XNUMX フレーム上に進みます

up N 上がる N 現在のスレッドのスタック内のフレーム

dn 現在のスレッドのスタック内で XNUMX フレーム下に進みます

dn N 低下する N 現在のスレッドのスタック内のフレーム

フレーム N
セット N 現在のスレッドのスタックの現在のフレームとして。

info 地元の人
現在の関数フレームのローカル変数に関する情報を出力します。

ディレクトリ & source file 操作

表示する DIR
ソースファイルが検索されるディレクトリのリストを出力します。

DIR パス名
追加 パス名 ソースファイルを探すディレクトリのリストへ

DIR ソースファイルを探すディレクトリのリストを削除します。

シンボルファイル パス名
外部シンボル定義ファイルを読み込みます パス名

シンボルファイル パス名 N
外部シンボル定義ファイルを読み込みます パス名 (オフセットを適用すると、 N 〜へ
アドレス）

リスト 現在の位置から 10 行先のソース行をリストします。

リスト - 現在の位置から後方に 10 ソース行をリストします。

リスト N 行から 10 行のソース行をリストします。 N 現在のファイル内

リスト パス名:N
行から 10 行のソース行をリストします。 N ファイル内 パス名

リスト id
関数の 10 行のソースをリストします。 id

リスト * N
アドレスから 10 行のソースをリストします。 N

「,」区切り文字を使用して、(10 行の値を変更する) 終了ターゲットを指定できます。 ために
例：

リスト 123、 234
現在のファイルの 123 行目から 234 行目までのソース行をリストします。

リスト foo.c:1,56
ファイル foo.c の 1 行目から 56 行目までのソース行をリストします。

表示

表示は、任意の関数の実行後に評価され、出力される式です。 ワインデブ


ディスプレイ

info ディスプレイ
アクティブなディスプレイをリストします。

ディスプレイ 式
表現用の表示を追加します 式

ディスプレイ /FMT 式
表現用の表示を追加します 式。 印刷評価済み 式 与えられたものを使用して行われます
フォーマット（を参照） 印刷 command 形式の詳細については)

インクルード ディスプレイ N

非表示 N
表示を削除します N

分解

ディサス 現在の位置から分解する

ディサス 式
アドレスから逆アセンブル 式

ディサス 式,式
XNUMX つの式で指定されたアドレス間のコードを逆アセンブルします。

メモリ （読む、 書き込み、 タイピング）

x 式 アドレスのメモリを調べます 式

x /FMT 式
アドレスのメモリを調べます 式 フォーマットを使用 FMT

印刷 式
の値を出力します 式 (おそらくその型を使用します)

印刷 /FMT 式
の値を出力します 式 (おそらくその型を使用します)

セッションに VAR = 式
の値を書き込みます 式 in VAR 変数

whatis 式
C タイプの式を出力します。 式

FMT どちらかです 手紙 or カウント 手紙ここで、 手紙 することができます：

ASCII文字列

UTF16 Unicode 文字列

i 説明書（分解）

x 32 ビットの符号なし XNUMX 進整数

d 32 ビットの符号付き XNUMX 進整数

w 16 ビット符号なし XNUMX 進整数

c 文字 (実際に印刷されるのは印刷可能な 0x20 ～ 0x7f のみ)

b 8 ビットの符号なし XNUMX 進整数

g Win32 GUID

式

Wine Debugger の式は、ほとんどが C 形式で記述されます。 ただし、いくつかあります
不一致:

識別子には「!」を使用できます。 彼らの名前で。 これにより主にモジュールを指定できるようになります
ID をどこから見るか、例: USER32!CreateWindowExA.

キャスト操作で構造体または共用体を指定する場合は、struct を使用する必要があります。
または Union キーワード (プログラムが typedef を使用している場合でも)。

識別子を指定するときに、この名前のシンボルが複数存在する場合、デバッガは
使用するシンボルを入力するプロンプトが表示されます。 番号からご希望のものをお選びください。

その他。

ミニダンプ ファイル.mdmp デバッグ対象のデバッグ コンテキストをミニダンプ ファイルに保存します。
ファイル.mdmp.

情報 on ワイン 内部

info class
Wine に登録されているすべての Windows クラスをリストします。

info class id
Windows クラスに関する情報を出力します。 id

info シェア
デバッグされたプログラムにロードされたすべての動的ライブラリ (.so を含む) をリストします。
ファイル、NE および PE DLL)

info シェア N
アドレスのモジュールに関する情報を出力します N

info レジ
CPUレジスタの値を出力します。

info すべての規制
CPU および浮動小数点レジスタの値を出力します。

info セグメント
割り当てられたすべてのセグメントをリストします (i386 のみ)

info セグメント N
セグメントの情報を出力します N (i386のみ)

info スタック
値をスタックの一番上に出力します

info 地図
デバッグされたプログラムで使用されるすべての仮想マッピングをリストします。

info 地図 N
Windows pid のプログラムで使用されるすべての仮想マッピングをリストします。 N

info ワインド
デスクトップウィンドウから始まるウィンドウ階層を表示します。

info ワインド N
ハンドルのWindowの情報を出力します。 N

info プロセス
Wine セッション内のすべての W プロセスをリストします。

info 糸
Wine セッションのすべての w-thread をリストします。

info フレーム
例外フレームをリストします (現在のスタック フレームから開始します)。 パスすることもできますが、
オプションの引数として、そのスレッドを調べるための (現在のスレッドの代わりに) スレッド ID
例外フレーム。

デバッグ メッセージは、デバッグ中にオンまたはオフにできます。 セッションに コマンド、しかし
で初期化されたチャンネルのみ ワインデバグ 環境変数。

セッションに 警告する + win
警告をオンにします win チャンネル

セッションに + win
warn/fixme/err/trace をオンにします win チャンネル

セッションに - win
warn/fixme/err/trace をオフにします。 win チャンネル

セッションに フィックスミー - を
すべてのチャンネルで fixme クラスをオフにします

Gdb モード：
ジョブの設定方法については、 GDB すべてのドキュメント GDB コマンド。

ただし、いくつかの Wine 拡張機能は、 モニター コマンド：

モニター ワインド
Wine セッション内のすべてのウィンドウをリストします。

モニター PROC
Wine セッション内のすべてのプロセスをリストします。

モニター memの
デバッグされたプロセスのメモリマッピングを表示します

自動応答オプション & ミニダンプ モード：
ユーザー入力ができないため、使用できるコマンドはありません。

ENVIRONMENT

ワイン_GDB
で使用した場合 GDB プロキシモード、 ワイン_GDB の名前 (およびパス) を指定します。
に使用される実行可能ファイル GDB。 デフォルトでは「gdb」が使用されます。

作者

最初のバージョンはエリック・ヤングデールによって書かれました。

残りの貢献者については、Wine 開発者リストを参照してください。

onworks.net サービスを使用してオンラインで winedbg-development を使用する