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
//! Heaps.

use ir::immediates::Imm64;
use ir::GlobalValue;
use std::fmt;

/// Information about a heap declaration.
#[derive(Clone)]
pub struct HeapData {
    /// Method for determining the heap base address.
    pub base: HeapBase,

    /// Guaranteed minimum heap size in bytes. Heap accesses before `min_size` don't need bounds
    /// checking.
    pub min_size: Imm64,

    /// Size in bytes of the guard pages following the heap.
    pub guard_size: Imm64,

    /// Heap style, with additional style-specific info.
    pub style: HeapStyle,
}

/// Method for determining the base address of a heap.
#[derive(Clone)]
pub enum HeapBase {
    /// The heap base lives in a reserved register.
    ///
    /// This feature is not yet implemented.
    ReservedReg,

    /// The heap base is a global value.
    GlobalValue(GlobalValue),
}

/// Style of heap including style-specific information.
#[derive(Clone)]
pub enum HeapStyle {
    /// A dynamic heap can be relocated to a different base address when it is grown.
    Dynamic {
        /// Global value providing the current bound of the heap in bytes.
        bound_gv: GlobalValue,
    },

    /// A static heap has a fixed base address and a number of not-yet-allocated pages before the
    /// guard pages.
    Static {
        /// Heap bound in bytes. The guard pages are allocated after the bound.
        bound: Imm64,
    },
}

impl fmt::Display for HeapData {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str(match self.style {
            HeapStyle::Dynamic { .. } => "dynamic",
            HeapStyle::Static { .. } => "static",
        })?;

        match self.base {
            HeapBase::ReservedReg => write!(f, " reserved_reg")?,
            HeapBase::GlobalValue(gv) => write!(f, " {}", gv)?,
        }

        write!(f, ", min {}", self.min_size)?;
        match self.style {
            HeapStyle::Dynamic { bound_gv } => write!(f, ", bound {}", bound_gv)?,
            HeapStyle::Static { bound } => write!(f, ", bound {}", bound)?,
        }
        write!(f, ", guard {}", self.guard_size)
    }
}