tracepoint_perf 0.5.0

Rust API for reading and writing perf.data files
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

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT license.

#[derive(Debug)]
#[repr(C)]
pub struct ClockData {
    pub version: u32,
    pub clockid: u32,
    pub wall_clock_ns: u64,
    pub clockid_time_ns: u64,
}

impl ClockData {
    pub fn byte_swap(&mut self) {
        self.version = self.version.swap_bytes();
        self.clockid = self.clockid.swap_bytes();
        self.wall_clock_ns = self.wall_clock_ns.swap_bytes();
        self.clockid_time_ns = self.clockid_time_ns.swap_bytes();
    }
}

#[derive(Clone, Copy, Debug, Default)]
#[repr(C)]
pub struct PerfFileSection {
    pub offset: u64, // offset from start of file
    pub size: u64,   // size of the section
}

impl PerfFileSection {
    pub fn byte_swap(&mut self) {
        self.offset = self.offset.swap_bytes();
        self.size = self.size.swap_bytes();
    }
}

#[derive(Clone, Copy, Debug, Default)]
#[repr(C)]
pub struct PerfFileHeaderPipe {
    pub magic: u64, // If correctly byte-swapped, this will be equal to PERFILE2_MAGIC_HOST_ENDIAN.
    pub size: u64,  // Size of the header, 16 for pipe-mode or 104 for seek-mode.
}

impl PerfFileHeaderPipe {
    pub fn byte_swap(&mut self) {
        self.magic = self.magic.swap_bytes();
        self.size = self.size.swap_bytes();
    }
}

#[derive(Clone, Copy, Debug, Default)]
#[repr(C)]
pub struct PerfFileHeaderRest {
    pub attr_size: u64, // size of (perf_event_attrs + perf_file_section) in attrs.
    pub attrs: PerfFileSection,
    pub data: PerfFileSection,
    pub event_types: PerfFileSection, // Not used
    pub flags: [u64; 4],              // 256-bit bitmap based on HEADER_BITS
}

impl PerfFileHeaderRest {
    pub fn byte_swap(&mut self) {
        self.attr_size = self.attr_size.swap_bytes();
        self.attrs.byte_swap();
        self.data.byte_swap();
        self.event_types.byte_swap();
        for i in 0..4 {
            self.flags[i] = self.flags[i].swap_bytes();
        }
    }
}

#[derive(Clone, Copy, Debug, Default)]
#[repr(C)]
pub struct PerfFileHeader {
    pub pipe: PerfFileHeaderPipe,
    pub rest: PerfFileHeaderRest,
}

impl PerfFileHeader {
    pub fn byte_swap(&mut self) {
        self.pipe.byte_swap();
        self.rest.byte_swap();
    }
}