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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248

use std::rc::Rc;
use std::ptr;
use ffi;
use {Expr, InnerModule};

/// Relooper transforms arbitrary control-flow graph into 
/// a structured control-flow that used by Binaryen IR.
///
/// It takes control-flow graph in form of the blocks of code,
/// created by [`add_block`] or [`add_block_with_switch`] and connected
/// with [`add_branch`] and [`add_branch_for_switch`] respectively.
///
/// After blocks created and connected [`render`] is used to create
/// structured control-flow in form of `Expr`s.
/// 
/// [`add_block`]: #method.add_block
/// [`add_block_with_switch`]: #method.add_block_with_switch
/// [`add_branch`]: #method.add_branch
/// [`add_branch_for_switch`]: #method.add_branch_for_switch
/// [`render`]: #method.render
///
/// # Examples
/// 
/// ```
/// # use binaryen::*;
/// let module = Module::new();
/// let mut relooper = module.relooper();
/// 
/// // Create two blocks that do nothing.
/// let b1 = relooper.add_block(module.nop());
/// let b2 = relooper.add_block(module.nop());
///
/// // Add unconditional branch from `b1` to `b2`.
/// relooper.add_branch(b1, b2, None, None);
///
/// // Render final expression
/// let result: Expr = relooper.render(b1, 0);
/// result.print();
/// ```
///
/// If you want conditional branch, you can use. 
///
/// ```
/// # use binaryen::*;
/// # let module = Module::new();
/// # let mut relooper = module.relooper();
///
/// let entry = relooper.add_block(module.nop());
/// let if_true = relooper.add_block(module.nop());
/// let if_false = relooper.add_block(module.nop());
///
/// let always_true_condition: Expr = module.const_(Literal::I32(1));
/// 
/// relooper.add_branch(entry, if_true, Some(always_true_condition), None);
/// relooper.add_branch(entry, if_false, None, None);
/// 
/// let result: Expr = relooper.render(entry, 0);
/// result.print();
/// ```
///
pub struct Relooper {
    raw: ffi::RelooperRef,
    blocks: Vec<ffi::RelooperBlockRef>,
    module_ref: Rc<InnerModule>,
}

/// Represents Relooper's block. 
///
/// Can be either:
///
/// * [`PlainBlock`]
/// * [`SwitchBlock`]
///
/// [`PlainBlock`]: struct.PlainBlock.html
/// [`SwitchBlock`]: struct.SwitchBlock.html
pub trait Block {
    fn get_id(&self) -> usize;
}

/// Block that ends with nothing or with simple branching.
#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub struct PlainBlock(usize);

impl Block for PlainBlock {
    fn get_id(&self) -> usize {
        self.0
    }
}

/// Block that ends with a switch.
#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub struct SwitchBlock(usize);

impl Block for SwitchBlock {
    fn get_id(&self) -> usize {
        self.0
    }
}

impl Relooper {
    pub(crate) fn new(module_ref: Rc<InnerModule>) -> Relooper {
        Relooper {
            raw: unsafe { ffi::RelooperCreate() },
            blocks: Vec::new(),
            module_ref,
        }
    }

    /// Add a plain block that executes `code` and ends with nothing or with simple branching.
    /// 
    /// Plain blocks can have multiple conditional branches to the other blocks 
    /// and at most one unconditional.
    ///
    /// Be careful with branching in `code`, branches to the outside won't work.
    pub fn add_block(&mut self, code: Expr) -> PlainBlock {
        debug_assert!(self.is_expr_from_same_module(&code));
        let raw = unsafe { ffi::RelooperAddBlock(self.raw, code.into_raw()) };
        PlainBlock(self.add_raw_block(raw))
    }

