linux-perf-data 0.13.0

A parser for the perf.data format and the jitdump format. These formats are used by the Linux perf tool.
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

use byteorder::ByteOrder;
use linux_perf_event_reader::RawData;

/// Auxtrace data record.
///
/// This is usually used with Intel PT, which records the pure Intel PT data.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Auxtrace<'a> {
    /// Size of `aux_data`
    pub size: u64,
    /// Offset of this trace in the total trace
    pub offset: u64,
    /// Reference ID
    pub reference: u64,
    /// Index of this trace in the total trace
    pub index: u32,
    /// ID of thread that contributes to this trace
    pub tid: u32,
    /// ID of CPU that contributes to this trace
    pub cpu: u32,
    /// Pure data. The length of this data is guaranteed to be consistent
    /// with the `size` field.
    pub aux_data: RawData<'a>,
}

impl<'a> Auxtrace<'a> {
    pub fn parse<T: ByteOrder>(mut data: RawData<'a>) -> Result<Self, std::io::Error> {
        let size = data.read_u64::<T>()?;
        let offset = data.read_u64::<T>()?;
        let reference = data.read_u64::<T>()?;
        let index = data.read_u32::<T>()?;
        let tid = data.read_u32::<T>()?;
        let cpu = data.read_u32::<T>()?;
        let _reserved = data.read_u32::<T>()?;
        let aux_data = data;
        Ok(Self {
            size,
            offset,
            reference,
            index,
            tid,
            cpu,
            aux_data,
        })
    }
}

#[cfg(test)]
mod test {
    use byteorder::LittleEndian;
    use linux_perf_event_reader::RawData;

    use super::Auxtrace;

    #[test]
    fn parse() {
        let data = RawData::Single(&[
            0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
            0x00, 0x00, 0xf9, 0xcd, 0x2a, 0x49, 0x28, 0x04, 0x00, 0x00, 0x08, 0x00, 0x00, 0x00,
            0x7a, 0x24, 0x00, 0x00, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
        ]);
        let auxtrace = Auxtrace::parse::<LittleEndian>(data).unwrap();
        assert_eq!(auxtrace.size, 0x01);
        assert_eq!(auxtrace.offset, 0x00);
        assert_eq!(auxtrace.reference, 0x428492acdf9);
        assert_eq!(auxtrace.index, 0x8);
        assert_eq!(auxtrace.tid, 0x247a);
        assert_eq!(auxtrace.cpu, 8);
        assert_eq!(auxtrace.aux_data.len(), auxtrace.size as usize);
    }
}