Struct FakeArch

pub struct FakeArch;

A simple, fake architecture for testing.

Trait Implementations

impl Arch for FakeArch

const PAGE_BITS: usize = 12usize

The number of bits that are used in a page. The page size is 2**PAGE_BITS. For example, for a page size of 4096 bytes PAGE_BITS would be 12.

const PC: Self::GpReg = {transmute(0x00): <arch::fake::FakeArch as arch::Arch>::GpReg}

The program counter register.

const ZERO: Self::GpReg = {transmute(0x14): <arch::fake::FakeArch as arch::Arch>::GpReg}

The zero register. If the architecture does not explicitly list a zero register, you can invent one.

const INSTRUCTION_ALIGNMENT: usize = 1usize

The alignment of the instructions. Must be a multiple of 2.

type CpuState = FakeState

The CPU state representation.

type Reg = FakeReg

The register representation.

type GpReg = FakeReg

The general-purpose register representation. This should be equal to Self::Reg, or be a subset. General-purpose registers must be integers (see crate::value::ValueType).

type Flag = FakeFlag

The flag representation.

fn reg(reg: Self::GpReg) -> Self::Reg

Converts a general-purpose register into a generic register. This must always succeed.

fn iter_gpregs() -> impl Iterator<Item = Self::GpReg>

Returns an iterator that iterates over all general-purpose registers. The zero register must not be included, as it is not a real register.

fn iter_regs() -> impl Iterator<Item = Self::Reg>

Returns an iterator that iterates over all registers. The zero register must not be included, as it is not a real register.

fn flagreg_to_flags( reg: FakeReg, start_byte: usize, end_byte: usize, ) -> &'static [Self::Flag]

Returns the flags associated with the byte range in the flags register. By convention, a flag register should contain one flag per byte.

fn try_reg_to_gpreg(reg: Self::Reg) -> Option<Self::GpReg>

Converts a generic register into a general-purpose register. If the generic register is not a general-purpose register, None is returned.

impl Clone for FakeArch

fn clone(&self) -> FakeArch

Returns a copy of the value.

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

Performs copy-assignment from source.

impl CpuState<FakeArch> for FakeState

type DiffMask = ()

The type of the difference mask used in CpuState::find_dataflows_masked.

fn gpreg(&self, reg: FakeReg) -> u64

Returns the value of reg.

fn reg(&self, reg: <FakeArch as Arch>::Reg) -> Value<'_>

Returns the value of reg.

