rudy-dwarf 0.2.0

DWARF debug information parsing and querying for Rust debugging tools
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

//! DWARF loading and memory management

use std::{ops::Deref, sync::Arc};

use gimli::{EndianReader, LittleEndian};
use object::ObjectSection;

// Utilities for loading dwarf files

pub fn load(file: &'_ object::File<'static>) -> gimli::Result<Dwarf> {
    let load = |id: gimli::SectionId| {
        Ok(gimli::EndianReader::new(
            object::Object::section_by_name(file, id.name())
                .map(|s| match s.uncompressed_data().unwrap() {
                    std::borrow::Cow::Borrowed(b) => OwnedOrBorrowed::Borrowed(b),
                    std::borrow::Cow::Owned(v) => OwnedOrBorrowed::Owned(Arc::new(v)),
                })
                .unwrap_or(OwnedOrBorrowed::Borrowed(&[])),
            gimli::LittleEndian,
        ))
    };
    gimli::Dwarf::load(&load)
}

#[derive(Clone, Debug)]
pub enum OwnedOrBorrowed {
    Borrowed(&'static [u8]),
    Owned(Arc<Vec<u8>>),
}

// And `OwnedOrBorrowed` can deref to a slice of the `mmap`ed region of memory.
impl Deref for OwnedOrBorrowed {
    type Target = [u8];
    fn deref(&self) -> &[u8] {
        match self {
            OwnedOrBorrowed::Borrowed(slice) => slice,
            OwnedOrBorrowed::Owned(arc) => arc,
        }
    }
}

// These are both valid for any `Rc` or `Arc`.
unsafe impl gimli::StableDeref for OwnedOrBorrowed {}
unsafe impl gimli::CloneStableDeref for OwnedOrBorrowed {}

// shorthand type definitions
pub type DwarfReader = EndianReader<LittleEndian, OwnedOrBorrowed>;
pub type Dwarf = gimli::Dwarf<DwarfReader>;
pub type RawDie<'a> = gimli::DebuggingInformationEntry<'a, 'a, DwarfReader>;
pub type Offset = gimli::UnitOffset<usize>;