bl (ブレークポイントの一覧)

bl コマンドは、既存のブレークポイントに関する情報を一覧表示します。

bl [/L] [Breakpoints]

パラメーター

/L
bl は、ソース ファイルと行番号を表示する代わりに、常にブレークポイント アドレスを表示するようになります。

ブレークポイント
一覧表示するブレークポイントの ID 番号を指定します。 Breakpoints を省略した場合、デバッガーはすべてのブレークポイントを一覧表示します。 任意の数のブレークポイントを指定できます。 複数の ID はスペースまたはコンマで区切る必要があります。 ハイフン (-) を使用して、ブレークポイント ID の範囲を指定できます。 アスタリスク (*) を使用して、すべてのブレークポイントを指定できます。 ID に数値式を使用する場合は、ID を角かっこ ([ ]) で囲みます。 ワイルドカード文字を含む文字列をブレークポイントのシンボリック名と一致させる場合は、その文字列を引用符 (" ") で囲みます。

環境

アイテム	説明
モード	ユーザー モード、カーネル モード
ターゲット	ライブ デバッグのみ
プラットフォーム	すべて

追加情報

ブレークポイントの使用方法、他のブレークポイント コマンドとブレークポイントの制御方法、カーネル デバッガーからユーザー空間でのブレークポイントの設定方法の詳細と例については、「ブレークポイントの使用」を参照してください。 条件付きブレークポイントの詳細については、「条件付きブレークポイントの設定」を参照してください。

解説

ブレークポイントごとに、このコマンドは次の情報を表示します。

• ブレークポイント ID。 この ID は 10 進数であり、後のコマンドでブレークポイントを参照するために使用できます。

• ブレークポイントのステータス。 ステータスは e (有効) または d (無効) です。

• (未解決のブレークポイントのみ) ブレークポイントが未解決の場合は、文字「u」が表示されます。 つまり、ブレークポイントは、現在読み込まれているモジュールのシンボリック参照と一致しません。 これらのブレークポイントの詳細については、「未解決のブレークポイント (bu ブレークポイント)」を参照してください。

• ブレークポイントの位置を表す仮想アドレスまたはシンボリック式。 ソース行番号の読み込みを有効にした場合、bl コマンドはアドレス オフセットではなく、ファイル名と行番号の情報を表示します。 ブレークポイントが未解決の場合、アドレスはここでは省略され、リストの最後に表示されます。

• (データ ブレークポイントのみ) データ ブレークポイントのタイプとサイズの情報が表示されます。 タイプは e (実行)、r (読み取り/書き込み)、w (書き込み)、または i (入力/出力) です。 これらのタイプの後に、ブロックのサイズ (バイト単位) が続きます。 これらのブレークポイントの詳細については、「プロセッサ ブレークポイント (ba ブレークポイント)」を参照してください。

• ブレークポイントがアクティブになるまでの残り回数と、その後にかっこ内に初期回数が続きます。 この種類のブレークポイントの詳細については、bp, bu, bm (ブレークポイントの設定) の Passes パラメーターの説明を参照してください。

• 関連付けられているプロセスとスレッド。 スレッドが 3 つのアスタリスク (***) として与えられた場合、このブレークポイントはスレッド特有のブレークポイントではありません。

• ブレークポイント アドレスに対応するモジュールと関数 (およびオフセット)。 ブレークポイントが未解決の場合、代わりにブレークポイント アドレスがかっこ内に表示されます。 ブレークポイントが有効なアドレスに設定されているが、シンボル情報がない場合、このフィールドは空白になります。

• このブレークポイントにヒットしたときに自動的に実行されるコマンド。 このコマンドは引用符で囲まれて表示されます。

既存のブレークポイントがどのコマンドを使用して設定されたか不明な場合は、.bpcmds (ブレークポイント コマンドの表示) を使用して、すべてのブレークポイントとそれらを作成するのに使用されたコマンドを一覧表示できます。

次の例は、bl コマンドの出力を示しています。

例

0:000> bl
 0 e 010049e0     0001 (0001)  0:**** stst!main

この出力には、次の情報が含まれています。

• ブレークポイント ID は 0 です。

• ブレークポイントのステータスは e (有効) です。

• ブレークポイントは未解決ではありません (出力には u がありません)。

• ブレークポイントの仮想アドレスは 010049e0 です。

• ブレークポイントはコードの初期実行でアクティブであり、コードはまだデバッガーで実行されていません。 この情報は、「残り回数」カウンターの値が 1 (0001) であり、初期回数カウンターの値が 1 ((0001)) であることで示されます。

• このブレークポイントはスレッド固有のブレークポイント (***) ではありません。

• ブレークポイントは stst モジュールの main に設定されています。