[PATCH v4 02/19] kho: block: Record the entry size in the block header
Tarun Sahu
tarunsahu at google.com
Mon Nov 9 21:01:45 PST 2026
Subsystems using the KHO Serialization Blocks framework currently do
not record the serialized entry size in the block header. The entry size
is only known to individual callers, which must track and store it in an
owning serialized data structure. If a newer source kernel adds fields
to an entry, the changed entry size breaks the stride when an older
target kernel iterates over blocks.
Add an entry_size field to struct kho_block_header_ser. On the outgoing
side, record bs->entry_size into every block header during allocation.
During restoration, derive the entry stride directly from the block
header instead of relying on caller-supplied dimensions. The
kho_block_set_init() interface remains unchanged. A zero entry size,
or one that differs between blocks of a set, is rejected during
restoration.
This change modifies the serialized layout of struct kho_block_header_ser
and shifts the offset of serialized entries within preserved blocks.
Bump KHO_FDT_COMPATIBLE from kho-v4 to kho-v5 so that pre-v5 and post-v5
kernels cleanly reject mismatched handover state during boot. Also
update the stale compatible string example in the documentation.
Suggested-by: Pratyush Yadav <pratyush at kernel.org>
Signed-off-by: Tarun Sahu <tarunsahu at google.com>
---
include/linux/kho/abi/block.h | 10 ++++----
include/linux/kho/abi/kexec_handover.h | 6 ++---
kernel/liveupdate/kho_block.c | 32 +++++++++++++++++++++++---
3 files changed, 38 insertions(+), 10 deletions(-)
diff --git a/include/linux/kho/abi/block.h b/include/linux/kho/abi/block.h
index 36bdbaf9b3b8..a40b0906c821 100644
--- a/include/linux/kho/abi/block.h
+++ b/include/linux/kho/abi/block.h
@@ -40,9 +40,10 @@
/**
* struct kho_block_header_ser - Header for the serialized data block.
- * @next: Physical address of the next struct kho_block_header_ser.
- * @count: The number of entries that immediately follow this header in the
- * memory block.
+ * @next: Physical address of the next struct kho_block_header_ser.
+ * @count: The number of entries that immediately follow this header in the
+ * memory block.
+ * @entry_size: The size in bytes of each serialized entry in the block.
*
* This structure is located at the beginning of a block of physical memory
* preserved across a kexec. It provides the necessary metadata to interpret
@@ -51,9 +52,10 @@
struct kho_block_header_ser {
u64 next;
u64 count;
+ u64 entry_size;
};
-static_assert(sizeof(struct kho_block_header_ser) == 16);
+static_assert(sizeof(struct kho_block_header_ser) == 24);
static_assert(!IS_ENABLED(CONFIG_64BIT) ||
__alignof__(struct kho_block_header_ser) == 8);
diff --git a/include/linux/kho/abi/kexec_handover.h b/include/linux/kho/abi/kexec_handover.h
index 2f4fb9c63942..6f12f5037ea5 100644
--- a/include/linux/kho/abi/kexec_handover.h
+++ b/include/linux/kho/abi/kexec_handover.h
@@ -41,7 +41,7 @@
* restore the preserved data.::
*
* / {
- * compatible = "kho-v3";
+ * compatible = "kho-v5";
*
* preserved-memory-map = <0x...>;
*
@@ -62,7 +62,7 @@
* };
*
* Root KHO Node (/):
- * - compatible: "kho-v3"
+ * - compatible: "kho-v5"
*
* Identifies the overall KHO ABI version.
*
@@ -90,7 +90,7 @@
*/
/* The compatible string for the KHO FDT root node. */
-#define KHO_FDT_COMPATIBLE "kho-v4"
+#define KHO_FDT_COMPATIBLE "kho-v5"
/* The FDT property for the preserved memory map. */
#define KHO_FDT_MEMORY_MAP_PROP_NAME "preserved-memory-map"
diff --git a/kernel/liveupdate/kho_block.c b/kernel/liveupdate/kho_block.c
index 0d2a342ef422..9b148009085e 100644
--- a/kernel/liveupdate/kho_block.c
+++ b/kernel/liveupdate/kho_block.c
@@ -16,6 +16,12 @@
* array of serialized entries. Multiple blocks are linked together via a
* physical pointer in the header, forming a linked list that can be easily
* traversed in both the current and the next kernel.
+ *
+ * Each block header also records the size of its entries. A newer kernel may
+ * append fields to an entry, so the kernel that writes a block and the kernel
+ * that reads it can use different entry sizes. The reader steps through the
+ * entries with the recorded size, so every entry is found, and it does not read
+ * beyond the recorded size of an entry.
*/
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
@@ -110,6 +116,8 @@ static int kho_block_set_grow_one(struct kho_block_set *bs)
if (IS_ERR(ser))
return PTR_ERR(ser);
+ ser->entry_size = bs->entry_size;
+
err = kho_block_add(bs, ser);
if (err) {
kho_block_free_ser(bs, ser);
@@ -242,7 +250,8 @@ static bool kho_block_set_is_cyclic(struct kho_block_set *bs)
*
* Restores a serialized block set from a given physical address. The caller is
* responsible for ensuring that the block set @bs has been allocated and
- * initialized prior to calling this function.
+ * initialized prior to calling this function. The entry size and the number
+ * of entries per block are taken from the restored block headers.
*
* Return: 0 on success, or a negative errno on failure.
*/
@@ -250,6 +259,7 @@ int kho_block_set_restore(struct kho_block_set *bs, u64 head_pa)
{
struct kho_block_header_ser *ser;
u64 next_pa = head_pa;
+ u64 entry_size = 0;
int err;
/* Restored block sets use size from the previous kernel */
@@ -264,8 +274,21 @@ int kho_block_set_restore(struct kho_block_set *bs, u64 head_pa)
}
while (next_pa) {
+ u64 capacity;
+
ser = phys_to_virt(next_pa);
- if (!ser->count || ser->count > bs->count_per_block) {
+ if (!ser->entry_size || (entry_size && ser->entry_size != entry_size)) {
+ pr_warn("Block contains invalid entry size: %llu\n",
+ ser->entry_size);
+ err = -EINVAL;
+ goto err_destroy;
+ }
+ entry_size = ser->entry_size;
+ bs->entry_size = entry_size;
+ capacity = (KHO_BLOCK_SIZE - sizeof(*ser)) / bs->entry_size;
+ bs->count_per_block = capacity;
+
+ if (!ser->count || ser->count > capacity) {
pr_warn("Block contains invalid entry count: %llu\n",
ser->count);
err = -EINVAL;
@@ -370,7 +393,10 @@ void *kho_block_set_it_reserve_entry(struct kho_block_set_it *it)
* @it: The block iterator.
*
* Iterates through previously written entries during state deserialization,
- * respecting the actual count stored in each block's header.
+ * respecting the actual count stored in each block's header. Entries are
+ * spaced by the entry size recorded by the kernel that wrote them, which can
+ * be smaller or larger than the caller's structure. Fields beyond that size
+ * are not present in the entry.
*
* Return: A pointer to the next serialized entry, or NULL if all serialized
* entries have been read.
--
2.56.0.506.g506a7eabc5-goog
More information about the kexec
mailing list