Enum LowLevelILSSARegisterKind

pub enum LowLevelILSSARegisterKind<R: ArchReg> {
    Full(LowLevelILSSARegister<R>),
    Partial {
        full_reg: LowLevelILSSARegister<R>,
        partial_reg: CoreRegister,
    },
}

The kind of SSA register.

An SSA register can exist in two states:

• Full, e.g. eax on x86
• Partial, e.g. al on x86

If you intend to query for the ssa uses or definitions you must retrieve the physical register using the function LowLevelILSSARegisterKind::physical_reg which will give you the actual LowLevelILSSARegister.

Variants

Full(LowLevelILSSARegister<R>)

A full register is one that is not aliasing another, such as eax on x86 or rax on x86_64.

Partial

Fields

full_reg: LowLevelILSSARegister<R>

This is the non-aliased register.

This register is what is used for dataflow, otherwise the backing storage of aliased registers like al on x86 would contain separate value information from the physical register eax.

NOTE: While this is a LowLevelILSSARegister temporary registers are not allowed in partial assignments, so this will always be an actual architecture register.

partial_reg: CoreRegister

This is the aliased register.

On x86 if the register al is used that would be considered a partial register, with the full register eax being used as the backing storage.

Implementations

impl<R: ArchReg> LowLevelILSSARegisterKind<R>

pub fn new_full(kind: LowLevelILRegisterKind<R>, version: u32) -> Self

pub fn new_partial( full_reg: LowLevelILRegisterKind<R>, version: u32, partial_reg: CoreRegister, ) -> Self

pub fn physical_reg(&self) -> LowLevelILSSARegister<R>

This is the non-aliased register used. This should be called when you intend to actually query for SSA dataflow information, as a partial register is prohibited from being used.

Example

On x86 al in the LLIL SSA will have a physical register of eax.

pub fn name(&self) -> Cow<'_, str>

Gets the displayable register, for partial this will be the partial register name.

Example

On x86 this will display “al” not “eax”.

Trait Implementations

impl<R: ArchReg> AsRef<LowLevelILSSARegister<R>> for LowLevelILSSARegisterKind<R>

fn as_ref(&self) -> &LowLevelILSSARegister<R>

Converts this type into a shared reference of the (usually inferred) input type.

impl<R: Clone + ArchReg> Clone for LowLevelILSSARegisterKind<R>

fn clone(&self) -> LowLevelILSSARegisterKind<R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug + ArchReg> Debug for LowLevelILSSARegisterKind<R>

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

Formats the value using the given formatter.

impl<R: ArchReg> From<LowLevelILSSARegister<R>> for LowLevelILSSARegisterKind<R>

fn from(value: LowLevelILSSARegister<R>) -> Self

Converts to this type from the input type.

impl<R: ArchReg> From<LowLevelILSSARegisterKind<R>> for LowLevelILSSARegister<R>

fn from(value: LowLevelILSSARegisterKind<R>) -> Self

Converts to this type from the input type.

impl<R: Copy + ArchReg> Copy for LowLevelILSSARegisterKind<R>