calltrace-rs 1.1.4

High-performance function call tracing library for C/C++ applications using GCC instrumentation with Rust safety guarantees
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

//! Error handling for CallTrace library

use thiserror::Error;

#[derive(Error, Debug)]
pub enum CallTraceError {
    #[error("Memory allocation failed")]
    OutOfMemory,

    #[error("Invalid argument: {0}")]
    InvalidArgument(String),

    #[error("DWARF parsing error: {0}")]
    DwarfError(String),

    #[error("Register capture failed: {0}")]
    RegisterError(String),

    #[error("JSON serialization error: {0}")]
    JsonError(#[from] serde_json::Error),

    #[error("Thread operation failed: {0}")]
    ThreadError(String),

    #[error("Not supported on this architecture")]
    NotSupported,

    #[error("Initialization failed: {0}")]
    InitializationError(String),
    // TODO(human): Add more error types as needed
}

pub type Result<T> = std::result::Result<T, CallTraceError>;

/// Convert to C-compatible error code
impl CallTraceError {
    pub fn to_c_code(&self) -> i32 {
        match self {
            CallTraceError::OutOfMemory => -1,
            CallTraceError::InvalidArgument(_) => -2,
            CallTraceError::DwarfError(_) => -3,
            CallTraceError::RegisterError(_) => -4,
            CallTraceError::JsonError(_) => -5,
            CallTraceError::ThreadError(_) => -6,
            CallTraceError::NotSupported => -7,
            CallTraceError::InitializationError(_) => -8,
        }
    }
}