bugstalker 0.4.5

BugStalker is a modern and lightweight debugger for rust applications.
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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use std::{
    collections::{HashMap, hash_map::Entry},
    rc::Rc,
};

use crate::{
    debugger::{
        Debugger, address::RelocatedAddress, context::gcx, debugee::dwarf::r#type::ComplexType,
    },
    type_from_cache,
};

#[derive(Eq, PartialEq, Hash)]
pub struct Key {
    linkage_name: String,
    name: Option<String>,
}

impl Key {
    pub fn new(linkage_name: impl Into<String>) -> Self {
        Self {
            linkage_name: linkage_name.into(),
            name: None,
        }
    }

    pub fn new_with_name(linkage_name: impl Into<String>, name: impl Into<String>) -> Self {
        Self {
            linkage_name: linkage_name.into(),
            name: Some(name.into()),
        }
    }
}

#[derive(Clone)]
pub struct Value {
    fn_addr: RelocatedAddress,
    fn_param_types: Rc<Box<[Rc<ComplexType>]>>,
}

impl Value {
    pub fn new(fn_addr: RelocatedAddress, fn_param_types: Box<[Rc<ComplexType>]>) -> Self {
        Self {
            fn_addr,
            fn_param_types: Rc::new(fn_param_types),
        }
    }

    pub fn fn_addr(&self) -> RelocatedAddress {
        self.fn_addr
    }

    pub fn fn_param_types(&self) -> &[Rc<ComplexType>] {
        &self.fn_param_types
    }
}

/// Cache for already called functions.
#[derive(Default)]
pub struct CallCache(HashMap<Key, Value>);

impl CallCache {
    pub fn get_or_insert(
        &mut self,
        dbg: &Debugger,
        linkage_name: &str,
        name: Option<&str>,
    ) -> Result<Value, crate::debugger::Error> {
        let key = if let Some(name) = name {
            Key::new_with_name(linkage_name, name)
        } else {
            Key::new(linkage_name)
        };
        let entry = self.0.entry(key);
        let fn_info = match entry {
            Entry::Occupied(e) => e.into_mut(),
            Entry::Vacant(e) => {
                let (dwarf, func, _) = dbg.search_fn_to_call(linkage_name, name)?;
                let fn_addr = func
                    .prolog_start_place()?
                    .address
                    .relocate_to_segment(&dbg.debugee, dwarf)?;

                let params = {
                    func.parameters()
                        .into_iter()
                        .map(|die| gcx().with_type_cache(|tc| type_from_cache!(die, tc)))
                        .collect::<Result<Box<[_]>, _>>()?
                };
                e.insert(Value::new(fn_addr, params))
            }
        };
        Ok(fn_info.clone())
    }
}