run_stop_t Struct Reference

How the run ended: final engine status plus every stop flag. More...

Data Fields
uc_err	err
	Final uc_emu_start status.
uint32_t	run_pc
	PC where the run stopped.
uint32_t	chunks
	Outer chunks executed.
uint32_t	max_chunks
	The chunk budget in force.
double	wall_s
	The wall-clock bound in force (seconds).
uint32_t	idle_stop_chunks
	RA8_EMU_IDLE_STOP window (0 = off).
bool	timed_out
	Wall-clock guard fired (truncated run).
bool	idle_stopped
	Idle steady-state stop fired.
bool	usb_stopped
	USB early stop (CONFIGURED / STOP_ON hit).
bool	stop_sym_hit
	–stop-sym threshold reached.
bool	prof_stopped
	Profiler compute-idle stop fired.

Detailed Description

How the run ended: final engine status plus every stop flag.

Snapshot of the run loop's stop bookkeeping, bundled so the report printers receive one read-only view of the outcome instead of a dozen loose parameters.

Invariant

At most one of the early-stop flags reflects the stop cause; the report prints every one that is set.

See also

internal_run_print_stop_summary() First consumer.

internal_run_print_verdict() Second consumer.

Since

0.1.0

Definition at line 54 of file emu_run_report.c.

Field Documentation

chunks

uint32_t run_stop_t::chunks

Outer chunks executed.

Definition at line 57 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

err

uc_err run_stop_t::err

Final uc_emu_start status.

Definition at line 55 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

idle_stop_chunks

uint32_t run_stop_t::idle_stop_chunks

RA8_EMU_IDLE_STOP window (0 = off).

Definition at line 60 of file emu_run_report.c.

Referenced by internal_run_print_verdict().

idle_stopped

bool run_stop_t::idle_stopped

Idle steady-state stop fired.

Definition at line 62 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

max_chunks

uint32_t run_stop_t::max_chunks

The chunk budget in force.

Definition at line 58 of file emu_run_report.c.

Referenced by internal_run_print_verdict().

prof_stopped

bool run_stop_t::prof_stopped

Profiler compute-idle stop fired.

Definition at line 65 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

run_pc

uint32_t run_stop_t::run_pc

PC where the run stopped.

Definition at line 56 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary().

stop_sym_hit

bool run_stop_t::stop_sym_hit

–stop-sym threshold reached.

Definition at line 64 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

timed_out

bool run_stop_t::timed_out

Wall-clock guard fired (truncated run).

Definition at line 61 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

usb_stopped

bool run_stop_t::usb_stopped

USB early stop (CONFIGURED / STOP_ON hit).

Definition at line 63 of file emu_run_report.c.

Referenced by internal_run_print_stop_summary(), and internal_run_print_verdict().

wall_s

double run_stop_t::wall_s

The wall-clock bound in force (seconds).

Definition at line 59 of file emu_run_report.c.

Referenced by internal_run_print_verdict().

---

The documentation for this struct was generated from the following file:

• tools/ra8_emulator/src/engine/emu_run_report.c