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

use bitflags::bitflags;

use crate::category::CategoryPairHandle;
use crate::global_lib_table::LibraryHandle;
use crate::profile::StringHandle;

/// A part of the information about a single stack frame.
#[derive(Debug, Clone, PartialOrd, Ord, PartialEq, Eq)]
pub enum Frame {
    /// A code address taken from the instruction pointer.
    ///
    /// This code address will be resolved to a library-relative address using
    /// the library mappings on the process which were specified using
    /// [`Profile::add_lib_mapping`](crate::Profile::add_lib_mapping).
    InstructionPointer(u64),
    /// A code address taken from a return address
    ///
    /// This code address will be resolved to a library-relative address using
    /// the library mappings on the process which were specified using
    /// [`Profile::add_lib_mapping`](crate::Profile::add_lib_mapping).
    ReturnAddress(u64),
    /// A relative address taken from the instruction pointer which
    /// has already been resolved to a `LibraryHandle`.
    RelativeAddressFromInstructionPointer(LibraryHandle, u32),
    /// A relative address taken from a return address which
    /// has already been resolved to a `LibraryHandle`.
    RelativeAddressFromReturnAddress(LibraryHandle, u32),
    /// A string, containing an index returned by
    /// [`Profile::intern_string`](crate::Profile::intern_string).
    Label(StringHandle),
}

/// All the information about a single stack frame.
#[derive(Debug, Clone, PartialOrd, Ord, PartialEq, Eq)]
pub struct FrameInfo {
    /// The absolute address or label of this frame.
    pub frame: Frame,
    /// The category pair of this frame.
    pub category_pair: CategoryPairHandle,
    /// The flags of this frame. Use `FrameFlags::empty()` if unsure.
    pub flags: FrameFlags,
}

bitflags! {
    /// Flags for a stack frame.
    #[derive(PartialEq, Eq, PartialOrd, Ord, Hash, Debug, Clone, Copy)]
    pub struct FrameFlags: u32 {
        /// Set on frames which are JavaScript functions.
        const IS_JS = 0b00000001;

        /// Set on frames which are not strictly JavaScript functions but which
        /// should be included in the JS-only call tree, such as DOM API calls.
        const IS_RELEVANT_FOR_JS = 0b00000010;
    }
}