Struct dw::dwfl::DwflRef

[+] Show declaration

pub struct DwflRef<'a>(_, _);

[−] Expand description

A borrowed reference to a Dwfl.

Methods

impl<'a> DwflRef<'a>

[−]

pub fn version(&self) -> &str

[−]

Returns a string describing the version of libdw used.

pub fn report(&mut self) -> Report<'_, 'a>

[−]

Starts a "reporting" session used to register new segments and modules.

Existing segments and modules will be removed.

pub fn report_add(&mut self) -> Report<'_, 'a>

[−]

Starts a "reporting" session used to register new segments and modules.

Unlike the report method, this will not remove existing segments and modules.

pub fn linux_proc_attach(     &mut self,     pid: u32,     assume_ptrace_stopped: bool ) -> Result<(), Error>

[−]

Configures the session to unwind the threads of a remote process via ptrace and the /proc pseudo-filesystem.

Normally, the session will ptrace attach to threads being unwound, but if assume_ptrace_stopped is set to true, this will not happen. It's then the responsibility of the caller to ensure that the thread is already attached and stopped.

pub fn threads<F>(&mut self, callback: F) -> Result<(), Error> where     F: FnMut(&mut ThreadRef) -> Result<(), Error>,

[−]

Iterates through the threads of the attached process.

The callback will be invoked for each thread in turn.

pub fn thread_frames<F>(&mut self, tid: u32, callback: F) -> Result<(), Error> where     F: FnMut(&mut FrameRef) -> Result<(), Error>,

[−]

Iterates through the frames of a specific thread of the attached process.

The callback will be invoked for each stack frame of the thread in turn.

pub fn addr_module(&self, address: u64) -> Result<&ModuleRef, Error>

[−]

Looks up the module containing the address.

Trait Implementations

impl<'a> ForeignTypeRef for DwflRef<'a>

[+]

type CType = Dwfl

The raw C type.

unsafe fn from_ptr<'a>(ptr: *mut Self::CType) -> &'a Self

[−]

Constructs a shared instance of this type from its raw type.

unsafe fn from_ptr_mut<'a>(ptr: *mut Self::CType) -> &'a mut Self

[−]

Constructs a mutable reference of this type from its raw type.

fn as_ptr(&self) -> *mut Self::CType

[−]

Returns a raw pointer to the wrapped value.