rabook_import_stamp_t Struct Reference

Body of the sidecar freshness marker (<name>.rabook.mrk). More...

#include <rabook_import.h>

Data Fields
uint32_t	magic
	k_rabook_import_stamp_magic.
uint32_t	format_version
	.rabook (RABOOK1) on-disk layout revision.
uint32_t	importer_version
	Compiler/importer stamp; bump to invalidate.
uint32_t	source_size
	Byte length of the source .epub.
uint32_t	source_crc32
	CRC-32/ISO-HDLC of the source .epub bytes.

Detailed Description

Body of the sidecar freshness marker (<name>.rabook.mrk).

Written verbatim as raw bytes after a successful compile and read back to gate the fast path. It is an opaque self-describing record consumed only by the same firmware build that wrote it, so the little-endian field encoding never crosses a byte-order boundary. The fast path is taken only when the on-disk stamp equals the stamp the running firmware expects for the current source (a single memcmp, so there is no compound freshness decision to MC/DC).

Invariant

magic == k_rabook_import_stamp_magic for a valid marker.

Since

Version 0.1.0

Definition at line 113 of file rabook_import.h.

Field Documentation

format_version

uint32_t rabook_import_stamp_t::format_version

.rabook (RABOOK1) on-disk layout revision.

Definition at line 115 of file rabook_import.h.

Referenced by internal_cache_is_fresh().

importer_version

uint32_t rabook_import_stamp_t::importer_version

Compiler/importer stamp; bump to invalidate.

Definition at line 116 of file rabook_import.h.

Referenced by internal_cache_is_fresh().

magic

uint32_t rabook_import_stamp_t::magic

k_rabook_import_stamp_magic.

Definition at line 114 of file rabook_import.h.

Referenced by internal_cache_is_fresh().

source_crc32

uint32_t rabook_import_stamp_t::source_crc32

CRC-32/ISO-HDLC of the source .epub bytes.

Definition at line 118 of file rabook_import.h.

Referenced by internal_cache_is_fresh().

source_size

uint32_t rabook_import_stamp_t::source_size

Byte length of the source .epub.

Definition at line 117 of file rabook_import.h.

Referenced by internal_cache_is_fresh().

---

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

• apps/shared_libs/rabook_import/inc/rabook_import.h