From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 3653FC624DB for ; Thu, 3 Sep 2026 02:35:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Type:Cc:To:From: Subject:Message-ID:References:Mime-Version:In-Reply-To:Date:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=NXIsSz+mo8g74Vp8Vf3mNp3/WCeSzCYf+BKqQ2Sb8NU=; b=SLYFVrxp8jkoGbv7lmgGrgGQZr X2o/ul3h/P7wjkDcpW16SL5IO8eY4KxEXAtG3B4o2sLW6ABK4cIhCnCwtAyk2HIETOakQ9SQH2d0A VQQ4blSxp/knUOcqkjfyKv86kE4Kof2mR3SyuQcjxSF5XomhroN33BtT5a6vKbd9IFDfD/sYnRubT QRFQWQzwQBIj4wJS+IhAc8nFBQFuwvsjCjvYJEAFvatjKHxyarjFhNyU29rvoQcih2SDWqdjTYS1o yBRHgNVbHPmmVWhmgmuHvGMwDLGHgYR4Rm3xp3nGCJ6dS3TBu2Q07CMcSFZ7PZSvAYvdBGEKKLnQR oLfj1uFQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1x1xI7-0000000GDCD-0D1k; Thu, 03 Sep 2026 02:35:03 +0000 Received: from mail-pj1-x1045.google.com ([2607:f8b0:4864:20::1045]) by bombadil.infradead.org with esmtps (Exim 4.99.1 #2 (Red Hat Linux)) id 1x1xI2-0000000GD7q-44fA for kexec@lists.infradead.org; Thu, 03 Sep 2026 02:35:00 +0000 Received: by mail-pj1-x1045.google.com with SMTP id 98e67ed59e1d1-38ea32e57e2so3749764a91.1 for ; Wed, 02 Sep 2026 19:34:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20251104; t=1788402897; x=1789007697; darn=lists.infradead.org; h=content-type:cc:to:from:subject:message-id:references:mime-version :in-reply-to:date:from:to:cc:subject:date:message-id:reply-to :content-type; bh=NXIsSz+mo8g74Vp8Vf3mNp3/WCeSzCYf+BKqQ2Sb8NU=; b=tZ0R+54iXPQKZB1q5yEtvhLpf1W03R58DMcxdX2y6NyYP03Y/0Uqusl5sMKteIxCzj a5iniDKYE/sB/Mo2tiKGcCnJLrN60wj7n9Z11hlV3X59SLzJ7xAJclYXZxlNSwBfVbKF TbJLB6wucg0bVEIGH/16d3WNTy3oyeO/uf0HWYZVjsoXJ1cQmPMhsdYZ2HuOh2cLIzxk ApXBu74ES4FTF7czOByH3JotVRUT2Y7sSRzvse+3LXQvCx3v475vYe5sCpdXp1MRB2aH MmkhaaliPhnQCoDw3648KrK92WHbGpovjf5+u6e2doKklY1EuDrm8Ni5NLy67X33/cd0 PK7A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788402897; x=1789007697; h=content-type:cc:to:from:subject:message-id:references:mime-version :in-reply-to:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=NXIsSz+mo8g74Vp8Vf3mNp3/WCeSzCYf+BKqQ2Sb8NU=; b=dYx6T+8cYrlLsuFAg38yJi16dugMptys+Owtak22lgFWY6NcTCc4Pk2urhJXo7oq8r wo8fcRN2/EXbUXGlbE0ge82O4OBP4GZgFhRwMwqxSFXFp8j/7f1plxVN3zWZXkm+VYm2 eWQ4G/95K1xnbxjbIploqDcpX5qaBrMoQ18WyXYmW26uuAnwzbE1iM0uxPSYOJVWBVgY ICMmGQj+t8Dc87eATOH8H+9rTyz+gwlFH7f3EzVZodAm9OVbjKuvAK7pNqJ3mRXEtbKN VPHUusZME0gg116MK81fr6xKsIuilKauiaPQZa1pRq1e8J4+bBmLvtuSXywQi0ejgatk dbkg== X-Forwarded-Encrypted: i=1; AKwUvBySzcI7JXG2qqhwJ11Gc73YjwnPehISUXhU75+BVkYNFTWA1g6yzxjHjqFplgQClHNwn0CRDQ==@lists.infradead.org X-Gm-Message-State: AFuF++l8XbtYxGRHBfCdr4NMRG/tKC0FYxhr/DOtlfylTXYcj418fGep USE1Uhnr00xZY2JDZbd15BNX40tLn+j4onlyXN2h+1h99DWltkV4oUKxxD318uF5boZo3N++nFH ReArBGCEMBtUblsBVfNnuEA== X-Received: from dld23.prod.google.com ([2002:a05:7022:317:b0:13b:9d65:a542]) (user=loganodell job=prod-delivery.src-stubby-dispatcher) by 2002:a17:90b:2d83:b0:38f:5801:dc0e with SMTP id 98e67ed59e1d1-39aee049464mr14969285a91.15.1788402896637; Wed, 02 Sep 2026 19:34:56 -0700 (PDT) Date: Wed, 2 Sep 2026 19:34:50 -0700 In-Reply-To: <20260903023452.721732-1-loganodell@google.com> Mime-Version: 1.0 References: <20260903023452.721732-1-loganodell@google.com> X-Mailer: git-send-email 2.55.0.979.g7e5102b832-goog Message-ID: <20260903023452.721732-2-loganodell@google.com> Subject: [RFC PATCH 1/3] luo: Move to feature flags instead of compatibility strings From: Logan Odell To: arnd@arndb.de, pasha.tatashin@soleen.com, rppt@kernel.org, pratyush@kernel.org, graf@amazon.com, akpm@linux-foundation.org, pbonzini@redhat.com, maz@kernel.org, oupton@kernel.org, seanjc@google.com, bhelgaas@google.com, alex@shazbot.org, jgg@nvidia.com, kevin.tian@intel.com, dwmw2@infradead.org, baolu.lu@linux.intel.com, joro@8bytes.org, will@kernel.org, robin.murphy@arm.com Cc: linux-arch@vger.kernel.org, linux-kernel@vger.kernel.org, kexec@lists.infradead.org, linux-mm@kvack.org, kvm@vger.kernel.org, linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, linux-pci@vger.kernel.org, iommu@lists.linux.dev, Logan Odell Content-Type: text/plain; charset="UTF-8" X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.9.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260902_193459_010578_448346CC X-CRM114-Status: GOOD ( 25.60 ) X-BeenThere: kexec@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "kexec" Errors-To: kexec-bounces+kexec=archiver.kernel.org@lists.infradead.org Define a 128 byte header that can be used by all live update serialized structures. In this header, we reserve room for 64 features with supported, active, and required bits. Update the top level luo struct to use this instead of compatibility strings. Previous versions of the struct had smaller sizes, so add a minimum size check to avoid collisions with older kernels. Signed-off-by: Logan Odell --- include/linux/kho/abi/luo.h | 74 +++++++++++++++++++++++++++++------- kernel/liveupdate/luo_core.c | 44 +++++++++++++-------- 2 files changed, 90 insertions(+), 28 deletions(-) diff --git a/include/linux/kho/abi/luo.h b/include/linux/kho/abi/luo.h index 288076de6d4a..0a7662a0cf9a 100644 --- a/include/linux/kho/abi/luo.h +++ b/include/linux/kho/abi/luo.h @@ -13,15 +13,17 @@ * kernel. The ABI is built upon the Kexec HandOver framework and registers * the central `struct luo_ser` via the KHO raw subtree API. * - * This interface is a contract. Any modification to the structure fields, - * compatible strings, or the layout of the `__packed` serialization - * structures defined here constitutes a breaking change. Such changes require - * incrementing the version number in the relevant `_COMPATIBLE` string to - * prevent a new kernel from misinterpreting data from an old kernel. + * This interface is a contract. To ensure the stability of moving between + * kernel versions, any changes to the structures should only be additive + * and should utilize the feature flags to denote the supported, active, and + * required status of the feature. + * + * Features that are entirely optional can be added with the supported and + * active flags both asserted, and the required flag cleared. Features that + * require that the next kernel supports the feature should only be added as + * supported to allow compatible transition kernels. At a later time, the + * active and required flag should be asserted. * - * Changes are allowed provided the compatibility version is incremented; - * however, backward/forward compatibility is only guaranteed for kernels - * supporting the same ABI version. * * KHO Structure Overview: * The entire LUO state is encapsulated within a single KHO entry named "LUO". @@ -30,7 +32,7 @@ * Serialization Structures: * - struct luo_ser: * The central ABI structure that contains the overall state of the LUO. - * It includes the compatibility string, the liveupdate-number, and pointers + * It includes the feature flags, the liveupdate-number, and pointers * to sessions and FLBs. * * - struct luo_session_ser: @@ -58,19 +60,65 @@ #define _LINUX_KHO_ABI_LUO_H #include +#include #include #include +/** + * struct luo_feature_hdr - Feature negotiation and versioning header. + * @supp: Bitmask of features supported by the producing subsystem. + * @req: Bitmask of features required for safe deserialization by the + * receiving subsystem. + * @active: Bitmask of features actually active/used in the serialized payload. + * @reserved: Reserved for future use. + * + * This header can be embedded at the beginning of any serialized structure to + * provide forward and backward compatibility via feature negotiation across + * live update. + */ +struct luo_feature_hdr { + u64 supp; + u64 req; + u64 active; + u64 reserved[13]; +} __packed; + +#define LUO_FEATURE_ACTIVE(s, f) \ + do { \ + (s)->features.supp |= (u64)(f); \ + (s)->features.active |= (u64)(f); \ + } while (0) +#define LUO_FEATURE_SUPPORTED(s, f) ((s)->features.supp |= (u64)(f)) +#define LUO_FEATURE_REQUIRED(s, f) ((s)->features.req |= (u64)(f)) +#define LUO_FEATURE_IS_ACTIVE(s, f) (!!((s)->features.active & (u64)(f))) +#define LUO_FEATURE_IS_SUPPORTED(s, f) (!!((s)->features.supp & (u64)(f))) +#define LUO_FEATURE_IS_REQUIRED(s, f) (!!((s)->features.req & (u64)(f))) + /* * The LUO state is registered under this KHO entry name. */ #define LUO_KHO_ENTRY_NAME "LUO" -#define LUO_ABI_COMPATIBLE "luo-v5" -#define LUO_ABI_COMPAT_LEN ALIGN(sizeof(LUO_ABI_COMPATIBLE), 8) + +/* + * Bits associated with the luo_feature_hdr values. + */ +#define LUO_FEATURE_NUMBER BIT_ULL(0) +#define LUO_FEATURE_SESSIONS BIT_ULL(1) +#define LUO_FEATURE_FLBS BIT_ULL(2) + +#define LUO_CORE_FEATURES_SUPP (LUO_FEATURE_NUMBER | \ + LUO_FEATURE_SESSIONS | \ + LUO_FEATURE_FLBS) +#define LUO_CORE_FEATURES_REQ (LUO_FEATURE_NUMBER | \ + LUO_FEATURE_SESSIONS | \ + LUO_FEATURE_FLBS) +#define LUO_CORE_FEATURES_ACTIVE (LUO_FEATURE_NUMBER | \ + LUO_FEATURE_SESSIONS | \ + LUO_FEATURE_FLBS) /** * struct luo_ser - Centralized LUO ABI header. - * @compatible: Compatibility string identifying the LUO ABI version. + * @features: Bit mask of supported and active features. * @liveupdate_num: A counter tracking the number of successful live updates. * @sessions_pa: Physical address of the first session block header. * @flbs_pa: Physical address of the FLB header. @@ -78,7 +126,7 @@ * This structure is the root of all preserved LUO state. */ struct luo_ser { - char compatible[LUO_ABI_COMPAT_LEN]; + struct luo_feature_hdr features; u64 liveupdate_num; u64 sessions_pa; u64 flbs_pa; diff --git a/kernel/liveupdate/luo_core.c b/kernel/liveupdate/luo_core.c index 1b2bda22902d..6add1ecc463f 100644 --- a/kernel/liveupdate/luo_core.c +++ b/kernel/liveupdate/luo_core.c @@ -107,26 +107,37 @@ static int __init luo_early_startup(void) return 0; } - if (len < sizeof(*luo_ser)) { - pr_err("LUO state is too small (%zu < %zu)\n", len, sizeof(*luo_ser)); - return -EINVAL; + luo_ser = phys_to_virt(luo_ser_phys); + + if (len < sizeof(struct luo_feature_hdr)) { + pr_err("LUO state is too small (%zu < %zu)\n", + len, sizeof(struct luo_feature_hdr)); + err = -EINVAL; + goto out_free_ser; } - luo_ser = phys_to_virt(luo_ser_phys); - if (strncmp(luo_ser->compatible, LUO_ABI_COMPATIBLE, LUO_ABI_COMPAT_LEN)) { - pr_err("LUO state is incompatible with '%s'\n", LUO_ABI_COMPATIBLE); - return -EINVAL; + if (luo_ser->features.req & ~LUO_CORE_FEATURES_SUPP) { + pr_err("Unsupported required LUO feature (req: 0x%llx, supp: 0x%llx)\n", + luo_ser->features.req, (u64)LUO_CORE_FEATURES_SUPP); + err = -EOPNOTSUPP; + goto out_free_ser; } - luo_global.liveupdate_num = luo_ser->liveupdate_num; - pr_info("Retrieved live update data, liveupdate number: %lld\n", - luo_global.liveupdate_num); + if (LUO_FEATURE_IS_ACTIVE(luo_ser, LUO_FEATURE_NUMBER)) { + luo_global.liveupdate_num = luo_ser->liveupdate_num; + pr_info("Retrieved live update data, liveupdate number: %lld\n", + luo_global.liveupdate_num); + } - err = luo_session_setup_incoming(luo_ser->sessions_pa); - if (err) - goto out_free_ser; - luo_flb_setup_incoming(luo_ser->flbs_pa); + if (LUO_FEATURE_IS_ACTIVE(luo_ser, LUO_FEATURE_SESSIONS)) { + err = luo_session_setup_incoming(luo_ser->sessions_pa); + if (err) + goto out_free_ser; + } + + if (LUO_FEATURE_IS_ACTIVE(luo_ser, LUO_FEATURE_FLBS)) + luo_flb_setup_incoming(luo_ser->flbs_pa); err = 0; @@ -162,7 +173,10 @@ static int __init luo_state_setup(void) return PTR_ERR(luo_ser); } - strscpy(luo_ser->compatible, LUO_ABI_COMPATIBLE, sizeof(luo_ser->compatible)); + luo_ser->features.supp = LUO_CORE_FEATURES_SUPP; + luo_ser->features.req = LUO_CORE_FEATURES_REQ; + luo_ser->features.active = LUO_CORE_FEATURES_ACTIVE; + luo_ser->liveupdate_num = luo_global.liveupdate_num + 1; luo_session_setup_outgoing(&luo_ser->sessions_pa); -- 2.55.0.979.g7e5102b832-goog