    /// Add a block that executes `code` and ends with a switch on the `condition`.
    /// 
    /// Be careful with branching in `code`, branches to the outside won't work.
    pub fn add_block_with_switch(&mut self, code: Expr, condition: Expr) -> SwitchBlock {
        debug_assert!(self.is_expr_from_same_module(&code));
        debug_assert!(self.is_expr_from_same_module(&condition));
        let raw = unsafe {
            ffi::RelooperAddBlockWithSwitch(self.raw, code.into_raw(), condition.into_raw())
        };
        SwitchBlock(self.add_raw_block(raw))
    }

    /// Add a branch from `PlainBlock` to any other block.
    ///
    /// You can provide optional `condition` that will be used to decide if the branch should be taken.
    /// 
    /// The branch can have `code` on it, that is executed as the branch happens. 
    /// This is useful for phis if you use SSA.
    pub fn add_branch<B: Block>(
        &self,
        from: PlainBlock,
        to: B,
        condition: Option<Expr>,
        code: Option<Expr>,
    ) {
        debug_assert!(
            condition
                .as_ref()
                .map_or(true, |e| { self.is_expr_from_same_module(e) })
        );
        debug_assert!(
            code.as_ref()
                .map_or(true, |e| { self.is_expr_from_same_module(e) })
        );

        let from_block = self.get_raw_block(from);
        let to_block = self.get_raw_block(to);

        unsafe {
            let condition_ptr = condition.map_or(ptr::null_mut(), |e| e.into_raw());
            let code_ptr = code.map_or(ptr::null_mut(), |e| e.into_raw());
            ffi::RelooperAddBranch(from_block as _, to_block as _, condition_ptr, code_ptr)
        }
    }

    /// Add a switch-style branch to any other block. 
    /// 
    /// The block's switch table will have these indices going to that target
    pub fn add_branch_for_switch<B: Block>(
        &self,
        from: SwitchBlock,
        to: B,
        indices: &[u32],
        code: Option<Expr>,
    ) {
        debug_assert!(
            code.as_ref()
                .map_or(true, |e| { self.is_expr_from_same_module(e) })
        );
        let from_block = self.get_raw_block(from);
        let to_block = self.get_raw_block(to);

        unsafe {
            let code_ptr = code.map_or(ptr::null_mut(), |e| e.into_raw());
            ffi::RelooperAddBranchForSwitch(
                from_block,
                to_block,
                indices.as_ptr() as *mut _,
                indices.len() as _,
                code_ptr,
            );
        }
    }

    /// Render an structured control-flow graph from provided blocks and branches.
    /// 
    /// # Arguments
    ///
    /// * entry - Entrypoint of this control-flow graph.
    /// * label_helper - Index of i32 local variable that is free to use. This may be needed
    /// to render irreducible control-flow graph.
    /// 
    pub fn render<B: Block>(self, entry: B, label_helper: u32) -> Expr {
        let entry = self.get_raw_block(entry);
        let raw = unsafe {
            ffi::RelooperRenderAndDispose(self.raw, entry, label_helper as _, self.module_ref.raw)
        };
        Expr {
            _module_ref: self.module_ref.clone(),
            raw,
        }
    }

    fn add_raw_block(&mut self, raw_block: ffi::RelooperBlockRef) -> usize {
        let index = self.blocks.len();
        self.blocks.push(raw_block);
        index
    }

    fn get_raw_block<B: Block>(&self, block: B) -> ffi::RelooperBlockRef {
        self.blocks[block.get_id()]
    }

    fn is_expr_from_same_module(&self, expr: &Expr) -> bool {
        Rc::ptr_eq(&self.module_ref, &expr._module_ref)
    }
}

#[cfg(test)]
mod tests {
    use {Module};

    #[test]
    fn test() {
        let module = Module::new();
        let mut relooper = module.relooper();
        let b1 = relooper.add_block(module.nop());
        let b2 = relooper.add_block(module.nop());

        relooper.add_branch(b1, b2, None, None);

        let result = relooper.render(b1, 0);
        result.print();
    }

    // TODO: Create 2 reloopers?
}