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
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

// Copyright (C) 2025 FZI Forschungszentrum Informatik
// SPDX-License-Identifier: Apache-2.0
//! Tests concerning behaviour around fn calls (and plain jumps)

use super::*;

trace_test!(
    baseline,
    test_bin_fncalls(),
    start_packet(0x80000000) => {
        (0x80000000, Context::default()),
        (0x80000000, Kind::new_auipc(13, 0x0))
    }
    payload::AddressInfo {
        address: 0x0e,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000004, UNCOMPRESSED),
        (0x80000008, UNCOMPRESSED),
        (0x8000000c, Kind::new_c_jal(1, 0x14)),
        (0x80000020, COMPRESSED),
        (0x80000022, Kind::new_c_jr(1)),
        (0x8000000e, Kind::new_auipc(13, 0))
    }
    payload::AddressInfo {
        address: 0x12,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000012, Kind::new_jalr(1, 13, 0x12)),
        (0x80000020, COMPRESSED)
    }
    payload::AddressInfo {
        address: 0x16u64.wrapping_sub(0x20),
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000022, Kind::new_c_jr(1)),
        (0x80000016, Kind::new_lui(13,0x80000000u32 as i32))
    }
    payload::AddressInfo {
        address: 0x20-0x16,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x8000001a, Kind::new_jalr(1, 13, 0x20)),
        (0x80000020, COMPRESSED)
    }
    payload::AddressInfo {
        address: 0x1eu64.wrapping_sub(0x20),
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000022, Kind::new_c_jr(1)),
        (0x8000001e, Kind::new_c_j(0, 0x6))
    }
    payload::AddressInfo {
        address: 0x24-0x1e,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000024, Kind::wfi)
    }
);

trace_test!(
    sijump,
    test_bin_fncalls(),
    @params {
        sijump_p: true
    }
    start_packet(0x80000000) => {
        (0x80000000, Context::default()),
        (0x80000000, Kind::new_auipc(13, 0x0))
    }
    payload::AddressInfo {
        address: 0x0e,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000004, UNCOMPRESSED),
        (0x80000008, UNCOMPRESSED),
        (0x8000000c, Kind::new_c_jal(1, 0x14)),
        (0x80000020, COMPRESSED),
        (0x80000022, Kind::new_c_jr(1)),
        (0x8000000e, Kind::new_auipc(13, 0))
    }
    payload::AddressInfo {
        address: 0x16-0x0e,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000012, Kind::new_jalr(1, 13, 0x12)),
        (0x80000020, COMPRESSED),
        (0x80000022, Kind::new_c_jr(1)),
        (0x80000016, Kind::new_lui(13,0x80000000u32 as i32))
    }
    payload::AddressInfo {
        address: 0x1e-0x16,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x8000001a, Kind::new_jalr(1, 13, 0x20)),
        (0x80000020, COMPRESSED),
        (0x80000022, Kind::new_c_jr(1)),
        (0x8000001e, Kind::new_c_j(0, 0x6))
    }
    payload::AddressInfo {
        address: 0x24-0x1e,
        notify: false,
        updiscon: false,
        irdepth: None,
    } => {
        (0x80000024, Kind::wfi)
    }
);

fn test_bin_fncalls() -> [(u64, instruction::Instruction); 13] {
    [
        (0x80000000, Kind::new_auipc(13, 0).into()),
        (0x80000004, UNCOMPRESSED),
        (0x80000008, UNCOMPRESSED),
        (0x8000000c, Kind::new_c_jal(1, 0x14).into()),
        (0x8000000e, Kind::new_auipc(13, 0).into()),
        (0x80000012, Kind::new_jalr(1, 13, 0x12).into()),
        (0x80000016, Kind::new_lui(13, 0x80000000u32 as i32).into()),
        (0x8000001a, Kind::new_jalr(1, 13, 0x20).into()),
        (0x8000001e, Kind::new_c_j(0, 0x6).into()),
        // add
        (0x80000020, COMPRESSED),
        (0x80000022, Kind::new_c_jr(1).into()),
        // _die
        (0x80000024, Kind::wfi.into()),
        (0x80000028, Kind::new_c_j(0, -4).into()),
    ]
}