summaryrefslogtreecommitdiffstats
path: root/arch/arm-singlestep.c
diff options
context:
space:
mode:
authorMatt Hunter <m@lfurio.us>2025-08-13 01:04:57 -0400
committerMatt Hunter <m@lfurio.us>2025-09-07 06:41:16 -0400
commit4ea8ea650a1d81cf6362e1485d2fdce2617d8d8e (patch)
tree65cddd4d36a4264141f6c8dca1a8a9e91076cc17 /arch/arm-singlestep.c
parentf9c7b14383a99ecc0a1e8266467804647acfaa3e (diff)
downloadmisplays-4ea8ea650a1d81cf6362e1485d2fdce2617d8d8e.tar.gz
misplays-4ea8ea650a1d81cf6362e1485d2fdce2617d8d8e.zip
Add architecture-specific single step support
ARM 32-bit is the first platform added to misplays which lacks underlying hardware support for single step traps - so the kernel does not implement PTRACE_SINGLESTEP in this case. We will work around this in a similar way as gdb does and how the kernel used to do it until 2011. arm_singlestep() implements logic which disassembles the program's current instruction and analyzes it to determine all possible next locations - eg: the next instruction in memory, or the jump target of a branch instruction, etc. This logic is dynamically dispatched by the debugger core if an ARM build is running in 32-bit mode. arm_singlestep() uses breakpoints to stop execution at it's computed next locations. However, misplays is currently very careful about controling the use of breakpoints in order to avoid issues with thread single steps - so a new flag (called "step") is added to breakpoints to enable the debugger to selectively install this subset of breakpoints for each thread's single step action, and more or less keep treating thread free-run as normal. install_breakpoints() is updated to take a "step" parameter to control which set of breakpoints is installed at any given time. resume_threads() is updated to perform this new single step dynamic dispatch, and manage the installation of step breakpoints. add_breakpoint() is also given a "step" parameter. This initializes the flag for the new breakpoint, but crucially is used to sort the new breakpoint into the process breakpoint list. Since step breakpoints will always be installed first, prioritize them in the list so that uninstall_breakpoints() doesn't corrupt memory when it runs the list backward to remove them. Signed-off-by: Matt Hunter <m@lfurio.us>
Diffstat (limited to 'arch/arm-singlestep.c')
-rw-r--r--arch/arm-singlestep.c154
1 files changed, 154 insertions, 0 deletions
diff --git a/arch/arm-singlestep.c b/arch/arm-singlestep.c
new file mode 100644
index 0000000..e98feb3
--- /dev/null
+++ b/arch/arm-singlestep.c
@@ -0,0 +1,154 @@
+#include "arm-singlestep.h"
+
+#ifdef ARCH_AARCH64
+
+static void break_imm(unsigned long address, struct thread *th) {
+ struct breakpoint *b = add_breakpoint(th->proc, address, 1);
+ b->user = 0;
+ b->tid = th->id;
+ b->enabled = -1;
+}
+
+static void break_reg(int reg, struct thread *th) {
+ unsigned long address = 0;
+ unsigned int *regs = th->state->regs.arm32.regs;
+
+ switch (reg) {
+ case ARM_REG_R0: address = regs[0]; break;
+ case ARM_REG_R1: address = regs[1]; break;
+ case ARM_REG_R2: address = regs[2]; break;
+ case ARM_REG_R3: address = regs[3]; break;
+ case ARM_REG_R4: address = regs[4]; break;
+ case ARM_REG_R5: address = regs[5]; break;
+ case ARM_REG_R6: address = regs[6]; break;
+ case ARM_REG_R7: address = regs[7]; break;
+ case ARM_REG_R8: address = regs[8]; break;
+ case ARM_REG_R9: address = regs[9]; break;
+ case ARM_REG_R10: address = regs[10]; break;
+ case ARM_REG_R11: address = regs[11]; break;
+ case ARM_REG_R12: address = regs[12]; break;
+ case ARM_REG_R13: address = regs[13]; break;
+ case ARM_REG_R14: address = regs[14]; break;
+ case ARM_REG_R15: address = regs[15]; break;
+ default: /* todo thread error */ break;
+ }
+
+ break_imm(address, th);
+}
+
+static int is_pc(csh handle, cs_insn *insn) {
+ cs_regs read, write;
+ uint8_t read_size, write_size;
+ cs_regs_access(handle, insn, read, &read_size, write, &write_size);
+
+ for (uint8_t i = 0; i < write_size; i++) {
+ if (write[i] == ARM_REG_PC) {
+ return 1;
+ }
+ }
+
+ return 0;
+}
+
+static uint8_t pc_op(cs_arm_op *ops, uint8_t ops_size) {
+ uint8_t i;
+ for (i = 0; i < ops_size; i++) {
+ if (ops[i].type == ARM_OP_REG && ops[i].reg == ARM_REG_PC) {
+ break;
+ }
+ }
+ return i;
+}
+
+int arm_singlestep(struct thread *th) {
+ struct archinfo archinfo;
+ struct iovec regs = { &th->state->regs, th->state->regsize };
+ architecture_info(&archinfo, &regs);
+
+ int ret = 0;
+ csh handle;
+
+ if (cs_open(archinfo.cs_arch, archinfo.cs_mode, &handle) != CS_ERR_OK) {
+ /* todo thread error */
+ return -1;
+ }
+
+ cs_option(handle, CS_OPT_DETAIL, CS_OPT_ON);
+
+ uint64_t address = archinfo.progmctr;
+ size_t codez = 128;
+ const uint8_t *code = deref(th, address, codez);
+ cs_insn *insn = cs_malloc(handle);
+
+ if (cs_disasm_iter(handle, &code, &codez, &address, insn)) {
+ if (is_pc(handle, insn)) {
+ cs_arm_op *ops = insn->detail->arm.operands;
+ uint8_t ops_size = insn->detail->arm.op_count;
+ uint8_t pci;
+
+ switch (insn->id) {
+ case ARM_INS_B:
+ case ARM_INS_BL:
+ case ARM_INS_BX:
+ case ARM_INS_BLX:
+ if (ops_size == 1) {
+ switch (ops[0].type) {
+ case ARM_OP_REG: break_reg(ops[0].reg, th); break;
+ case ARM_OP_IMM: break_imm(ops[0].imm, th); break;
+ default: ret = -1; /* todo thread error */ break;
+ }
+ } else {
+ ret = -1;
+ /* todo thread error */
+ }
+ break;
+
+ case ARM_INS_POP:
+ if ((pci = pc_op(ops, ops_size)) < ops_size) {
+ unsigned long saddr = archinfo.stackptr + (pci * archinfo.wordsize);
+ unsigned long *sval = deref(th, saddr, archinfo.wordsize);
+ break_imm(*sval, th);
+ } else {
+ ret = -1;
+ /* todo thread error */
+ }
+ break;
+
+ case ARM_INS_MOV:
+ if (pc_op(ops, ops_size) == 0) {
+ if (ops_size == 2) {
+ switch (ops[1].type) {
+ case ARM_OP_REG: break_reg(ops[1].reg, th); break;
+ case ARM_OP_IMM: break_imm(ops[1].imm, th); break;
+ default: ret = -1; /* todo thread error */ break;
+ }
+ } else {
+ ret = -1;
+ /* tr */
+ }
+ } else {
+ ret = -1;
+ /* tr */
+ }
+ break;
+
+ default:
+ ret = -1;
+ /* todo thread error */
+ break;
+ }
+ }
+
+ /* default case - next sequential instruction */
+ break_imm(address, th);
+ } else {
+ ret = -1;
+ /* todo thread error */
+ }
+
+ cs_free(insn, 1);
+ cs_close(&handle);
+ return ret;
+}
+
+#endif