fn modify_reg<F: FnOnce(MutValue<'_>)>( &mut self, reg: <FakeArch as Arch>::Reg, update: F, )

Modifies the value of reg using update function update.

fn flag(&self, flag: FakeFlag) -> bool

Returns the value of flag.

fn set_gpreg(&mut self, reg: FakeReg, value: u64)

Sets the value of reg.

fn set_flag(&mut self, flag: FakeFlag, value: bool)

Sets the value of flag.

fn size() -> usize

Returns the size (in bytes) of the CPU state.

fn state_byte_to_reg(byte: StateByte) -> (<FakeArch as Arch>::Reg, usize)

Converts a state byte to a register. Inverse of CpuState::reg_to_state_byte.

fn reg_to_state_byte(reg: <FakeArch as Arch>::Reg, byte: usize) -> StateByte

Converts a (register, byte index) tuple to a state byte. Inverse of CpuState::state_byte_to_reg.

fn find_differences<F: FnMut(StateByte)>(&self, other: &Self, found: &mut F)

Enumerates over all differences between the two state pairs. Calls found for each state byte that differs between self and other. The call order is unspecified.

fn create_diff_mask<I: Iterator<Item = StateByte>>(_items: I) -> Self::DiffMask

Creates a mask of state bytes whose differences can be ignored.

fn create<R: FnMut(A::Reg, MutValue<'_>)>(regval: R) -> Self

Creates a new CPU state using regval to determine the values of the registers.

fn default_with_pc(pc: u64) -> Self

Creates a default state with the program counter set to pc.

fn get_state_byte(&self, byte: StateByte) -> u8

Returns the value of the byte byte in the CPU state.

fn set_state_byte(&mut self, byte: StateByte, value: u8)

Sets the value of the byte byte in the CPU state.

fn state_bytes_unequal(&self, dest: StateByte, other: &Self) -> bool

Returns true if the value of the specified state byte in self is not equal to the value in other.

fn state_bytes_equal(&self, dest: StateByte, other: &Self) -> bool

Returns true if the value of the specified state byte in self is equal to the value in other.

fn find_dataflows_masked<F: FnMut(StateByte)>( b: SystemStateIoPair<'_, A>, a: SystemStateIoPair<'_, A>, dest_diff_mask: &Self::DiffMask, diff_mask: &Self::DiffMask, found: &mut F, )

Enumerates over all differences between the two state pairs. Calls found for each state byte that differs between self and other. diff_mask is a hint of differences that can be ignored. Therefore, this function may call found even for state bytes that can be ignored according to diff_mask.

impl Debug for FakeArch

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

Formats the value using the given formatter.

impl Default for FakeArch

fn default() -> FakeArch

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FakeArch

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for FakeArch

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for FakeArch

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl<F, M> Oracle<FakeArch> for FakeOracle<F, M>

where F: Fn(&SystemState<FakeArch>) -> Result<SystemState<FakeArch>, OracleError>, M: Fn(&SystemState<FakeArch>) -> Result<Vec<Addr>, OracleError>,

const UNRELIABLE_INSTRUCTION_FETCH_ERRORS: bool = false

Set to true if the instruction fetch errors are unreliable.

type MappableArea = AnyArea

The memory addresses that can be mapped by this oracle.

fn mappable_area(&self) -> Self::MappableArea

Returns the memory addresses that can be mapped by this oracle.

fn page_size(&mut self) -> u64

Returns the page size of the oracle.

fn observe( &mut self, before: &SystemState<FakeArch>, ) -> Result<SystemState<FakeArch>, OracleError>

Observes the output state after executing a single instruction in the before state.

fn scan_memory_accesses( &mut self, before: &SystemState<FakeArch>, ) -> Result<Vec<Addr>, OracleError>

Uses debugging registers to determine all memory addresses accessed by the instruction. If this is not supported, returns an empty Vec.

fn debug_dump(&mut self)

Prints debugging information about the oracle.

fn restart(&mut self)

Restart the oracle, if possible.

fn kill(self)

Kills the oracle, if possible.

fn batch_observe_iter<'a, S: AsSystemState<FakeArch> + 'a, I: IntoIterator<Item = S> + 'a>( &'a mut self, states: I, ) -> impl Iterator<Item = Observation<S, FakeArch>>

Performs many observations in one go. Behaves idential to Self::observe, but is much more efficient.

fn batch_observe_gpreg_only_iter<'a, S: AsSystemState<FakeArch> + 'a, I: IntoIterator<Item = S> + 'a>( &'a mut self, states: I, ) -> impl Iterator<Item = Observation<S, FakeArch>>

Performs many observations in one go. Only reads and writes the general-purpose registers. Other registers may have arbitrary values.

fn random_mappable_page(&self, rng: &mut impl Rng) -> Page<A>

Returns a random mappable page.

fn observe_carefully( &mut self, before: &SystemState<A>, ) -> Result<SystemState<A>, OracleError>

Observes the output state after executing a single instruction in the before state. If possible, uses debugging registers to exhaustively check the exact memory locations that are accessed. Returns a memory access error if a memory is accessed that is not set in before.

fn batch_observe<'a, const N: usize, S: AsSystemState<A> + 'a>( &mut self, states: [S; N], ) -> [Observation<S, A>; N]

Performs many observations in one go. Behaves idential to Self::observe, but is much more efficient.

impl Ord for FakeArch

fn cmp(&self, other: &FakeArch) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for FakeArch

fn eq(&self, other: &FakeArch) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for FakeArch

fn partial_cmp(&self, other: &FakeArch) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for FakeArch

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for FakeArch

impl Eq for FakeArch

impl StructuralPartialEq for FakeArch