Struct ptracer::Ptracer

pub struct Ptracer { /* fields omitted */ }

Ptrace wraps ptrace syscalls to enable writing an debugger.

WARNING: Only one concurrent instance is currently supported!

Implementations

impl Ptracer

pub fn spawn(path: &Path, args: &[String]) -> Result<Self>

Spawn a new debugee.

Set ptrace options for exec/fork/exit variants.
Disable ASLR (linux only).

WARNING: Only one concurrent instance is currently supported!

pub fn insert_breakpoint(&mut self, address: usize) -> Result<()>

Insert a new breakpoint.

If breakpoint exists, do nothing.

pub fn enable_breakpoint(&mut self, address: usize) -> Result<()>

Enable a breakpoint.

If breakpoint does not exists, do nothing.
If breakpoint is enabled, do nothing.

pub fn disable_breakpoint(&mut self, address: usize) -> Result<()>

Disable a breakpoint.

If breakpoint does not exists, do nothing.
If breakpoint is disabled, do nothing.

pub fn remove_breakpoint(&mut self, address: usize) -> Result<()>

Remove a breakpoint.

If breakpoint does not exists, do nothing.

pub fn cont(&mut self, how: ContinueMode) -> Result<()>

Continue debugee, see cont_aux for details.

pub fn step(&mut self, how: ContinueMode) -> Result<()>

Singlestep debugee, see cont_aux for details.

pub fn syscall(&mut self, how: ContinueMode) -> Result<()>

Run until syscall, see cont_aux for details.

pub fn detach(&self, signal: Option<Signal>) -> Result<()>

Detach from debugee.

All breakpoints are removed before detach.

pub fn pid(&self) -> Pid

Return the debugee pid.

pub fn registers(&self) -> &PtraceRegisters

Return the latest register state.

pub fn threads(&self) -> &HashMap<Pid, ThreadState>

Return the debugee threads.

pub fn event(&self) -> &WaitStatus

Return the latest event.

pub fn breakpoints(&self) -> &HashMap<AddressType, Breakpoint>

Return all breakpoints.

Trait Implementations

impl Debug for Ptracer

fn fmt(&self, fmt: &mut Formatter) -> Result

Formats the value using the given formatter.