Struct Instruction

pub struct Instruction { /* private fields */ }

This structure represents a x86/x86-64 instruction

Implementations

impl Instruction

pub fn opcode(&self) -> Opcode

The instruction opcode as defined in LLVM

pub fn operands(&self) -> Operands<'_>

Return an iterator over the x86::Operands operands

pub fn has_lock_prefix(&self) -> bool

True if this instruction has a LOCK prefix

pub fn is_lockable(&self) -> bool

True if the LOCK prefix is architecturally valid on this instruction

pub fn is_atomic(&self) -> bool

True if this instruction executes as an atomic read-modify-write

pub fn lock(&self) -> Option<Instruction>

Re-encoded copy of this instruction with a LOCK prefix added.

If the instruction already has a LOCK prefix, it returns a plain copy.

pub fn unlock(&self) -> Option<Instruction>

Re-encoded copy of this instruction with the LOCK prefix removed.

If the instruction does not have a LOCK prefix, it returns a plain copy or None if the LOCK semantic can’t be removed.

Trait Implementations

impl Display for Instruction

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

Formats the value using the given formatter.

impl Instruction for Instruction

fn address(&self) -> u64

Address of the instruction

fn size(&self) -> u64

Size of the instruction in bytes

fn raw(&self) -> &[u8]

Raw bytes of the current instruction

fn mnemonic(&self) -> String

Instruction mnemonic (e.g. br)

fn to_string_no_address(&self) -> String

Same as the Display representation (i.e. ToString::to_string) but without the address as prefix

fn is_call(&self) -> bool

True if the instruction is a call

fn is_terminator(&self) -> bool

True if the instruction marks the end of a basic block

fn is_branch(&self) -> bool

True if the instruction is a branch

fn is_syscall(&self) -> bool

True if the instruction is a syscall

fn is_memory_access(&self) -> bool

True if the instruction performs a memory access

fn is_move_reg(&self) -> bool

True if the instruction is a register to register move.

fn is_add(&self) -> bool

True if the instruction performs an arithmetic addition.

fn is_trap(&self) -> bool

True if the instruction is a trap.

fn is_barrier(&self) -> bool

True if the instruction prevents executing the instruction that immediatly follows the current. This includes return or unconditional branch instructions

fn is_return(&self) -> bool

True if the instruction is a return

fn is_indirect_branch(&self) -> bool

True if the instruction is and indirect branch.

fn is_conditional_branch(&self) -> bool

True if the instruction is conditionally jumping to the next instruction or an instruction into some other basic block.

fn is_unconditional_branch(&self) -> bool

True if the instruction is jumping (unconditionally) to some other basic block.

fn is_compare(&self) -> bool

True if the instruction is a comparison

fn is_move_immediate(&self) -> bool

True if the instruction is moving an immediate

fn is_bitcast(&self) -> bool

True if the instruction is doing a bitcast

fn memory_access(&self) -> MemoryAccess

Memory access flags

fn branch_target(&self) -> Result<u64, Error>

Given a Instruction::is_branch instruction, try to evaluate the address of the destination.