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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2837BC7EE2A for ; Thu, 26 Jun 2025 00:30:01 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 420D96B00C4; Wed, 25 Jun 2025 20:30:01 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3A88F6B00C5; Wed, 25 Jun 2025 20:30:01 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 297E46B00C6; Wed, 25 Jun 2025 20:30:01 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 1521E6B00C4 for ; Wed, 25 Jun 2025 20:30:01 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 2F0381A080B for ; Thu, 26 Jun 2025 00:30:00 +0000 (UTC) X-FDA: 83595669360.28.8C48CA4 Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) by imf21.hostedemail.com (Postfix) with ESMTP id 4DA681C0003 for ; Thu, 26 Jun 2025 00:29:58 +0000 (UTC) Authentication-Results: imf21.hostedemail.com; dkim=pass header.d=infradead.org header.s=desiato.20200630 header.b=A2gLGXhk; spf=none (imf21.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.92.199) smtp.mailfrom=rdunlap@infradead.org; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1750897798; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=asEZ63uNdqnRmgnYrhTIGz393/XojMchHHXovIsLp68=; b=taQpTFt5Vl+uRrpdgrVDBOTDNOv19z+w7ektq8DseXi/Uj/bXvayfSH4rZ64iUL3gLZ08z yOi9hqoiwcP4FDwTu41m8QsxRiDui7iBqjvmGty4esBs5ugYZUoVk3QkwPVqoJd2jslWQm ZTSRlyd8AusDb7y39jCHcDAv5YmirRg= ARC-Authentication-Results: i=1; imf21.hostedemail.com; dkim=pass header.d=infradead.org header.s=desiato.20200630 header.b=A2gLGXhk; spf=none (imf21.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.92.199) smtp.mailfrom=rdunlap@infradead.org; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1750897798; a=rsa-sha256; cv=none; b=pWiZnk4ABVrhv25VBS2ly7gMyVR+TtKNQV0A3802VJ8O2PUyz9wzsAzMa34bldsKtk4k0+ awXP8B65+Mc4sm6CthGdsnb93z1OXeuzOyz7kHQ1xZdr0uXZXyQI8HBXLerOtnfbBaUt/D Gvul6wbPMiQY8zNZFNjCLAw6Ca4p9zU= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=desiato.20200630; h=Content-Transfer-Encoding:Content-Type :In-Reply-To:From:References:To:Subject:MIME-Version:Date:Message-ID:Sender: Reply-To:Cc:Content-ID:Content-Description; bh=asEZ63uNdqnRmgnYrhTIGz393/XojMchHHXovIsLp68=; b=A2gLGXhkiJRwKraD1mBY5wWyCL GeOZiJPwZvqcEt0qCRpRQMvepDgFVG03f30rNTBwO+RF3qi2U3CFi6jByUPjAzwg5zYnxkPOaNgq7 Osgw+RaQ71nqD9xutiRw9bBJUMzc3rPK4eRSEcC5MGy+0ppopQyaD1/NFX7S793wLpu7yUn7YrH6B aclVA3UqCsQ/Q/kaxvG6A7zwrf+X+c/dC/db1atMMDdQJnLN7GbfgY0ViwOpvvrpgwiPPWNo0Y21M YiSenSJp3vlkoDOoWzkCoZgPtjIIowycD8O23zl9ISm5G13ORwdKhhrfgniolA/D+Tr8ztFXarVLO HcgDD7kA==; Received: from [50.53.25.54] (helo=[192.168.254.17]) by desiato.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1uUaUZ-000000060m1-18Zj; Thu, 26 Jun 2025 00:29:27 +0000 Message-ID: Date: Wed, 25 Jun 2025 17:29:15 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v1 17/32] liveupdate: luo_sysfs: add sysfs state monitoring To: Pasha Tatashin , pratyush@kernel.org, jasonmiu@google.com, graf@amazon.com, changyuanl@google.com, rppt@kernel.org, dmatlack@google.com, rientjes@google.com, corbet@lwn.net, ilpo.jarvinen@linux.intel.com, kanie@linux.alibaba.com, ojeda@kernel.org, aliceryhl@google.com, masahiroy@kernel.org, akpm@linux-foundation.org, tj@kernel.org, yoann.congal@smile.fr, mmaurer@google.com, roman.gushchin@linux.dev, chenridong@huawei.com, axboe@kernel.dk, mark.rutland@arm.com, jannh@google.com, vincent.guittot@linaro.org, hannes@cmpxchg.org, dan.j.williams@intel.com, david@redhat.com, joel.granados@kernel.org, rostedt@goodmis.org, anna.schumaker@oracle.com, song@kernel.org, zhangguopeng@kylinos.cn, linux@weissschuh.net, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-mm@kvack.org, gregkh@linuxfoundation.org, tglx@linutronix.de, mingo@redhat.com, bp@alien8.de, dave.hansen@linux.intel.com, x86@kernel.org, hpa@zytor.com, rafael@kernel.org, dakr@kernel.org, bartosz.golaszewski@linaro.org, cw00.choi@samsung.com, myungjoo.ham@samsung.com, yesanishhere@gmail.com, Jonathan.Cameron@huawei.com, quic_zijuhu@quicinc.com, aleksander.lobakin@intel.com, ira.weiny@intel.com, andriy.shevchenko@linux.intel.com, leon@kernel.org, lukas@wunner.de, bhelgaas@google.com, wagi@kernel.org, djeffery@redhat.com, stuart.w.hayes@gmail.com, ptyadav@amazon.de, lennart@poettering.net, brauner@kernel.org, linux-api@vger.kernel.org, linux-fsdevel@vger.kernel.org References: <20250625231838.1897085-1-pasha.tatashin@soleen.com> <20250625231838.1897085-18-pasha.tatashin@soleen.com> Content-Language: en-US From: Randy Dunlap In-Reply-To: <20250625231838.1897085-18-pasha.tatashin@soleen.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspamd-Server: rspam11 X-Rspam-User: X-Rspamd-Queue-Id: 4DA681C0003 X-Stat-Signature: gw6qejp14trsbc8udhierqh6dcamqkx4 X-HE-Tag: 1750897798-300139 X-HE-Meta: U2FsdGVkX1/44JS9Abos/d10NN/1b9BdUj8JW7AMNK4rATgTypDl/KPsHV8bLVOa3+8kFZZHsgU/5/Wfl6dHd+8j9L78achLOPhg/T1LL9ktXIvBsFzW6uTlUghe1JjdjkReaOrDBnlh1Mdn/LLGRLHvV6Dm1+tziz5YYh1rKxqEu+4kdbb9SL2kdwi1wi3rZ67Ml6M0p7eNunRulL+mN7ZnqaxfAe3aBqS6IukYMwTYoK2KqQc+Sq+XfhAScDK4Lx/lkAzcQTD2Dofhymffftc9cYUMoU5v5T0bW1whUTbYglLPjokhp5OiSZu3CspeeQdaMETv+IbMtAWuj1KAIf0bDFAfOHBMb3WQjz01f2KKiozHai04FnWmIEBEpanqUMHRdvZMjAIG2f8GoVQNtUoT6GHy5bmwljAuBLuYj2hlyY0f9osADJ+cX1nBYCpGsDS34wrcJ7wIrbHhqkTpxdmJqJLoYrxtoZdeSKNK36W7puepBjg+wyjfFo2753/0GQRW96bO3II1zMPBvhvh21+wHFXdxmr2Z+4Q+b0pQoUPGiThogY1Kmd3BPlahN63Hl1ZYmn7FPCeXQjuxnWwmwoXh/hFU8099rVKK0u2rW+yDurHoJ2wUnmiURDM5vGJw6GEX6i2Uy5qOWbXfZIJE2C8tBxoWuxONzVc7LFRVfSa/EYR8PrJyVCqWi32JJP/INMIDk/kMTm63fE7/R2fX/nsb9OfCTta86bD8wtxUaWly1jCjSuL62ZZO1Or9KlV8pA4m/DWVnJCAbhxcJABEV6SyUWy8NPEyifURFgIk4mj59gtDsEk7xBY765tOpmin1dR5EbsPgJhfP0atn/PkBJBXoAEts5sT4DsP/eo6LkpRPv4LJrptxWxxpir4dqmvj28CXW0v9yla9qGpaHKjcJh4OMfrQkCe+0Cl7S9/fdzzofkHWpzWlkCh7kVH7Pe262i9kFg4ReuRAr8EI6 MJAQ8SQU BqdpUbQWTzfsuXgJl6opvIEFBUzu2IUC98D0RdH2HtW/Smr/4LYBIThSlARU1CmJzD1sRjQnEO3x4wDYfXrnsTapKQ0tNCMwqj9FECSCtg8Tj4DrxrLCDYc56jKAwJ41fsdleMDqWkSigVSb7lnpJRYvXCDCmUHbHAO5qRfGhG5zonJaIA+/OHHccGMnPcH6A+nTD5MdoeTvdvzQHEd7Tpr6PsI+fd4bJqC0UOiPbx1jkGRMmN0iADhzY/Byf5o9EsoXI+wc7T9DU3NIiOzlXxyhZAGNVyQGUGnz2Sw/1tLl52ZmcL8SR8Fq9IG8I1RtLr/qK0494iZepqAztjOaFcfHfthRS+FaMK/JBLJlmJwdixfWZzH0RwnwL0+FUz9d/9ocu7qyLNIt8yfseBYhjYRSiftjuosLhC9N8M6h/9CxpEtp+gP0KJN2Xm0oucJFk6s79 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Hi, On 6/25/25 4:18 PM, Pasha Tatashin wrote: > diff --git a/Documentation/ABI/testing/sysfs-kernel-liveupdate b/Documentation/ABI/testing/sysfs-kernel-liveupdate > new file mode 100644 > index 000000000000..4cd4a4fe2f93 > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-kernel-liveupdate > @@ -0,0 +1,51 @@ > +What: /sys/kernel/liveupdate/ > +Date: May 2025 > +KernelVersion: 6.16.0 > +Contact: pasha.tatashin@soleen.com > +Description: Directory containing interfaces to query the live > + update orchestrator. Live update is the ability to reboot the > + host kernel (e.g., via kexec, without a full power cycle) while > + keeping specifically designated devices operational ("alive") > + across the transition. After the new kernel boots, these devices > + can be re-attached to their original workloads (e.g., virtual > + machines) with their state preserved. This is particularly > + useful, for example, for quick hypervisor updates without > + terminating running virtual machines. > + > + > +What: /sys/kernel/liveupdate/state > +Date: May 2025 > +KernelVersion: 6.16.0 > +Contact: pasha.tatashin@soleen.com > +Description: Read-only file that displays the current state of the live > + update orchestrator as a string. Possible values are: > + > + "normal": No live update operation is in progress. This is > + the default operational state. Just an opinion, but the ':'s after each possible value aren't needed and just add noise. You could just drop the ':'s -- or you could make a table here, like Documentation/ABI/testing/sysfs-hypervisor-xen does, by adding =========== ================================================ > + "prepared": The live update preparation phase has completed > + successfully (e.g., triggered via the > + /dev/liveupdate event). Kernel subsystems have > + been notified via the %LIVEUPDATE_PREPARE > + event/callback and should have initiated state > + saving. User workloads (e.g., VMs) are generally > + still running, but some operations (like device > + unbinding or new DMA mappings) might be > + restricted. The system is ready for the reboot > + trigger. > + > + "frozen": The final reboot notification has been sent > + (e.g., triggered via the 'reboot()' syscall), > + corresponding to the %LIVEUPDATE_REBOOT kernel > + event. Subsystems have had their final chance to > + save state. User workloads must be suspended. > + The system is about to execute the reboot into > + the new kernel (imminent kexec). This state > + corresponds to the "blackout window". > + > + "updated": The system has successfully rebooted into the > + new kernel via live update. Restoration of > + preserved resources can now occur (typically via > + ioctl commands). The system is awaiting the > + final 'finish' signal after user space completes > + restoration tasks. and =========== ================================================ Or just disagree or ignore. :) -- ~Randy