v5gdb 0.1.0-alpha.2

GDB-compatible debugger backend for the VEX V5 platform
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use gdbstub::{
    common::Tid,
    target::{
        TargetResult,
        ext::{
            base::{
                multithread::{MultiThreadBase, MultiThreadResumeOps},
                single_register_access::SingleRegisterAccessOps,
                singlethread::SingleThreadBase,
            },
            thread_extra_info::{ThreadExtraInfo, ThreadExtraInfoOps},
        },
    },
};

use crate::{
    exceptions::DebugEventContext, gdb_target::V5Target, sys::{DebuggerSystem, System}
};

impl MultiThreadBase for V5Target {
    #[inline(always)]
    fn list_active_threads(
        &mut self,
        thread_is_active: &mut dyn FnMut(Tid),
    ) -> Result<(), Self::Error> {
        System::all_threads(thread_is_active);
        Ok(())
    }

    fn is_thread_alive(&mut self, tid: Tid) -> Result<bool, Self::Error> {
        Ok(System::thread_exists(tid))
    }

    fn support_thread_extra_info(&mut self) -> Option<ThreadExtraInfoOps<'_, Self>> {
        Some(self)
    }

    fn read_registers(&mut self, regs: &mut DebugEventContext, tid: Tid) -> TargetResult<(), Self> {
        if tid == System::current_thread() {
            <Self as SingleThreadBase>::read_registers(self, regs)
        } else {
            *regs = System::read_registers(tid)?;
            Ok(())
        }
    }

    fn write_registers(&mut self, regs: &DebugEventContext, tid: Tid) -> TargetResult<(), Self> {
        if tid == System::current_thread() {
            <Self as SingleThreadBase>::write_registers(self, regs)
        } else {
            // SAFETY: We trust that GDB will not corrupt system state.
            unsafe {
                System::write_registers(tid, regs)?;
            }
            Ok(())
        }
    }

    fn read_addrs(
        &mut self,
        start_addr: u32,
        data: &mut [u8],
        _tid: Tid,
    ) -> TargetResult<usize, Self> {
        <Self as SingleThreadBase>::read_addrs(self, start_addr, data)
    }

    fn write_addrs(&mut self, start_addr: u32, data: &[u8], _tid: Tid) -> TargetResult<(), Self> {
        <Self as SingleThreadBase>::write_addrs(self, start_addr, data)
    }

    fn support_resume(&mut self) -> Option<MultiThreadResumeOps<'_, Self>> {
        Some(self)
    }

    fn support_single_register_access(&mut self) -> Option<SingleRegisterAccessOps<'_, Tid, Self>> {
        Some(self)
    }
}

impl ThreadExtraInfo for V5Target {
    fn thread_extra_info(&self, tid: Tid, buf: &mut [u8]) -> Result<usize, Self::Error> {
        Ok(System::read_thread_name(tid, buf).unwrap_or(0))
    }
}