Struct crosvm_direct::crosvm::gdb::GdbStub

pub struct GdbStub {
    vm_tube: Mutex<Tube>,
    vcpu_com: Vec<Sender<VcpuControl>>,
    from_vcpu: Receiver<VcpuDebugStatusMessage>,
    single_step: bool,
    max_hw_breakpoints: Option<usize>,
    hw_breakpoints: Vec<GuestAddress>,
}

Fields

vm_tube: Mutex<Tube>

vcpu_com: Vec<Sender<VcpuControl>>

from_vcpu: Receiver<VcpuDebugStatusMessage>

single_step: bool

max_hw_breakpoints: Option<usize>

hw_breakpoints: Vec<GuestAddress>

Implementations

impl GdbStub

pub fn new(
    vm_tube: Tube,
    vcpu_com: Vec<Sender<VcpuControl>>,
    from_vcpu: Receiver<VcpuDebugStatusMessage>
) -> Self

fn vcpu_request(&self, request: VcpuControl) -> Result<VcpuDebugStatus, Error>

fn vm_request(&self, request: VmRequest) -> Result<(), Error>

fn max_hw_breakpoints_request(&self) -> TargetResult<usize, Self>

Trait Implementations

impl Breakpoints for GdbStub

fn support_hw_breakpoint(&mut self) -> Option<HwBreakpointOps<'_, Self>>

Support for setting / removing hardware breakpoints.

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

Support for setting / removing software breakpoints.

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

Support for setting / removing hardware watchpoints.

impl HwBreakpoint for GdbStub

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

Add a new hardware breakpoint. Return Ok(false) if the operation could not be completed.

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

Remove an existing hardware breakpoint. Return Ok(false) if the operation could not be completed.

impl SingleRegisterAccess<()> for GdbStub

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 SingleThreadBase for GdbStub

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<(), Self>

Read bytes from the specified address range.

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_resume(&mut self) -> Option<SingleThreadResumeOps<'_, Self>>

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

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

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

impl SingleThreadResume for GdbStub

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<&mut dyn SingleThreadRangeStepping<Error = Self::Error, Arch = Self::Arch>>

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 SingleThreadSingleStep for GdbStub

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

Single step the target.

impl Target for GdbStub

type Arch = X86_64_SSE

The target’s architecture.

type Error = &'static str

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 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 guard_rail_single_step_gdb_behavior(&self) -> SingleStepGdbBehavior

Override the arch-level value for [Arch::single_step_gdb_behavior].

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_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_catch_syscalls(
    &mut self
) -> Option<&mut dyn CatchSyscalls<Error = Self::Error, Arch = Self::Arch>>

Support for setting / removing syscall catchpoints.

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.