Partager via

bl (Liste des points d’arrêt)

  • Article

La commande bl répertorie des informations sur les points d’arrêt existants.

bl [/L] [Breakpoints]

Paramètres

/L
Force bl à toujours afficher les adresses de point d’arrêt au lieu d’afficher les numéros de ligne et de fichier source.

Points d’arrêt
Spécifie les numéros d’ID des points d’arrêt à répertorier. Si vous omettez des points d’arrêt, le débogueur répertorie tous les points d’arrêt. Vous pouvez spécifier n’importe quel nombre de points d’arrêt. Vous devez séparer plusieurs ID par des espaces ou des virgules. Vous pouvez spécifier une plage d’ID de point d’arrêt à l’aide d’un trait d’union (-). Vous pouvez utiliser un astérisque (*) pour indiquer tous les points d’arrêt. Si vous souhaitez utiliser une expression numérique pour un ID, placez-la entre crochets ([]). Si vous souhaitez utiliser une chaîne avec des caractères génériques pour correspondre au nom symbolique d’un point d’arrêt, placez-la entre guillemets (« »).

Environnement

Élément Description
Modes mode utilisateur, mode noyau
Targets uniquement en débogage
Platforms all

Informations supplémentaires

Pour plus d’informations sur les points d’arrêt et des exemples d’utilisation de points d’arrêt, d’autres commandes et méthodes de contrôle des points d’arrêt et sur la définition des points d’arrêt dans l’espace utilisateur à partir d’un débogueur de noyau, consultez Utilisation de points d’arrêt. Pour plus d’informations sur les points d’arrêt conditionnels, consultez la mise en place d’un point d’arrêt conditionnel.

Notes

Pour chaque point d’arrêt, la commande affiche les informations suivantes :

  • ID du point d’arrêt. Cet ID est un nombre décimal que vous pouvez utiliser pour faire référence au point d’arrêt dans les commandes ultérieures.

  • État du point d’arrêt. L’état peut être e (activé) ou d (désactivé).

  • (Points d’arrêt non résolus uniquement) La lettre « u » apparaît si le point d’arrêt n’est pas résolu. Autrement dit, le point d’arrêt ne correspond pas à une référence symbolique dans un module actuellement chargé. Pour plus d’informations sur ces points d’arrêt, consultez Points d’arrêt non résolus (points d’arrêt bu).

  • Adresse virtuelle ou expression symbolique qui compose l’emplacement du point d’arrêt. Si vous avez activé le chargement du numéro de ligne source, la commande bl affiche les informations de fichier et de numéro de ligne au lieu des décalages d’adresse. Si le point d’arrêt n’est pas résolu, l’adresse est omise ici et apparaît à la fin de la liste à la place.

  • (Points d’arrêt de données uniquement) Les informations de type et de taille sont affichées pour les points d’arrêt de données. Les types peuvent être e (exécuter), r (lecture/écriture), w (écriture) ou i (entrée/sortie). Ces types sont suivis de la taille du bloc, en octets. Pour plus d’informations sur ces points d’arrêt, consultez Les points d’arrêt du processeur (ba Points d’arrêt).

  • Nombre de passes qui restent jusqu’à ce que le point d’arrêt soit activé, suivi du nombre initial de passes entre parenthèses. Pour plus d’informations sur ce type de point d’arrêt, consultez la description du paramètre Passes dans bp, bu, bm (Définir le point d’arrêt).

  • Processus et thread associés. Si le thread est donné sous la forme de trois astérisques (***), ce point d’arrêt n’est pas un point d’arrêt spécifique au thread.

  • Module et fonction, avec offset, qui correspondent à l’adresse du point d’arrêt. Si le point d’arrêt n’est pas résolu, l’adresse du point d’arrêt apparaît ici, entre parenthèses. Si le point d’arrêt est défini sur une adresse valide, mais que les informations de symbole sont manquantes, ce champ est vide.

  • Commande exécutée automatiquement lorsque ce point d’arrêt est atteint. Cette commande s’affiche entre guillemets.

Si vous ne savez pas quelle commande a été utilisée pour définir un point d’arrêt existant, utilisez .bpcmds (Display Breakpoint Commands) pour répertorier tous les points d’arrêt ainsi que les commandes utilisées pour les créer.

L’exemple suivant montre la sortie d’une commande bl .

Exemple

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

Cette sortie contient les informations suivantes :

  • L’ID de point d’arrêt est 0.

  • L’état du point d’arrêt est e (activé).

  • Le point d’arrêt n’est pas résolu (il n’y a pas d’u dans la sortie).

  • L’adresse virtuelle du point d’arrêt est 010049e0.

  • Le point d’arrêt est actif sur le premier passage du code et le code n’a pas encore été exécuté sous le débogueur. Ces informations sont indiquées par une valeur de 1 (0001) dans le compteur « passe restant » et une valeur de 1 ((0001)) dans le compteur de passes initial.

  • Ce point d’arrêt n’est pas un point d’arrêt spécifique au thread (***).

  • Le point d’arrêt est défini sur principal dans le module stst.