th (Trace to Next Branching Instruction)
La ième commande exécute le programme jusqu’à ce qu’il atteigne n’importe quel type d’instruction de branchement, y compris les branches conditionnelles ou inconditionnelles, les appels, les retours et les appels système.
Mode Utilisateur
[~Thread] th [r] [= StartAddress] [Count]
Mode Noyau
th [r] [= StartAddress] [Count]
Paramètres
Fil
Spécifie les threads pour continuer à s’exécuter. Tous les autres threads sont gelés. Pour plus d’informations sur la syntaxe, veuillez consulter la section Syntaxe des threads. 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 de l’inscription à 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’un d’eux pour remplacer toute utilisation précédente de ces commandes.
Vous pouvez également désactiver l’affichage des registres en utilisant la commande l-os. Ce paramètre est distinct des quatre autres commandes. Pour contrôler les registres et les indicateurs à afficher, utilisez la commande rm (Masque de registre).
StartAddress
Spécifie l’adresse à laquelle le débogueur commence l’exécution. Si vous n’utilisez pas StartAddress, l’exécution commence à l’instruction pointée par le pointeur d’instruction. Pour plus d’informations sur la syntaxe, consultez la syntaxe d’adresse et de plage d’adresses.
Compter
Spécifie le nombre d’instructions de branchement que le débogueur doit rencontrer pour que la ième commande se termine. La valeur par défaut est 1.
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 commandes associées, consultez Contrôle de la cible.
Notes
La ième commande provoque 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 de programme se trouve déjà sur une instruction de branchement, le débogueur effectue une trace 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 Next Branching Instruction).
th est disponible pour toutes les sessions en direct. Cette disponibilité est la principale différence entre th et To (Trace to Next Branch).
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.