Struct libdw::Dwarf

pub struct Dwarf<'dw> { /* fields omitted */ }

Methods

impl<'dw> Dwarf<'dw>

pub fn open<P: AsRef<Path>>(path: P) -> Result<Dwarf<'static>>

Open a Dwarf from a path.

Examples

let exe = std::env::current_exe().unwrap();
let dw = libdw::Dwarf::open(exe).unwrap();

pub fn from_fd<FD: AsRawFd>(fd: &'dw FD) -> Result<Dwarf<'dw>>

Create a Dwarf from an open file.

Examples

let exe = std::env::current_exe().unwrap();
let f = std::fs::File::open(exe).unwrap();
let dw = libdw::Dwarf::from_fd(&f).unwrap();

pub fn from_elf(elf: &'dw Elf) -> Result<Dwarf<'dw>>

Create a Dwarf from an existing Elf.

Examples

let exe = std::env::current_exe().unwrap();
let elf = libelf::Elf::open(exe).unwrap();
let dw = libdw::Dwarf::from_elf(&elf).unwrap();

pub unsafe fn from_raw(dwarf: *mut Dwarf) -> Dwarf<'dw>

Create a Dwarf from a raw FFI pointer.

Safety

This function is unsafe because there is no guarantee that the given pointer is a valid libdw handle, nor whether the lifetime inferred is appropriate. This does not take ownership of the underlying object, so the caller must ensure it outlives the returned Dwarf wrapper.

pub fn get_elf(&'dw self) -> Elf<'dw>

Important traits for CompileUnits<'dw>

impl<'dw> Iterator for CompileUnits<'dw> type Item = Result<CompileUnit<'dw>>;

pub fn compile_units(&'dw self) -> CompileUnits<'dw>

Important traits for TypeUnits<'dw>

impl<'dw> Iterator for TypeUnits<'dw> type Item = Result<TypeUnit<'dw>>;

pub fn type_units(&'dw self) -> TypeUnits<'dw>

pub fn as_ptr(&self) -> *mut Dwarf

Trait Implementations

impl<'dw> Drop for Dwarf<'dw>

fn drop(&mut self)

Executes the destructor for this type.

impl<'dw> Debug for Dwarf<'dw>

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

Formats the value using the given formatter.