Struct GdbStubHandler

pub struct GdbStubHandler<DL>
where
    DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,
{
    pub machine: MachineAssign<DL>,
    /* private fields */
}

Fields

machine: MachineAssign<DL>

Implementations

impl<DL> GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

pub fn new(machine: MachineAssign<DL>) -> Self

impl<DL> GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

pub fn run_till_exited(self) -> Result<(i8, u64), Error>

Trait Implementations

impl<DL> Breakpoints for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn support_sw_breakpoint(&mut self) -> Option<SwBreakpointOps<'_, Self>>

Support for setting / removing software breakpoints.

fn support_hw_watchpoint(&mut self) -> Option<HwWatchpointOps<'_, Self>>

Support for setting / removing hardware watchpoints.

fn support_hw_breakpoint( &mut self, ) -> Option<&mut dyn HwBreakpoint<Error = Self::Error, Arch = Self::Arch>>

Support for setting / removing hardware breakpoints.

impl<DL> CatchSyscalls for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn enable_catch_syscalls( &mut self, filter: Option<SyscallNumbers<'_, <Self::Arch as Arch>::Usize>>, ) -> TargetResult<(), Self>

Enables catching syscalls from the inferior process.

fn disable_catch_syscalls(&mut self) -> TargetResult<(), Self>

Disables catching syscalls from the inferior process.

impl<DL> CoreMachine for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

type REG = u64

type MEM = GdbStubHandler<DL>

fn pc(&self) -> &Self::REG

fn update_pc(&mut self, pc: Self::REG)

fn commit_pc(&mut self)

fn memory(&self) -> &Self::MEM

fn memory_mut(&mut self) -> &mut Self::MEM

fn registers(&self) -> &[Self::REG]

fn set_register(&mut self, idx: usize, value: Self::REG)

fn version(&self) -> u32

fn isa(&self) -> u8

impl<DL> HwWatchpoint for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn add_hw_watchpoint( &mut self, addr: <Self::Arch as Arch>::Usize, _len: <Self::Arch as Arch>::Usize, kind: WatchKind, ) -> TargetResult<bool, Self>

Add a new hardware watchpoint. The number of bytes to watch is specified by len.

fn remove_hw_watchpoint( &mut self, addr: <Self::Arch as Arch>::Usize, _len: <Self::Arch as Arch>::Usize, kind: WatchKind, ) -> TargetResult<bool, Self>

Remove an existing hardware watchpoint. The number of bytes to watch is specified by len.

impl<DL> Machine for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn ecall(&mut self) -> Result<(), Error>

fn ebreak(&mut self) -> Result<(), Error>

impl<DL> Memory for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

type REG = u64

fn new() -> Self

fn new_with_memory(_: usize) -> Self

fn memory_size(&self) -> usize

fn load_bytes(&mut self, addr: u64, size: u64) -> Result<Bytes, Error>

fn lr(&self) -> &<Self as Memory>::REG

fn set_lr(&mut self, addr: &<Self as Memory>::REG)

fn init_pages( &mut self, addr: u64, size: u64, flags: u8, source: Option<Bytes>, offset_from_addr: u64, ) -> Result<(), Error>

fn fetch_flag(&mut self, page: u64) -> Result<u8, Error>

fn set_flag(&mut self, page: u64, flag: u8) -> Result<(), Error>

fn clear_flag(&mut self, page: u64, flag: u8) -> Result<(), Error>

fn store_byte(&mut self, addr: u64, size: u64, value: u8) -> Result<(), Error>

fn store_bytes(&mut self, addr: u64, value: &[u8]) -> Result<(), Error>

fn execute_load16(&mut self, addr: u64) -> Result<u16, Error>

fn execute_load32(&mut self, addr: u64) -> Result<u32, Error>

fn load8(&mut self, addr: &Self::REG) -> Result<Self::REG, Error>

fn load16(&mut self, addr: &Self::REG) -> Result<Self::REG, Error>

fn load32(&mut self, addr: &Self::REG) -> Result<Self::REG, Error>

fn load64(&mut self, addr: &Self::REG) -> Result<Self::REG, Error>

fn store8(&mut self, addr: &Self::REG, value: &Self::REG) -> Result<(), Error>

fn store16(&mut self, addr: &Self::REG, value: &Self::REG) -> Result<(), Error>

fn store32(&mut self, addr: &Self::REG, value: &Self::REG) -> Result<(), Error>

fn store64(&mut self, addr: &Self::REG, value: &Self::REG) -> Result<(), Error>

fn memory_pages(&self) -> usize

impl<DL> SingleRegisterAccess<()> for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn read_register( &mut self, _tid: (), reg_id: <Self::Arch as Arch>::RegId, buf: &mut [u8], ) -> TargetResult<usize, Self>

Read to a single register on the target.

fn write_register( &mut self, _tid: (), reg_id: <Self::Arch as Arch>::RegId, val: &[u8], ) -> TargetResult<(), Self>

Write from a single register on the target.

impl<DL> SingleThreadBase for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn read_registers( &mut self, regs: &mut <Self::Arch as Arch>::Registers, ) -> TargetResult<(), Self>

Read the target’s registers.

fn write_registers( &mut self, regs: &<Self::Arch as Arch>::Registers, ) -> TargetResult<(), Self>

Write the target’s registers.

fn read_addrs( &mut self, start_addr: <Self::Arch as Arch>::Usize, data: &mut [u8], ) -> TargetResult<usize, Self>

Read bytes from the specified address range and return the number of bytes that were read.

fn write_addrs( &mut self, start_addr: <Self::Arch as Arch>::Usize, data: &[u8], ) -> TargetResult<(), Self>

Write bytes to the specified address range.

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

Support for single-register access. See SingleRegisterAccess for more details.

fn support_resume(&mut self) -> Option<SingleThreadResumeOps<'_, Self>>

Support for resuming the target (e.g: via continue or step)

impl<DL> SingleThreadRangeStepping for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn resume_range_step(&mut self, start: u64, end: u64) -> Result<(), Self::Error>

Range step the target.

impl<DL> SingleThreadResume for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn resume(&mut self, signal: Option<Signal>) -> Result<(), Self::Error>

Resume execution on the target.

fn support_single_step(&mut self) -> Option<SingleThreadSingleStepOps<'_, Self>>

Support for optimized single stepping.

fn support_range_step( &mut self, ) -> Option<SingleThreadRangeSteppingOps<'_, Self>>

Support for optimized range stepping.

fn support_reverse_step( &mut self, ) -> Option<&mut dyn ReverseStep<(), Error = Self::Error, Arch = Self::Arch>>

Support for reverse stepping a target.

fn support_reverse_cont( &mut self, ) -> Option<&mut dyn ReverseCont<(), Error = Self::Error, Arch = Self::Arch>>

Support for reverse continuing a target.

impl<DL> SingleThreadSingleStep for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn step(&mut self, signal: Option<Signal>) -> Result<(), Self::Error>

Single step the target.

impl<DL> SwBreakpoint for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

fn add_sw_breakpoint( &mut self, addr: <Self::Arch as Arch>::Usize, _kind: <Self::Arch as Arch>::BreakpointKind, ) -> TargetResult<bool, Self>

Add a new software breakpoint.

fn remove_sw_breakpoint( &mut self, addr: <Self::Arch as Arch>::Usize, _kind: <Self::Arch as Arch>::BreakpointKind, ) -> TargetResult<bool, Self>

Remove an existing software breakpoint.

impl<DL> Target for GdbStubHandler<DL>

where DL: CellDataProvider + HeaderProvider + ExtensionProvider + Send + Sync + Clone + 'static,

type Arch = Riscv64

The target’s architecture.

type Error = Error

A target-specific fatal error.

fn base_ops(&mut self) -> BaseOps<'_, Self::Arch, Self::Error>

Base operations such as reading/writing from memory/registers, stopping/resuming the target, etc….

fn support_breakpoints(&mut self) -> Option<BreakpointsOps<'_, Self>>

Support for setting / removing breakpoints.

fn support_catch_syscalls(&mut self) -> Option<CatchSyscallsOps<'_, Self>>

Support for setting / removing syscall catchpoints.

fn guard_rail_implicit_sw_breakpoints(&self) -> bool

If the target supports resumption, but hasn’t implemented explicit support for software breakpoints (via SwBreakpoints), notify the user that the GDB client may set “implicit” software breakpoints by rewriting the target’s instruction stream.

fn use_no_ack_mode(&self) -> bool

Enable/disable support for activating “no ack mode”.

fn use_x_upcase_packet(&self) -> bool

Enable/disable using the more efficient X packet to write to target memory (as opposed to the basic M packet).

fn use_resume_stub(&self) -> bool

Whether gdbstub should provide a “stub” resume implementation on targets without support for resumption.

fn use_rle(&self) -> bool

Enable/Disable the use of run-length encoding on outgoing packets.

fn use_target_description_xml(&self) -> bool

Whether to send a target description XML to the client.

fn use_lldb_register_info(&self) -> bool

(LLDB extension) Whether to send register information to the client.

fn support_monitor_cmd( &mut self, ) -> Option<&mut dyn MonitorCmd<Error = Self::Error, Arch = Self::Arch>>

Support for handling custom GDB monitor commands.

fn support_extended_mode( &mut self, ) -> Option<&mut dyn ExtendedMode<Error = Self::Error, Arch = Self::Arch>>

Support for Extended Mode operations.

fn support_section_offsets( &mut self, ) -> Option<&mut dyn SectionOffsets<Error = Self::Error, Arch = Self::Arch>>

Support for handling requests to get the target’s current section (or segment) offsets.

fn support_tracepoints( &mut self, ) -> Option<&mut dyn Tracepoints<Error = Self::Error, Arch = Self::Arch>>

Support for setting / removing tracepoints.

fn support_target_description_xml_override( &mut self, ) -> Option<&mut dyn TargetDescriptionXmlOverride<Error = Self::Error, Arch = Self::Arch>>

Support for overriding the target description XML specified by Target::Arch.

fn support_lldb_register_info_override( &mut self, ) -> Option<&mut dyn LldbRegisterInfoOverride<Error = Self::Error, Arch = Self::Arch>>

(LLDB extension) Support for overriding the register info specified by Target::Arch.

fn support_memory_map( &mut self, ) -> Option<&mut dyn MemoryMap<Error = Self::Error, Arch = Self::Arch>>

Support for reading the target’s memory map.

fn support_host_io( &mut self, ) -> Option<&mut dyn HostIo<Error = Self::Error, Arch = Self::Arch>>

Support for Host I/O operations.

fn support_exec_file( &mut self, ) -> Option<&mut dyn ExecFile<Error = Self::Error, Arch = Self::Arch>>

Support for reading the current exec-file.

fn support_auxv( &mut self, ) -> Option<&mut dyn Auxv<Error = Self::Error, Arch = Self::Arch>>

Support for reading the target’s Auxillary Vector.

fn support_libraries_svr4( &mut self, ) -> Option<&mut dyn LibrariesSvr4<Error = Self::Error, Arch = Self::Arch>>

Support for reading a list of libraries for SVR4 (System-V/Unix) platforms.