Struct libdw::Dwarf

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

Implementations

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>

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

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

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

Trait Implementations

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

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

Formats the value using the given formatter.

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

fn drop(&mut self)

Executes the destructor for this type.