ra8_cache_store_entry_t Struct Reference

One RAM index slot: key -> {header sector, run length, payload len}. More...

#include <ra8_cache_store.h>

Data Fields
uint32_t	key
	Content key (source CRC-32); valid iff in-use.
uint32_t	start_sector
	Logical sector of the entry header.
uint32_t	byte_len
	Payload length in bytes.
uint16_t	sector_count
	Run length (header + payload sectors).
uint8_t	flags
	ra8_cache_store_flag_t bit set.
uint8_t	reserved
	Padding; keeps the slot 16 bytes.

Detailed Description

One RAM index slot: key -> {header sector, run length, payload len}.

Caller-owned array element (see ra8_cache_store_cfg_t::index). Treat as private – populated and consumed only by the store. An entry's on-flash run is [start_sector, start_sector + sector_count) with the header at start_sector and the payload in the sectors after it.

Invariant

sector_count >= 1 when k_ra8_cache_store_flag_in_use is set.

Since

0.1.0

Definition at line 136 of file ra8_cache_store.h.

Field Documentation

byte_len

uint32_t ra8_cache_store_entry_t::byte_len

Payload length in bytes.

Definition at line 139 of file ra8_cache_store.h.

Referenced by internal_dir_pack_sector(), and ra8_cache_store_get().

flags

uint8_t ra8_cache_store_entry_t::flags

ra8_cache_store_flag_t bit set.

Definition at line 141 of file ra8_cache_store.h.

Referenced by internal_dir_pack_sector(), internal_index_used(), internal_run_free(), priv_cache_store_index_add(), priv_cache_store_index_find(), priv_cache_store_super_write(), ra8_cache_store_evict(), and ra8_cache_store_pin().

key

uint32_t ra8_cache_store_entry_t::key

Content key (source CRC-32); valid iff in-use.

Definition at line 137 of file ra8_cache_store.h.

Referenced by internal_dir_pack_sector(), and priv_cache_store_index_find().

reserved

uint8_t ra8_cache_store_entry_t::reserved

Padding; keeps the slot 16 bytes.

Definition at line 142 of file ra8_cache_store.h.

sector_count

uint16_t ra8_cache_store_entry_t::sector_count

Run length (header + payload sectors).

Definition at line 140 of file ra8_cache_store.h.

Referenced by internal_dir_pack_sector(), internal_run_free(), ra8_cache_store_evict(), and ra8_cache_store_get().

start_sector

uint32_t ra8_cache_store_entry_t::start_sector

Logical sector of the entry header.

Definition at line 138 of file ra8_cache_store.h.

Referenced by internal_dir_pack_sector(), internal_run_free(), ra8_cache_store_evict(), and ra8_cache_store_get().

---

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

• libs/ra8_cache_store/inc/ra8_cache_store.h