Struct capstone::Capstone

pub struct Capstone<'cs> { /* fields omitted */ }

An instance of the capstone disassembler

Methods

impl<'cs> Capstone<'cs>

pub fn new() -> CapstoneBuilder

Create a new instance of the decompiler using the builder pattern interface. This is the recommended interface to Capstone.

use capstone::prelude::*;
let cs = Capstone::new().x86().mode(arch::x86::ArchMode::Mode32).build();

pub fn new_raw<T: Iterator<Item = ExtraMode>>(     arch: Arch,     mode: Mode,     extra_mode: T,     endian: Option<Endian> ) -> CsResult<Capstone<'cs>>

Create a new instance of the decompiler using the "raw" interface. The user must ensure that only sensible Arch/Mode combinations are used.

use capstone::{Arch, Capstone, NO_EXTRA_MODE, Mode};
let cs = Capstone::new_raw(Arch::X86, Mode::Mode64, NO_EXTRA_MODE, None);
assert!(cs.is_ok());

pub fn disasm_all<'s, 'c, 'a>(     &'s mut self,     code: &'c [u8],     addr: u64 ) -> CsResult<Instructions<'a>>

Disassemble all instructions in buffer

pub fn disasm_count<'s, 'c, 'a>(     &'s mut self,     code: &'c [u8],     addr: u64,     count: usize ) -> CsResult<Instructions<'a>>

Disassemble count instructions in code

pub fn set_extra_mode<T: Iterator<Item = ExtraMode>>(     &mut self,     extra_mode: T ) -> CsResult<()>

Set extra modes in addition to normal mode

pub fn set_syntax(&mut self, syntax: Syntax) -> CsResult<()>

Set the assembly syntax (has no effect on some platforms)

pub fn set_endian(&mut self, endian: Endian) -> CsResult<()>

Set the endianness (has no effect on some platforms).

pub fn set_mode(&mut self, mode: Mode) -> CsResult<()>

Sets the engine's disassembly mode. Be careful, various combinations of modes aren't supported See the capstone-sys documentation for more information.

pub fn set_detail(&mut self, enable_detail: bool) -> CsResult<()>

Controls whether to capstone will generate extra details about disassembled instructions.

Pass true to enable detail or false to disable detail.

pub fn reg_name(&self, reg_id: RegId) -> Option<String>

Converts a register id reg_id to a String containing the register name.

pub fn insn_name(&self, insn_id: InsnId) -> Option<String>

Converts an instruction id insn_id to a String containing the instruction name.

Note: This function ignores the current syntax and uses the default syntax.

pub fn group_name(&self, group_id: InsnGroupId) -> Option<String>

Converts a group id group_id to a String containing the group name.

pub fn insn_detail<'s, 'i: 's>(     &'s self,     insn: &'i Insn ) -> CsResult<InsnDetail<'i>>

Returns Detail structure for a given instruction

Requires:

1. Instruction was created with detail enabled
2. Skipdata is disabled
3. Capstone was not compiled in diet mode

pub fn lib_version() -> (u32, u32)

Returns a tuple (major, minor) indicating the version of the capstone C library.

pub fn supports_arch(arch: Arch) -> bool

Returns whether the capstone library supports a given architecture.

pub fn is_diet() -> bool

Returns whether the capstone library was compiled in diet mode.

Trait Implementations

impl<'cs> Debug for Capstone<'cs>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'cs> Drop for Capstone<'cs>

fn drop(&mut self)

Executes the destructor for this type.