Enum Error 

pub enum Error {
    UnimplementedTrap(u16),
    Halted,
    Timeout(usize),
    Trace(String),
}

Top-level error returned by crate::runner::FixtureRunner and the supporting traps. Variants:

• Error::UnimplementedTrap — the dispatcher reached an A-line trap word with no matching handler. The trap word is included for diagnosis. Adding a (is_tool, trap_num) => arm in the appropriate src/trap/*.rs file is how you fix this.

• Error::Halted — the guest application called ExitToShell (or otherwise reached a halt state). Not a failure per se; callers that loop on run_steps use still_running == false from the tuple instead of catching this.

• Error::Timeout — execution exceeded a caller-supplied instruction budget without halting. The carried usize is the instruction-count cap that was hit.

• Error::Trace — recording-side error from the cross-runtime parity trace sink (filesystem write, JSON serialisation, etc). Surfaces only when a trace sink is installed via set_trace_sink.

Variants

UnimplementedTrap(u16)

The dispatcher reached an A-line trap word with no matching handler. The trap word is included for diagnosis.

Halted

The guest application reached a halt state (typically via ExitToShell).

Timeout(usize)

Execution exceeded the caller-supplied instruction budget without halting. The carried value is the instruction count at the timeout.

Trace(String)

Cross-runtime parity trace sink returned an error (filesystem write, JSON serialisation, etc).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.