Cookie for rabook_import_compile_adapter_m33 (the M33-offload binding). More...

#include <rabook_import_compiler.h>

Collaboration diagram for rabook_import_compiler_m33_ctx_t:

Data Fields
uint8_t *	epub_load_buf
	Buffer the source .epub is read into.
uint32_t	epub_load_cap
	Capacity of `epub_load_buf` in bytes.
uint8_t *	blob_buf
	Buffer the dispatched RABOOK1 blob lands in.
uint32_t	blob_cap
	Capacity of `blob_buf` in bytes.
ra8_dual_core_compile_dispatch_fn	dispatch
	Cross-core compile seam (non-NULL).
void *	dispatch_ctx
	Cookie forwarded to `dispatch`.
rabook_import_compiler_ctx_t *	fallback
	In-core retry cookie used if the offload fails; NULL = offload-only.

Detailed Description

Cookie for rabook_import_compile_adapter_m33 (the M33-offload binding).

Carries no parser/builder arenas – those live on the secondary core. The adapter reads the source .epub into epub_load_buf, hands the bytes to dispatch (which compiles on the M33 and returns the blob in blob_buf), validates, and writes the blob out. dispatch is the DI seam: production binds the shared-mailbox shim, host tests bind a mock. The whole-file read is inherent to the cross-core transport (the M33 needs the source resident in shared memory); a source larger than epub_load_cap is reported as a transport overflow (k_ra8_err_no_mem) so the streamed in-core fallback – which has no size ceiling (#230) – can still import it.

fallback is the robustness seam: when the offload fails with a TIMEOUT/FAULT or a transport overflow (the .epub itself may be fine), the adapter retries the compile IN-CORE through this cookie so the import still yields a valid .rabook. It is OPTIONAL – leave it NULL to keep the adapter offload-only (the offload error then propagates).

Invariant: epub_load_buf, blob_buf and dispatch are non-NULL and each buffer holds its stated capacity.; fallback is either NULL or a fully-populated in-core cookie.