falcon 0.6.0

A Binary Analysis Framework in Rust
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//! A value used in the paged memory model.

use crate::executor::eval;
use crate::il;
use crate::Error;
use std::fmt::Debug;

/// In order for a value to be used in the paged memory model, it must implement
/// this trait.
pub trait Value: Clone + Debug + Eq + PartialEq {
    /// Turn an il::Constant into a representation of this Value
    fn constant(constant: il::Constant) -> Self;

    /// Return the number of bits contained in this value
    fn bits(&self) -> usize;

    /// Shift the value left by the given number of bits
    fn shl(&self, bits: usize) -> Result<Self, Error>;

    /// Shift the value right by the given number of bits
    fn shr(&self, bits: usize) -> Result<Self, Error>;

    /// Truncate the value to the given number of bits
    fn trun(&self, bits: usize) -> Result<Self, Error>;

    /// Zero-extend the value to the given number of bits
    fn zext(&self, bits: usize) -> Result<Self, Error>;

    /// Or this value with the given value
    fn or(&self, other: &Self) -> Result<Self, Error>;
}

impl Value for il::Constant {
    fn constant(constant: il::Constant) -> Self {
        constant
    }

    fn bits(&self) -> usize {
        self.bits()
    }

    fn shl(&self, bits: usize) -> Result<Self, Error> {
        eval(&il::Expression::shl(
            self.clone().into(),
            il::expr_const(bits as u64, self.bits()),
        )?)
    }

    fn shr(&self, bits: usize) -> Result<Self, Error> {
        eval(&il::Expression::shr(
            self.clone().into(),
            il::expr_const(bits as u64, self.bits()),
        )?)
    }

    fn trun(&self, bits: usize) -> Result<Self, Error> {
        eval(&il::Expression::trun(bits, self.clone().into())?)
    }

    fn zext(&self, bits: usize) -> Result<Self, Error> {
        eval(&il::Expression::zext(bits, self.clone().into())?)
    }

    fn or(&self, other: &Self) -> Result<Self, Error> {
        eval(&il::Expression::or(
            self.clone().into(),
            other.clone().into(),
        )?)
    }
}

impl Value for il::Expression {
    fn constant(constant: il::Constant) -> Self {
        il::Expression::constant(constant)
    }

    fn bits(&self) -> usize {
        self.bits()
    }

    fn shl(&self, bits: usize) -> Result<Self, Error> {
        il::Expression::shl(self.clone(), il::expr_const(bits as u64, self.bits()))
    }

    fn shr(&self, bits: usize) -> Result<Self, Error> {
        il::Expression::shr(self.clone(), il::expr_const(bits as u64, self.bits()))
    }

    fn trun(&self, bits: usize) -> Result<Self, Error> {
        il::Expression::trun(bits, self.clone())
    }

    fn zext(&self, bits: usize) -> Result<Self, Error> {
        il::Expression::zext(bits, self.clone())
    }

    fn or(&self, other: &Self) -> Result<Self, Error> {
        il::Expression::or(self.clone(), other.clone())
    }
}