riscv-etrace 0.5.2

Decoder and tracer for RISC-V efficient instruction tracing
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

// Copyright (C) 2025 FZI Forschungszentrum Informatik
// SPDX-License-Identifier: Apache-2.0
//! [`Binary`] requiring [`Box`] and other types from alloc [`alloc`]

use alloc::boxed::Box;

use crate::instruction::{info, Instruction};

use super::error::MaybeMissError;
use super::Binary;

/// [`Binary`] returning a boxed, dynamically dispatched `Error`
///
/// This [`Binary`] adapter boxes and type-erases errors returned by the wrapped
/// [`Binary`]. This allows dynamically dispatching [`Binary`]s with differrent
/// [`Binary::Error`] types.
#[derive(Copy, Clone, Debug)]
pub struct BoxedError<B> {
    inner: B,
}

impl<B> BoxedError<B> {
    /// Create a new [`Binary`] wrapping another one
    pub fn new(inner: B) -> Self {
        Self { inner }
    }
}

impl<B> From<B> for BoxedError<B> {
    fn from(inner: B) -> Self {
        Self { inner }
    }
}

impl<B, I> Binary<I> for BoxedError<B>
where
    B: Binary<I>,
    B::Error: MaybeMissError + 'static,
    I: info::Info,
{
    type Error = Box<dyn MaybeMissError>;

    fn get_insn(&mut self, address: u64) -> Result<Instruction<I>, Self::Error> {
        self.inner
            .get_insn(address)
            .map_err(|e| -> Box<dyn MaybeMissError> { Box::new(e) })
    }
}