th (Suivi de l’instruction de branchement suivant)

La commande th exécute le programme jusqu’à ce qu’il atteigne n’importe quel type d’instruction de branche, y compris les branches conditionnelles ou inconditionnelles, les appels, les retours et les appels système.

User-Mode

[~Thread] th [r] [= StartAddress] [Count] 

Kernel-Mode

th [r] [= StartAddress] [Count] 

Paramètres

Fil
Spécifie les threads à exécuter. Tous les autres threads sont figés. Pour plus d’informations sur la syntaxe, consultez Syntaxe de thread. Vous pouvez spécifier des threads uniquement en mode utilisateur.

R
Active et désactive l’affichage des registres et des indicateurs. Par défaut, les registres et les indicateurs sont affichés. Vous pouvez désactiver l’affichage du registre à l’aide des commandes thr, pr, tr ou .prompt_allow -reg. Toutes ces commandes contrôlent le même paramètre et vous pouvez utiliser l’une d’elles pour remplacer toute utilisation précédente de ces commandes.

Vous pouvez également désactiver l’affichage des inscriptions à l’aide de la commande l-os. Ce paramètre est distinct des quatre autres commandes. Pour contrôler les registres et indicateurs affichés, utilisez la commande rm (Register Mask).

StartAddress
Spécifie l’adresse où le débogueur commence l’exécution. Si vous n’utilisez pas StartAddress, l’exécution commence à l’instruction vers laquelle pointe le pointeur d’instruction. Pour plus d’informations sur la syntaxe, consultez Address and Address Range Syntax.

Compter
Spécifie le nombre d’instructions de branchement que le débogueur doit rencontrer pour que la commande th se termine. La valeur par défaut est 1.

Environnement

Élément	Description
Modes	mode utilisateur, mode noyau
Targets	débogage actif uniquement
Plateformes	all

Informations supplémentaires

Pour plus d’informations sur les commandes associées, consultez Contrôle de la cible.

Remarques

La commande th entraîne le début de l’exécution de la cible. L’exécution se poursuit jusqu’à ce que le débogueur atteigne une instruction de branchement ou rencontre un point d’arrêt.

Si le compteur du programme se trouve déjà sur une instruction de branchement, le débogueur effectue des suivis dans l’instruction de branchement et continue à s’exécuter jusqu’à ce qu’une autre instruction de branchement soit atteinte. Ce suivi, plutôt que l’exécution, de l’appel est la seule différence entre th et ph (étape vers l’instruction de branchement suivant).

th est disponible pour toutes les sessions en direct. Cette disponibilité est la principale différence entre th et to (suivi vers la branche suivante).

En mode source, vous pouvez associer une ligne source à plusieurs instructions d’assembly. Cette commande ne s’arrête pas à une instruction de branchement associée à la ligne source actuelle.