ebreak

ebreak

Assembleur RISC-V Référence

lyszt.net couvre ebreak et d'autres instructions RISC-V plus en détail.

Description

Arrête l'exécution comme un point d'arrêt. Dans ebreak, le processeur lève une exception de point d'arrêt au lieu d'exécuter l'instruction suivante. Les débogueurs le placent là où un programme doit s'interrompre pour inspection.

Définition officielle

RISC-V Instruction Set Manual

L'instruction EBREAK est utilisée pour rendre le contrôle à un environnement de débogage.

ℹ
ECALL et EBREAK étaient auparavant nommées SCALL et SBREAK. Les instructions ont la même fonctionnalité et le même encodage, mais ont été renommées pour refléter qu'elles peuvent être utilisées de manière plus générale que pour appeler un système d'exploitation de niveau superviseur ou un débogueur.
slli x0, x0, 0x1f   # Entry NOP
ebreak              # Break to debugger
srai x0, x0, 7      # Exit NOP
ℹ
EBREAK a été principalement conçue pour être utilisée par un débogueur afin de provoquer l'arrêt de l'exécution et le retour dans le débogueur. EBREAK est également utilisée par le compilateur GCC standard pour marquer les chemins de code qui ne doivent pas être exécutés. Un autre usage d'EBREAK est de prendre en charge le « semihosting », où l'environnement d'exécution inclut un débogueur qui peut fournir des services via une interface d'appel système alternative construite autour de l'instruction EBREAK. Comme les ISA de base RISC-V ne fournissent pas plus d'une instruction EBREAK, le semihosting RISC-V utilise une séquence spéciale d'instructions pour distinguer un EBREAK de semihosting d'un EBREAK inséré par un débogueur. Notez que ces trois instructions doivent être des instructions de 32 bits, c'est-à-dire qu'elles ne doivent pas faire partie des instructions compressées de 16 bits décrites dans compressed. Les instructions NOP de décalage sont toujours considérées comme disponibles pour être utilisées comme HINTs. Le semihosting est une forme d'appel de service et serait plus naturellement encodé comme un ECALL utilisant une ABI existante, mais cela nécessiterait que le débogueur puisse intercepter les ECALLs, ce qui est un ajout plus récent à la norme de débogage. Nous avons l'intention de passer à l'utilisation d'ECALLs avec une ABI standard, auquel cas le semihosting pourra partager une ABI de service avec une norme existante. Nous notons que les processeurs ARM sont également passés à l'utilisation de SVC au lieu de BKPT pour les appels de semihosting dans les conceptions plus récentes.