Syntaxe Pseudo-Register

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

Le débogueur assigne des pseudo-registres automatiques à 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 une arobase ( @ ) 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'arobase, le débogueur répond plus lentement, car il doit parcourir l'ensemble de la table des 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

Si un symbole existe sous le même nom que le pseudo-registre, vous devez ajouter le signe arobase.

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. (Le symbole @ n’est pas requis ni 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.

Pseudo-registre	Descriptif
$ea	Adresse effective de la dernière instruction exécutée. Si cette instruction n’a pas d’adresse effective, le débogueur affiche « Erreur d’inscription incorrecte ». Si cette instruction comporte deux adresses effectives, le débogueur affiche la première adresse.
$ea 2	Deuxième adresse effective de la dernière instruction exécutée. Si cette instruction n’a pas deux adresses effectives, le débogueur affiche « Erreur d’inscription incorrecte ».
$exp	Dernière expression évaluée.
$ra	Adresse de retour actuellement sur la pile. Cette adresse est particulièrement utile dans les commandes d’exécution. Par exemple, g @$ra continue jusqu’à ce que l’adresse de retour soit trouvée (bien que gu (Go Up) soit un moyen plus précis de « sortir » de la fonction actuelle.
$ip	Registre du pointeur d’instruction. Processeurs x86 : Identique à eip. Processeurs Itanium : Liés à iip. (Pour plus d’informations, consultez la note suivante dans ce tableau.) Processeurs x64 : La même chose que rip.
$eventip	Le pointeur d'instruction au moment de l’événement actuel. Ce pointeur correspond généralement à $ip, sauf si vous avez basculé des threads ou modifié manuellement la valeur du pointeur d’instruction.
$previp	Pointeur d’instruction au moment de l’événement précédent. (Entrer dans le débogueur est considéré comme un événement.)
$relip	Pointeur d’instruction lié à l’événement actuel. Lorsque vous effectuez le traçage de branche, ce pointeur est le pointeur vers la source de la branche.
$scopeip	Pointeur d’instruction pour le contexte local actuel (également appelé étendue).
$exentry	Adresse du point d’entrée du premier exécutable du processus actuel.
$retreg	Registre principal de la valeur de retour. Processeurs x86 : Identique à eax. Processeurs Itanium : Les mêmes que ret0. Processeurs x64 : Identique à rax.
$retreg 64	Registre de la valeur de retour principale, au format 64 bits. Processeur x86 : Identique à la paire edx :eax .
$csp	Pointeur de pile d’appels actuel. Ce pointeur est le registre le plus représentatif de la profondeur de la pile des appels. Processeurs x86 : Identique à esp. Processeurs itanium : Identique à bsp. Processeurs x64 : Identique à rsp.
$p	Valeur imprimée par la dernière commande d* (Mémoire d’affichage).
$proc	Adresse du processus actuel (autrement dit, l’adresse du bloc EPROCESS).
$thread	Adresse du thread actuel. Dans le débogage en mode noyau, cette adresse est l’adresse du bloc ETHREAD. Dans le débogage en mode utilisateur, cette adresse est l’adresse du bloc d’environnement de thread (TEB).
$peb	Adresse du bloc d’environnement de processus (PEB) du processus actuel.
$teb	Adresse du bloc d’environnement de thread (TEB) du thread actuel.
$tpid	ID de processus (PID) du processus propriétaire du thread actuel.
$tid	ID de thread pour le thread actif.
$dtid
$dpid
$dsid
$bp numéroNombre	Adresse du point d’arrêt correspondant. Par exemple, $bp 3 (ou $bp 03) fait référence au point d’arrêt dont l’ID de point d’arrêt est 3. Nombre est toujours un nombre décimal. Si aucun point d’arrêt n’a d’ID de numéro, $bpnombre est égal à zéro. Pour plus d’informations sur les points d’arrêt, consultez Utilisation des points d’arrêt.
$frame	Index de trame actuel. Le numéro d’image de cet index est le même que celui utilisé par la commande .frame (Définir le contexte local).
$dbgtime	Heure actuelle, selon l’ordinateur sur lequel le débogueur s’exécute.
$callret	Valeur de retour de la dernière fonction appelée par .call (fonction d’appel) ou utilisée dans une commande .fnret /s . Le type de données de $callret est le type de données de cette valeur de retour.
$extret
$extin
$clrex
$lastclrex	Débogage managé uniquement : Adresse de l’objet d’exception CLR (Common Language Runtime) rencontré en dernier.
$ptrsize	Taille d’un pointeur. En mode noyau, cette taille est la taille du pointeur sur l’ordinateur cible.
$pagesize	Nombre d’octets dans une page de mémoire. En mode noyau, cette taille est la taille de page sur l’ordinateur cible.
$pcr
$pcrb
$argreg
$exr_chance	Probabilité de l’enregistrement d’exception actuel.
$exr_code	Code d’exception de l’enregistrement d’exception actif.
$exr_numparams	Nombre de paramètres dans l’enregistrement d’exception actuel.
$exr_param0	Valeur du paramètre 0 dans l’enregistrement d’exception actuel.
$exr_param1	Valeur du paramètre 1 dans l’enregistrement d’exception actuel.
$exr_param2	Valeur du paramètre 2 dans l’enregistrement d’exception actuel.
$exr_param3	Valeur du paramètre 3 dans l’enregistrement d’exception actuel.
$exr_param4	Valeur du paramètre 4 dans l’enregistrement d’exception actuel.
$exr_param5	Valeur du paramètre 5 dans l’enregistrement d’exception actuel.
$exr_param6	Valeur du paramètre 6 dans l’enregistrement d’exception actuel.
$exr_param7	Valeur du paramètre 7 dans l’enregistrement d’exception actuel.
$exr_param8	Valeur du paramètre 8 dans l’enregistrement d’exception actuel.
$exr_param9	Valeur du paramètre 9 dans l’enregistrement d’exception actuel.
$exr_param10	Valeur du paramètre 10 dans l’enregistrement d’exception actuel.
$exr_param11	Valeur du paramètre 11 dans l’enregistrement d’exception actuel.
$exr_param12	Valeur du paramètre 12 dans l’enregistrement d’exception actuel.
$exr_param13	Valeur du paramètre 13 dans l’enregistrement d’exception actuel.
$exr_param14	Valeur du paramètre 14 dans l’enregistrement d’exception actuel.
$bug_code	Si une vérification de bogue s’est produite, il s’agit du code de bogue. S’applique au débogage en mode noyau actif et aux vidages sur incident du noyau.
$bug_param1	Si une vérification de bogue s’est produite, il s’agit de la valeur du paramètre 1. S’applique au débogage en mode noyau actif et aux vidages sur incident du noyau.
$bug_param2	Si une vérification de bogue s’est produite, il s’agit de la valeur du paramètre 2. S’applique au débogage en mode noyau actif et aux vidages sur incident du noyau.
$bug_param3	Si une vérification de bogue s’est produite, il s’agit de la valeur du paramètre 3. S’applique au débogage en mode noyau actif et aux vidages de crash du noyau.
$bug_param4	Si une vérification de bogue s’est produite, il s’agit de la valeur du paramètre 4. S’applique au débogage en mode noyau actif et aux vidages sur incident du noyau.

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. Il existe des situations où vous pouvez apprendre des informations de thread à partir de ~ (État du thread), mais pas à partir de $tid. Vous ne pouvez pas utiliser le $previp pseudo-registre sur le premier événement de débogueur. Vous ne pouvez pas utiliser le pseudo-registre $relip sauf si vous effectuez un traçage des branches. Si vous utilisez un pseudo-registre indisponible, une erreur de syntaxe se produit.

Un pseudo-registre qui contient l’adresse d’une structure (par exemple, $thread, $proc, $teb, $peb et $lastclrex) sera é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 toute la structure TEB. Pour plus d’informations, consultez Évaluation des expressions.

Sur un processeur Itanium, le registre iip est aligné sur un 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 le slot. 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 l' $ip pseudo-registre avec un point ( . ). Vous n’ajoutez pas de signe at (@) avant cette période et n’utilisez pas la période 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 à l’alias (par exemple ${ }) et vous ne pouvez pas utiliser de pseudo-registres avec ces jetons.

User-Defined Pseudo-Registers

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 dans 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 (Registers), comme l’illustre 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 l’illustre l’exemple suivant.

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

Un pseudo-registre est toujours typé en tant qu’entier, sauf si vous utilisez le commutateur ? avec la commande r. Si vous utilisez cette option, le pseudo-registre acquiert le type de tout élément qui lui est assigné. Par exemple, la commande suivante affecte 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 lorsque le débogueur est démarré.

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

exemple de

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

kd> bp /t @$thread nt!ntopenfile

exemple de

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 l’exécution conditionnelle dans un fichier de script nommé « eaxstep ».

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

Ensuite, émettez 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.