[PATCH 8/9] liveupdate: Expose the sequence number for consecutive live updates
From: Chris Down
Date: Wed Nov 11 2026 - 02:58:24 EST
Export LUO's live update sequence number, so that fleet monitoring can
compare hosts on their first live update with hosts that have been
through several.
We want this because some bugs, like memory corruption, may only show up
after several live updates in a row.
Signed-off-by: Chris Down <chris@xxxxxxxxxxxxxx>
---
Documentation/ABI/testing/sysfs-class-misc-liveupdate | 9 +++++++++
Documentation/userspace-api/liveupdate.rst | 1 +
kernel/liveupdate/luo_core.c | 8 ++++++++
3 files changed, 18 insertions(+)
diff --git a/Documentation/ABI/testing/sysfs-class-misc-liveupdate b/Documentation/ABI/testing/sysfs-class-misc-liveupdate
index 608f788ef0fa..b0ba0f626793 100644
--- a/Documentation/ABI/testing/sysfs-class-misc-liveupdate
+++ b/Documentation/ABI/testing/sysfs-class-misc-liveupdate
@@ -24,6 +24,15 @@ Description: read only
the underlying KHO handover.
Users: system monitoring
+What: /sys/class/misc/liveupdate/incoming/liveupdate_num
+Date: Nov 2026
+Contact: kexec@xxxxxxxxxxxxxxxxxxx
+Description: read only
+ LUO sequence number passed by the previous kernel. Reads 0
+ if no LUO state was handed over, 1 after the first live
+ update in a sequence, and increments with each update.
+Users: system monitoring
+
What: /sys/class/misc/liveupdate/incoming/sessions
What: /sys/class/misc/liveupdate/incoming/files
Date: Nov 2026
diff --git a/Documentation/userspace-api/liveupdate.rst b/Documentation/userspace-api/liveupdate.rst
index 39bbb91d0dd4..61c246371200 100644
--- a/Documentation/userspace-api/liveupdate.rst
+++ b/Documentation/userspace-api/liveupdate.rst
@@ -50,6 +50,7 @@ Monitoring
Read ``/sys/class/misc/liveupdate/incoming/`` to monitor incoming
sessions and file retrievals without opening ``/dev/liveupdate``.
+``liveupdate_num`` gives the LUO sequence number for the current boot.
See Documentation/ABI/testing/sysfs-class-misc-liveupdate for the sysfs ABI.
See Also
diff --git a/kernel/liveupdate/luo_core.c b/kernel/liveupdate/luo_core.c
index ba174e9aae03..3ca7b3875247 100644
--- a/kernel/liveupdate/luo_core.c
+++ b/kernel/liveupdate/luo_core.c
@@ -441,6 +441,13 @@ static ssize_t state_show(struct device *dev, struct device_attribute *attr,
}
static DEVICE_ATTR_RO(state);
+static ssize_t liveupdate_num_show(struct device *dev,
+ struct device_attribute *attr, char *buf)
+{
+ return sysfs_emit(buf, "%llu\n", luo_global.liveupdate_num);
+}
+static DEVICE_ATTR_RO(liveupdate_num);
+
#define LUO_INCOMING_ATTR_RO(_name) \
static ssize_t _name##_show(struct device *dev, \
struct device_attribute *attr, char *buf) \
@@ -458,6 +465,7 @@ LUO_INCOMING_ATTR_RO(files_dropped);
static struct attribute *luo_incoming_attrs[] = {
&dev_attr_state.attr,
+ &dev_attr_liveupdate_num.attr,
&dev_attr_sessions.attr,
&dev_attr_files.attr,
&dev_attr_files_retrieved.attr,
--
2.54.0