xgadget 0.11.1

Fast, parallel, cross-variant ROP/JOP gadget search for x86/x64 binaries.
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

use core::{fmt, str::FromStr};

use crate::error::Error;

/// Architecture
// Note: no `#[cfg_attr(feature = "cli-bin", derive(clap::ValueEnum))]` because user should never
// specify "unknown". Use `FromStr` instead to support both lib and CLI.
#[derive(Debug, PartialEq, Eq, Clone, Copy, Hash)]
pub enum Arch {
    /// Unknown architecture
    Unknown = 0,
    /// 8086 (16-bit x86)
    X8086 = 16,
    /// x86 (32-bit x86)
    X86 = 32,
    /// x64 (32-bit x86)
    X64 = 64,
}

impl Arch {
    /// Arch -> bitness
    pub fn bits(&self) -> u32 {
        *self as u32
    }
}

impl fmt::Display for Arch {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(
            f,
            "{}",
            match &self {
                Arch::Unknown => "unknown",
                Arch::X8086 => "x8086",
                Arch::X86 => "x86",
                Arch::X64 => "x64",
            }
        )
    }
}

impl FromStr for Arch {
    type Err = Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "unknown" => Ok(Arch::Unknown),
            "x8086" => Ok(Arch::X8086),
            "x86" => Ok(Arch::X86),
            "x64" => Ok(Arch::X64),
            _ => Err(Error::UnsupportedArch),
        }
    }
}