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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
use addr2line::object;
use object::{Object, SymbolKind};
use std::collections::BTreeMap;
use std::future::Future;
use std::ops::Deref;
use std::path::{Path, PathBuf};
use std::pin::Pin;
pub trait OwnedFileData {
fn get_data(&self) -> &[u8];
}
pub type FileAndPathHelperError = Box<dyn std::error::Error + Send + Sync + 'static>;
pub type FileAndPathHelperResult<T> = std::result::Result<T, FileAndPathHelperError>;
#[cfg(not(feature = "send_futures"))]
pub trait OptionallySendFuture: Future {}
#[cfg(not(feature = "send_futures"))]
impl<T> OptionallySendFuture for T where T: Future {}
#[cfg(feature = "send_futures")]
pub trait OptionallySendFuture: Future + Send {}
#[cfg(feature = "send_futures")]
impl<T> OptionallySendFuture for T where T: Future + Send {}
pub trait FileAndPathHelper {
type FileContents: OwnedFileData;
fn get_candidate_paths_for_binary_or_pdb(
&self,
debug_name: &str,
breakpad_id: &str,
) -> Pin<Box<dyn OptionallySendFuture<Output = FileAndPathHelperResult<Vec<PathBuf>>>>>;
fn get_candidate_paths_for_pdb(
&self,
_debug_name: &str,
_breakpad_id: &str,
pdb_path_as_stored_in_binary: &std::ffi::CStr,
_binary_path: &Path,
) -> Pin<Box<dyn OptionallySendFuture<Output = FileAndPathHelperResult<Vec<PathBuf>>>>> {
async fn single_value_path_vec(
path: std::ffi::CString,
) -> FileAndPathHelperResult<Vec<PathBuf>> {
Ok(vec![path.into_string()?.into()])
}
Box::pin(single_value_path_vec(
pdb_path_as_stored_in_binary.to_owned(),
))
}
fn read_file(
&self,
path: &Path,
) -> Pin<Box<dyn OptionallySendFuture<Output = FileAndPathHelperResult<Self::FileContents>>>>;
}
pub struct AddressDebugInfo {
pub frames: Vec<InlineStackFrame>,
}
pub struct InlineStackFrame {
pub function: Option<String>,
pub file_path: Option<String>,
pub line_number: Option<u32>,
}
pub enum SymbolicationResultKind {
AllSymbols,
SymbolsForAddresses { with_debug_info: bool },
}
pub trait SymbolicationResult {
fn from_full_map<S>(map: BTreeMap<u32, S>, addresses: &[u32]) -> Self
where
S: Deref<Target = str>;
fn for_addresses(addresses: &[u32]) -> Self;
fn result_kind() -> SymbolicationResultKind;
fn add_address_symbol(&mut self, address: u32, symbol_address: u32, symbol_name: &str);
fn add_address_debug_info(&mut self, address: u32, info: AddressDebugInfo);
fn set_total_symbol_count(&mut self, total_symbol_count: u32);
}
#[derive(Clone)]
pub struct SymbolicationQuery<'a> {
pub debug_name: &'a str,
pub breakpad_id: &'a str,
pub path: &'a Path,
pub addresses: &'a [u32],
}
pub fn object_to_map<'a, 'b, T>(object_file: &'b T) -> BTreeMap<u32, &'a str>
where
T: Object<'a, 'b>,
{
object_file
.dynamic_symbols()
.chain(object_file.symbols())
.filter(|(_, symbol)| symbol.kind() == SymbolKind::Text)
.filter_map(|(_, symbol)| symbol.name().map(|name| (symbol.address() as u32, name)))
.collect()
}