crackers 0.9.0

A tool for synthesizing Code Reuse Attacks (ROP chains) using Ghidra's p-code and Z3
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

use crate::config::error::CrackersConfigError;
use jingle::modeling::ModeledInstruction;
use jingle::sleigh::{Instruction, SleighArchInfo};
use std::borrow::Borrow;
use std::fmt::{Display, Formatter};

#[derive(Debug, Clone, Default)]
pub struct Step {
    instructions: Vec<Instruction>,
}

impl Step {
    pub fn new<'a, T: Iterator<Item = &'a Instruction>>(instructions: T) -> Self {
        Self {
            instructions: instructions.cloned().collect(),
        }
    }

    pub fn combine<'a, T: Iterator<Item = &'a Step>>(steps: T) -> Self {
        let instructions = steps.flat_map(|step| step.instructions.clone()).collect();
        Self { instructions }
    }
    pub fn from_instr(instr: Instruction) -> Self {
        Self {
            instructions: vec![instr],
        }
    }

    pub fn instructions(&self) -> &[Instruction] {
        &self.instructions
    }

    pub fn model<T: Borrow<SleighArchInfo>>(
        &self,
        ctx: T,
    ) -> Result<ModeledInstruction, CrackersConfigError> {
        let i: Instruction = self.instructions.as_slice().try_into()?;
        ModeledInstruction::new(i, ctx).map_err(CrackersConfigError::from)
    }
}

impl Display for Step {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        for x in &self.instructions {
            writeln!(f, "{}", x.disassembly)?;
        }
        Ok(())
    }
}