syntaxe Pseudo-Register

Le débogueur prend en charge plusieurs pseudo-registres qui contiennent certaines valeurs.

Le débogueur définit des pseudo-registres automatiques sur certaines valeurs utiles. Les pseudo-registres définis par l’utilisateur sont des variables entières que vous pouvez écrire ou lire.

Tous les pseudo-registres commencent par un signe dollar ($). Si vous utilisez la syntaxe MASM, vous pouvez ajouter un signe at ( @ ) avant le signe dollar. Ce signe indique au débogueur que le jeton suivant est un registre ou un pseudo-registre, et non un symbole. Si vous omettez l’élément au signe, le débogueur répond plus lentement, car il doit rechercher l’ensemble de la table de symboles.

Par exemple, les deux commandes suivantes produisent la même sortie, mais la deuxième commande est plus rapide.

0:000> ? $exp
Evaluate expression: 143 = 0000008f
0:000> ? @$exp
Evaluate expression: 143 = 0000008f

S’il existe un symbole portant le même nom que le pseudo-registre, vous devez ajouter le signe at.

Si vous utilisez la syntaxe d’expression C++, le signe at ( @ ) est toujours requis.

La commande r (Registers) est une exception à cette règle. Le débogueur interprète toujours son premier argument comme un registre ou un pseudo-registre. (Un signe à l’heure n’est pas obligatoire ou autorisé.) S’il existe un deuxième argument pour la commande r , il est interprété en fonction de la syntaxe d’expression par défaut. Si la syntaxe d’expression par défaut est C++, vous devez utiliser la commande suivante pour copier le pseudo-registre $t 2 dans le pseudo-registre $t 1 .

0:000> r $t1 = @$t2

Pseudo-Registers automatique

Le débogueur définit automatiquement les pseudo-registres suivants.

Certains de ces pseudo-registres peuvent ne pas être disponibles dans certains scénarios de débogage. Par exemple, vous ne pouvez pas utiliser $peb, $tid et $tpid lorsque vous déboguez un minidump en mode utilisateur ou certains fichiers de vidage en mode noyau. Dans certaines situations, vous pouvez apprendre les informations de thread à partir de ~ (État du thread), mais pas à partir de $tid. Vous ne pouvez pas utiliser le $previp pseudo-inscription sur le premier événement de débogueur. Vous ne pouvez pas utiliser le pseudo-enregistrement $relip , sauf si vous effectuez un suivi de branche. Si vous utilisez un pseudo-registre non disponible, une erreur de syntaxe se produit.

Un pseudo-registre qui contient l’adresse d’une structure (par exemple , $thread, $proc, $teb, $peb et $lastclrex ) est évalué en fonction du type de données approprié dans l’évaluateur d’expression C++, mais pas dans l’évaluateur d’expression MASM. Par exemple, la commande ? $teb affiche l’adresse du TEB, tandis que la commande ?? @$teb affiche l’ensemble de la structure TEB. Pour plus d’informations, consultez Évaluation des expressions.

Sur un processeur Itanium, le registre iip est aligné sur le bundle, ce qui signifie qu’il pointe vers l’emplacement 0 dans le bundle contenant l’instruction actuelle, même si un autre emplacement est exécuté. Iip n’est donc pas le pointeur d’instruction complet. Le pseudo-registre $ip est le pointeur d’instruction réel, y compris le bundle et l’emplacement. Les autres pseudo-registres qui contiennent des pointeurs d’adresse ($ra, $retreg, $eventip, $previp, $relip et $exentry) ont la même structure que $ip sur tous les processeurs.

Vous pouvez utiliser la commande r pour modifier la valeur de $ip. Cette modification modifie également automatiquement le registre correspondant. Lorsque l’exécution reprend, elle reprend à la nouvelle adresse du pointeur d’instruction. Ce registre est le seul pseudo-registre automatique que vous pouvez modifier manuellement.

Note Dans la syntaxe MASM, vous pouvez indiquer la $ip pseudo-inscription avec un point ( ). Vous n’ajoutez pas de signe at (@) avant cette période et n’utilisez pas le point comme premier paramètre de la commande r . Cette syntaxe n’est pas autorisée dans une expression C++.

Les pseudo-registres automatiques sont similaires aux alias automatiques. Toutefois, vous pouvez utiliser des alias automatiques avec des jetons liés aux alias (tels que ${ }), et vous ne pouvez pas utiliser de pseudo-registres avec ces jetons.

Pseudo-Registers définies par l’utilisateur

Il existe 20 pseudo-registres définis par l’utilisateur ($t 0, $t 1, ..., $t 19). Ces pseudo-registres sont des variables que vous pouvez lire et écrire via le débogueur. Vous pouvez stocker n’importe quelle valeur entière dans ces pseudo-registres. Elles peuvent être particulièrement utiles en tant que variables de boucle.

Pour écrire dans l’un de ces pseudo-registres, utilisez la commande r (Registres), comme le montre l’exemple suivant.

0:000> r $t0 = 7
0:000> r $t1 = 128*poi(MyVar)

Comme tous les pseudo-registres, vous pouvez utiliser le pseudo-registre défini par l’utilisateur dans n’importe quelle expression, comme le montre l’exemple suivant.

0:000> bp $t3 
0:000> bp @$t4 
0:000> ?? @$t1 + 4*@$t2 

Un pseudo-registre est toujours tapé en tant qu’entier, sauf si vous utilisez le commutateur ? avec la commande r . Si vous utilisez ce commutateur, le pseudo-registre acquiert le type de ce qui lui est affecté. Par exemple, la commande suivante attribue le type UNICODE_STRING** et la valeur 0x0012FFBC à $t 15.

0:000> r? $t15 = * (UNICODE_STRING*) 0x12ffbc

Les pseudo-registres définis par l’utilisateur utilisent zéro comme valeur par défaut au démarrage du débogueur.

Note Les alias $u 0, $u 1, ..., $u 9 ne sont pas des pseudo-registres, malgré leur apparence similaire. Pour plus d’informations sur ces alias, consultez Utilisation d’alias.

Exemple

L’exemple suivant définit un point d’arrêt qui est atteint chaque fois que le thread actuel appelle NtOpenFile. Toutefois, ce point d’arrêt n’est pas atteint lorsque d’autres threads appellent NtOpenFile.

kd> bp /t @$thread nt!ntopenfile

Exemple

L’exemple suivant exécute une commande jusqu’à ce que le registre contienne une valeur spécifiée. Tout d’abord, placez le code suivant pour le pas à pas conditionnel dans un fichier de script nommé « eaxstep ».

.if (@eax == 1234) { .echo 1234 } .else { t "$<eaxstep" }

Ensuite, exécutez la commande suivante.

t "$<eaxstep"

Le débogueur effectue une étape, puis exécute votre commande. Dans ce cas, le débogueur exécute le script, qui affiche 1234 ou répète le processus.