Struct TwizzlerTarget

pub struct TwizzlerTarget {
    recv: Receiver<Event<MultiThreadStopReason<u64>>>,
    inner: Arc<TargetInner>,
    mon_t: Option<JoinHandle<()>>,
    chan_t: Option<JoinHandle<()>>,
    t_t: Option<JoinHandle<()>>,
    thread_repr_id: ObjID,
    libs: Vec<(String, ObjID, u64, Box<LinkMap>)>,
}

Fields

recv: Receiver<Event<MultiThreadStopReason<u64>>>

inner: Arc<TargetInner>

mon_t: Option<JoinHandle<()>>

chan_t: Option<JoinHandle<()>>

t_t: Option<JoinHandle<()>>

thread_repr_id: ObjID

libs: Vec<(String, ObjID, u64, Box<LinkMap>)>

Implementations

impl TwizzlerTarget

pub fn new(comp: CompartmentHandle, conn: Sender<u8>) -> Self

fn mem_access( &mut self, addr: <<TwizzlerTarget as Target>::Arch as Arch>::Usize, len: usize, prot: Protections, ) -> TargetResult<usize, Self>

fn mem_slice( &mut self, addr: <<TwizzlerTarget as Target>::Arch as Arch>::Usize, len: usize, ) -> TargetResult<&[u8], Self>

fn mem_slice_mut( &mut self, addr: <<TwizzlerTarget as Target>::Arch as Arch>::Usize, len: usize, ) -> TargetResult<&mut [u8], Self>

fn mem_slice_mut_writable( &mut self, addr: <<TwizzlerTarget as Target>::Arch as Arch>::Usize, len: usize, ) -> Result<RefSliceMut<'_, u8>, TwzError>

fn get_thread_repr_id(&self, _tid: Tid) -> ObjID

Trait Implementations

impl Breakpoints for TwizzlerTarget

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

Support for setting / removing software breakpoints.

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

Support for setting / removing hardware breakpoints.

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

Support for setting / removing hardware watchpoints.

impl Drop for TwizzlerTarget

fn drop(&mut self)

Executes the destructor for this type.

impl ExecFile for TwizzlerTarget

fn get_exec_file( &self, pid: Option<Pid>, offset: u64, length: usize, buf: &mut [u8], ) -> TargetResult<usize, Self>

Get full absolute path of the file that was executed to create process pid running on the remote system.

impl HostIo for TwizzlerTarget

fn support_open(&mut self) -> Option<HostIoOpenOps<'_, Self>>

Support open operation.

fn support_close(&mut self) -> Option<HostIoCloseOps<'_, Self>>

Support close operation.

fn support_pread(&mut self) -> Option<HostIoPreadOps<'_, Self>>

Support pread operation.

fn support_fstat(&mut self) -> Option<HostIoFstatOps<'_, Self>>

Support fstat operation.

fn support_readlink(&mut self) -> Option<HostIoReadlinkOps<'_, Self>>

Support readlink operation.

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

Support pwrite operation.

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

Support unlink operation.

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

Support setfs operation.

impl HostIoClose for TwizzlerTarget

fn close(&mut self, fd: u32) -> HostIoResult<(), Self>

Close the open file corresponding to fd.

impl HostIoFstat for TwizzlerTarget

fn fstat(&mut self, fd: u32) -> HostIoResult<HostIoStat, Self>

Get information about the open file corresponding to fd.

impl HostIoOpen for TwizzlerTarget

fn open( &mut self, filename: &[u8], flags: HostIoOpenFlags, mode: HostIoOpenMode, ) -> HostIoResult<u32, Self>

Open a file at filename and return a file descriptor for it, or return [HostIoError::Errno] if an error occurs.

impl HostIoPread for TwizzlerTarget

fn pread( &mut self, fd: u32, count: usize, offset: u64, buf: &mut [u8], ) -> HostIoResult<usize, Self>

Read data from the open file corresponding to fd.

impl HostIoReadlink for TwizzlerTarget

fn readlink( &mut self, filename: &[u8], buf: &mut [u8], ) -> HostIoResult<usize, Self>

Read value of symbolic link filename on the target.

impl LibrariesSvr4 for TwizzlerTarget

fn get_libraries_svr4( &self, offset: u64, length: usize, buf: &mut [u8], ) -> TargetResult<usize, Self>

Get library list XML for this target.

impl MultiThreadBase for TwizzlerTarget

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

Read the target’s registers.

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

Write the target’s registers.

fn read_addrs( &mut self, start_addr: <Self::Arch as Arch>::Usize, data: &mut [u8], tid: Tid, ) -> 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], tid: Tid, ) -> TargetResult<(), Self>

Write bytes to the specified address range.

fn list_active_threads( &mut self, thread_is_active: &mut dyn FnMut(Tid), ) -> Result<(), Self::Error>

List all currently active threads.

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

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

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

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

fn is_thread_alive(&mut self, tid: NonZero<usize>) -> Result<bool, Self::Error>

Check if the specified thread is alive.

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

Support for providing thread extra information.

impl MultiThreadResume for TwizzlerTarget

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

Resume execution on the target.

fn clear_resume_actions(&mut self) -> Result<(), Self::Error>

Clear all previously set resume actions.

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

Continue the specified thread.

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

Support for optimized single stepping.

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

Support for optimized range stepping.

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

Support for reverse stepping a target.

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

Support for reverse continuing a target.

impl MultiThreadSingleStep for TwizzlerTarget

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

Single step the specified target thread.

impl SwBreakpoint for TwizzlerTarget

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 Target for TwizzlerTarget

type Arch = X86_64_SSE

The target’s architecture.

type Error = TwzError

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

Support for reading the current exec-file.

fn support_host_io(&mut self) -> Option<HostIoOps<'_, Self>>

Support for Host I/O operations.

fn support_libraries_svr4(&mut self) -> Option<LibrariesSvr4Ops<'_, Self>>

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

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

Support for setting / removing breakpoints.

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

Support for handling custom GDB monitor commands.

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

Support for Extended Mode operations.

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

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

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

Support for setting / removing tracepoints.

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

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

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

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

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

Support for reading the target’s memory map.

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

Support for flash memory operations.

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

Support for setting / removing syscall catchpoints.

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

Support for reading the target’s Auxillary Vector.