Trait ArchitectureOperations 

pub trait ArchitectureOperations {
    const INDEX_SELECTOR_REGISTER: &'static str;
    const ARGUMENT_REGISTER_0: &'static str;
    const ARGUMENT_REGISTER_1: &'static str;
    const ARGUMENT_REGISTER_2: &'static str;
    const POINTER_WIDTH_OVERRIDE: Option<i32> = None;

    // Required methods
    fn new(cpu: *mut ConfObject) -> Result<Self>
       where Self: Sized;
    fn cpu(&self) -> *mut ConfObject;
    fn disassembler(&mut self) -> &mut dyn TracerDisassembler;
    fn int_register(&mut self) -> &mut IntRegisterInterface;
    fn processor_info_v2(&mut self) -> &mut ProcessorInfoV2Interface;
    fn cpu_instruction_query(&mut self) -> &mut CpuInstructionQueryInterface;
    fn cpu_instrumentation_subscribe(
        &mut self,
    ) -> &mut CpuInstrumentationSubscribeInterface;
    fn cycle(&mut self) -> &mut CycleInterface;
    fn trace_pc(
        &mut self,
        instruction_query: *mut instruction_handle_t,
    ) -> Result<TraceEntry>;
    fn trace_cmp(
        &mut self,
        instruction_query: *mut instruction_handle_t,
    ) -> Result<TraceEntry>;

    // Provided methods
    fn new_unchecked(_: *mut ConfObject) -> Result<Self>
       where Self: Sized { ... }
    fn get_magic_index_selector(&mut self) -> Result<u64> { ... }
    fn get_magic_start_buffer_ptr_size_ptr(&mut self) -> Result<StartInfo> { ... }
    fn get_magic_start_buffer_ptr_size_val(&mut self) -> Result<StartInfo> { ... }
    fn get_magic_start_buffer_ptr_size_ptr_val(&mut self) -> Result<StartInfo> { ... }
    fn get_manual_start_info(
        &mut self,
        info: &ManualStartInfo,
    ) -> Result<StartInfo> { ... }
    fn write_start(&mut self, testcase: &[u8], info: &StartInfo) -> Result<()> { ... }
}

Each architecture must provide a struct that performs architecture-specific operations

Required Associated Constants

const INDEX_SELECTOR_REGISTER: &'static str

const ARGUMENT_REGISTER_0: &'static str

const ARGUMENT_REGISTER_1: &'static str

const ARGUMENT_REGISTER_2: &'static str

Provided Associated Constants

const POINTER_WIDTH_OVERRIDE: Option<i32> = None

Required Methods

fn new(cpu: *mut ConfObject) -> Result<Self>

where Self: Sized,

Create a new instance of the architecture operations

fn cpu(&self) -> *mut ConfObject

Return the saved CPU object for this archtiecture

fn disassembler(&mut self) -> &mut dyn TracerDisassembler

Return a mutable reference to the disassembler for this architecture

fn int_register(&mut self) -> &mut IntRegisterInterface

Return a mutable reference to the interface for reading and writing registers

fn processor_info_v2(&mut self) -> &mut ProcessorInfoV2Interface

Return a mutable reference to the interface for reading processor information

fn cpu_instruction_query(&mut self) -> &mut CpuInstructionQueryInterface

Return a mutable reference to the interface for querying CPU instructions

fn cpu_instrumentation_subscribe( &mut self, ) -> &mut CpuInstrumentationSubscribeInterface

Return a mutable reference to the interface for subscribing to CPU instrumentation events

fn cycle(&mut self) -> &mut CycleInterface

Return a mutable reference to the interface for querying CPU cycles and timing

fn trace_pc( &mut self, instruction_query: *mut instruction_handle_t, ) -> Result<TraceEntry>

fn trace_cmp( &mut self, instruction_query: *mut instruction_handle_t, ) -> Result<TraceEntry>

Provided Methods

fn new_unchecked(_: *mut ConfObject) -> Result<Self>

where Self: Sized,

Create a new instance of the architecture operations without checking the CPU

fn get_magic_index_selector(&mut self) -> Result<u64>

Return the value of the magic index selector register, which is used to determine whether a magic instruction should be used or skipped.

fn get_magic_start_buffer_ptr_size_ptr(&mut self) -> Result<StartInfo>

Get the magic start information from the harness which takes the arguments:

• buffer: The address of the buffer containing the testcase
• size_ptr: A pointer to a pointer-sized variable containing the size of the testcase

fn get_magic_start_buffer_ptr_size_val(&mut self) -> Result<StartInfo>

Get the magic start information from the harness which takes the arguments:

• buffer: The address of the buffer containing the testcase
• size_val: The maximum size of the testcase

fn get_magic_start_buffer_ptr_size_ptr_val(&mut self) -> Result<StartInfo>

Get the magic start information from the harness which takes the arguments:

• buffer: The address of the buffer containing the testcase
• size_ptr: A pointer to a pointer-sized variable to which the size is written
• size_val: The maximum size of the testcase

fn get_manual_start_info(&mut self, info: &ManualStartInfo) -> Result<StartInfo>

Returns the address and whether the address is virtual for the testcase buffer used by the manual start functionality

fn write_start(&mut self, testcase: &[u8], info: &StartInfo) -> Result<()>

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl ArchitectureOperations for Architecture

const INDEX_SELECTOR_REGISTER: &'static str = ""

const ARGUMENT_REGISTER_0: &'static str = ""

const ARGUMENT_REGISTER_1: &'static str = ""

const ARGUMENT_REGISTER_2: &'static str = ""

impl ArchitectureOperations for AArch64ArchitectureOperations

const INDEX_SELECTOR_REGISTER: &'static str = "x10"

const ARGUMENT_REGISTER_0: &'static str = "x9"

const ARGUMENT_REGISTER_1: &'static str = "x8"

const ARGUMENT_REGISTER_2: &'static str = "x7"

impl ArchitectureOperations for ARMArchitectureOperations

const INDEX_SELECTOR_REGISTER: &'static str = "r10"

const ARGUMENT_REGISTER_0: &'static str = "r9"

const ARGUMENT_REGISTER_1: &'static str = "r8"

const ARGUMENT_REGISTER_2: &'static str = "r7"

impl ArchitectureOperations for RISCVArchitectureOperations

const INDEX_SELECTOR_REGISTER: &'static str = "x10"

const ARGUMENT_REGISTER_0: &'static str = "x11"

const ARGUMENT_REGISTER_1: &'static str = "x12"

const ARGUMENT_REGISTER_2: &'static str = "x13"

impl ArchitectureOperations for X86ArchitectureOperations

const INDEX_SELECTOR_REGISTER: &'static str = "edi"

const ARGUMENT_REGISTER_0: &'static str = "esi"

const ARGUMENT_REGISTER_1: &'static str = "edx"

const ARGUMENT_REGISTER_2: &'static str = "ecx"

const POINTER_WIDTH_OVERRIDE: Option<i32>

impl ArchitectureOperations for X86_64ArchitectureOperations

const INDEX_SELECTOR_REGISTER: &'static str = "rdi"

const ARGUMENT_REGISTER_0: &'static str = "rsi"

const ARGUMENT_REGISTER_1: &'static str = "rdx"

const ARGUMENT_REGISTER_2: &'static str = "rcx"