bl (Haltepunktliste)

  • Artikel

Der Befehl bl listet Informationen zu vorhandenen Haltepunkten auf.

bl [/L] [Breakpoints]

Parameter

/L
Erzwingt bl , um Haltepunktadressen immer anzuzeigen, anstatt Quelldatei- und Zeilennummern anzuzeigen.

Haltepunkte
Gibt die ID-Nummern der zu listenden Haltepunkte an. Wenn Sie Haltepunkte weglassen, listet der Debugger alle Haltepunkte auf. Sie können eine beliebige Anzahl von Haltepunkten angeben. Sie müssen mehrere IDs durch Leerzeichen oder Kommas trennen. Sie können einen Bereich von Haltepunkt-IDs mithilfe eines Bindestrichs (-) angeben. Sie können ein Sternchen (*) verwenden, um alle Haltepunkte anzugeben. Wenn Sie einen numerischen Ausdruck für eine ID verwenden möchten, schließen Sie ihn in eckige Klammern ([]) ein. Wenn Sie eine Zeichenfolge mit Wildcardzeichen verwenden möchten, um dem symbolischen Namen eines Haltepunkts zu entsprechen, schließen Sie sie in Anführungszeichen ein ("").

Environment

Element Beschreibung
Modi Benutzermodus, Kernelmodus
Targets Nur Livedebugging
Plattformen Alle

Zusätzliche Informationen

Weitere Informationen und Beispiele für die Verwendung von Haltepunkten, andere Haltepunktbefehle und Methoden zum Steuern von Haltepunkten sowie das Festlegen von Haltepunkten im Benutzerbereich aus einem Kerneldebugger finden Sie unter Verwenden von Haltepunkten. Weitere Informationen zu bedingten Haltepunkten finden Sie unter Festlegen eines bedingten Haltepunkts.

Hinweise

Für jeden Haltepunkt zeigt der Befehl die folgenden Informationen an:

  • Die Haltepunkt-ID. Diese ID ist eine Dezimalzahl, mit der Sie in späteren Befehlen auf den Haltepunkt verweisen können.

  • Der Haltepunktstatus. Der Status kann e (aktiviert) oder d (deaktiviert) sein.

  • (Nur nicht aufgelöste Haltepunkte) Der Buchstabe "u" wird angezeigt, wenn der Haltepunkt nicht aufgelöst ist. Das heißt, der Haltepunkt stimmt nicht mit einem symbolischen Verweis in einem aktuell geladenen Modul überein. Informationen zu diesen Haltepunkten finden Sie unter Unresolved Breakpoints (bu Breakpoints).

  • Die virtuelle Adresse oder der symbolische Ausdruck, aus dem der Haltepunktstandort besteht. Wenn Sie das Laden der Quellzeilennummer aktiviert haben, zeigt der Befehl bl Datei- und Zeilennummerninformationen anstelle von Adressversatzen an. Wenn der Haltepunkt nicht aufgelöst ist, wird die Adresse hier weggelassen und stattdessen am Ende der Auflistung angezeigt.

  • (Nur Datenhaltepunkte) Typ- und Größeninformationen werden für Datenhaltepunkte angezeigt. Die Typen können e (execute), r (Lese-/Schreibzugriff), w (Schreiben) oder i (Eingabe/Ausgabe) sein. Diese Typen werden mit der Größe des Blocks in Byte befolgt. Informationen zu diesen Haltepunkten finden Sie unter Processor Breakpoints (ba Breakpoints).

  • Die Anzahl der Pässe, die verbleiben, bis der Haltepunkt aktiviert ist, gefolgt von der anfänglichen Anzahl von Durchgängen in Klammern. Weitere Informationen zu dieser Art von Haltepunkt finden Sie in der Beschreibung des Pass-Parameters in bp, bu, bm (Set Breakpoint).

  • Der zugeordnete Prozess und Thread. Wenn thread als drei Sternchen (***) angegeben wird, ist dieser Haltepunkt kein threadspezifischer Haltepunkt.

  • Das Modul und die Funktion mit Offset, das der Haltepunktadresse entspricht. Wenn der Haltepunkt nicht aufgelöst ist, wird stattdessen die Haltepunktadresse in Klammern angezeigt. Wenn der Haltepunkt für eine gültige Adresse festgelegt ist, aber Symbolinformationen fehlen, ist dieses Feld leer.

  • Der Befehl, der automatisch ausgeführt wird, wenn dieser Haltepunkt erreicht wird. Dieser Befehl wird in Anführungszeichen angezeigt.

Wenn Sie nicht sicher sind, welcher Befehl zum Festlegen eines vorhandenen Haltepunkts verwendet wurde, verwenden Sie BPCMDS (Haltepunktbefehle anzeigen), um alle Haltepunkte zusammen mit den Befehlen aufzulisten, die zum Erstellen verwendet wurden.

Das folgende Beispiel zeigt die Ausgabe eines Bl-Befehls .

Beispiel

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

Diese Ausgabe enthält die folgenden Informationen:

  • Die Haltepunkt-ID ist 0.

  • Der Haltepunktstatus ist e (aktiviert).

  • Der Haltepunkt ist nicht aufgelöst (es gibt keine u in der Ausgabe).

  • Die virtuelle Adresse des Haltepunkts ist 010049e0.

  • Der Haltepunkt ist für den ersten Durchlauf des Codes aktiv, und der Code wurde noch nicht unter dem Debugger ausgeführt. Diese Informationen werden durch einen Wert von 1 (0001) im "verbleibenden" Zähler und einen Wert von 1 ((0001)) im anfangsdurchlaufzähler angegeben.

  • Dieser Haltepunkt ist kein threadspezifischer Haltepunkt (***).

  • Der Haltepunkt wird im Hauptmodul festgelegt.