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 B7FDCC43458 for ; Mon, 6 Jul 2026 13:45:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id: Content-Transfer-Encoding:MIME-Version:References:In-Reply-To:Message-ID:Date :Subject:To:From:Reply-To:Content-Type:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=CTv/nhHLsyGq+aERS2+OUW21SIZ9Y8DrLGEsnDOpDBk=; b=FtMxO+t0IIu0wh bZtswhpozFRN3l+e/W7eZTZO1EoRObq8AXHJzrDfJQuL7h9Vea4jqPfC1/V0jPJNlquztiwVdFFwI jiiFGFXDiCWMRiHVKEhNuU1glQvTjYWzWxnshTHrHxKEkUPVDu2uhQUQxxeUvxwUDqnlXv8sQvSGH BhAZYSs7t/Gl1CZCEP31uci5+6qp1bEy9VNZcUtCkl9wnkH/t5b35/Q5eKsVfI9sWMmlbyu/Yn/Mz fSgMH3ylR3WVPEgjumlekIJDSIxjdbwUnjIXYGfcZfhVgFgGuG/KoGWkPMkDuiK1ImfSUwyytM35r PkGtxp2fBPdfiHqw6trw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1wgjdd-0000000CeLA-3EhC; Mon, 06 Jul 2026 13:45:33 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1wgjda-0000000CeHd-3yBE for linux-arm-kernel@lists.infradead.org; Mon, 06 Jul 2026 13:45:32 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 2AFB232C5; Mon, 6 Jul 2026 06:45:25 -0700 (PDT) Received: from e142021.fritz.box (usa-sjc-mx-foss1.foss.arm.com [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id E95F33F7B4; Mon, 6 Jul 2026 06:45:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=arm.com; s=foss; t=1783345529; bh=vWg4gUtNkdbROhbG26cNwC/fCXQrOb4eQBXyHe9MzyA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=hLJkwtHzX3LE2sw0nr9bdd13FPDF/8F4iEw7n4O8M9NEqB/yjLIowGEL6/pS3usYx OColnNZfgckwy1c20qHjcVwIHyJey3Tqk0lkTdN/awcXhlqLugkvZewpE/mMKfKWsN Cy8IeAhZdK9genE2QEj9fxNz/5FqJD2iOWVUlEKE= From: Andre Przywara To: Mark Rutland , Lorenzo Pieralisi , Sudeep Holla Subject: [PATCH v3 8/8] firmware: smccc: lfa: add sysfs ABI documentation Date: Mon, 6 Jul 2026 15:44:48 +0200 Message-ID: <20260706134455.132091-9-andre.przywara@arm.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260706134455.132091-1-andre.przywara@arm.com> References: <20260706134455.132091-1-andre.przywara@arm.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.9.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260706_064531_065998_40360469 X-CRM114-Status: GOOD ( 22.26 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Conor Dooley , vsethi@nvidia.com, Salman Nabi , Rob Herring , linux-kernel@vger.kernel.org, Varun Wadekar , Trilok Soni , devicetree@vger.kernel.org, Nirmoy Das , Krzysztof Kozlowski , linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Document the sysfs attribute files as exported by the LFA driver. Signed-off-by: Andre Przywara --- Documentation/ABI/testing/sysfs-firmware-lfa | 106 +++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-firmware-lfa diff --git a/Documentation/ABI/testing/sysfs-firmware-lfa b/Documentation/ABI/testing/sysfs-firmware-lfa new file mode 100644 index 000000000000..afd349af9cf1 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-firmware-lfa @@ -0,0 +1,106 @@ +What: /sys/firmware/lfa +Date: May 2026 +Contact: Andre Przywara +Description: + The Arm Live Firmware Activation (LFA) spec describes an + interface between platform firmware (an agent) and any user + on the non-secure side (like the Linux kernel) to activate + pending firmware updates at runtime. The actual firmware + update would be provided independently (out-of-band, or + via any existing explicit firmware update mechanisms), then, + if supported, can be activated immediately, without rebooting + the system. + This directory contains one directory for each of the LFA + capable firmware images supported by the agent, identified by + its GUID. Within each directory, the same set of sysfs files + provides access to the properties and actions for this + particular firmware image. + +What: /sys/firmware/lfa//activate +Date: May 2026 +Contact: Andre Przywara +Description: + (WO) Write a boolean 'true' value to trigger the + activation of that firmware component. An update must be + pending for this to be successful. + +What: /sys/firmware/lfa//activation_capable +Date: May 2026 +Contact: Andre Przywara +Description: + (RO) A boolean value to show whether this firmware image is + capable of being activated. + +What: /sys/firmware/lfa//auto_activate +Date: May 2026 +Contact: Andre Przywara +Description: + (RW) Write a boolean 'true' value to allow a firmware image + to be automatically activated once a new firmware update + becomes available ("pending"). This depends on a working + notification scheme, for instance via an ACPI notification + or an interrupt to notify the kernel. + +What: /sys/firmware/lfa//cancel +Date: May 2026 +Contact: Andre Przywara +Description: + (WO) Write a boolean 'true' value to cancel a recently + triggered activation, if that has not finished yet. + +What: /sys/firmware/lfa//cpu_rendezvous +Date: May 2026 +Contact: Andre Przywara +Description: + (RO) A boolean value to show whether this image requires + a CPU rendezvous in firmware to be activated. If true, this + means all CPUs will enter the firmware during the activation + process, so will not be able to execute kernel code or + handle interrupts for a brief moment. + +What: /sys/firmware/lfa//current_version +Date: May 2026 +Contact: Andre Przywara +Description: + (RO) Shows the currently running version of that firmware + image, as reported by the agent (if supported). + +What: /sys/firmware/lfa//force_cpu_rendezvous +Date: May 2026 +Contact: Andre Przywara +Description: + (RW) Write a boolean 'true' value to force whether the kernel + will perform a CPU rendezvous during activation. This has no + effect if the firmware already *requires* a CPU rendezvous. + Firmware images might provide services to the kernel, at which + point is might be unsafe to continue running the kernel while + the activation is performed. Sending all CPUs into firmware + provides the safest option for the kernel. If you know for + certain that there are no services provides by that component + or the firmware component can handle requests during the + activation, you can write a 0 in here to avoid the brief + kernel downtime. + +What: /sys/firmware/lfa//may_reset_cpu +Date: May 2026 +Contact: Andre Przywara +Description: + (RO) A boolean value to show whether this firmware image + requires a CPU reset during the activation. + Currently this type of firmware image is not supported by + the kernel driver, as we cannot handle a CPU reset yet. + +What: /sys/firmware/lfa//name +Date: May 2026 +Contact: Andre Przywara +Description: + (RO) Shows a human readable name for that firmware image, if + known. Depends on the kernel driver knowing this particular + GUID, via a built-in list. + +What: /sys/firmware/lfa//pending_version +Date: May 2026 +Contact: Andre Przywara +Description: + (RO) Shows the version number of a pending firmware update + image, as reported by the agent (if supported). -- 2.43.0