Hi,
On Fri, Aug 15, 2025 at 08:05:09PM +0530, Shivendra Pratap wrote:
> Add ABI documentation for /sys/class/reboot-mode/*/reboot_modes,
> a read-only sysfs attribute exposing the list of supported
> reboot-mode arguments. This file is created by reboot-mode
> framework and provides a user-readable interface to query
> available reboot-mode arguments.
>
> Signed-off-by: Shivendra Pratap <shivendra.pratap@oss.qualcomm.com>
> ---
Reviewed-by: Sebastian Reichel <sebastian.reichel@collabora.com>
-- Sebastian
> .../testing/sysfs-class-reboot-mode-reboot_modes | 39 ++++++++++++++++++++++
> 1 file changed, 39 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-class-reboot-mode-reboot_modes b/Documentation/ABI/testing/sysfs-class-reboot-mode-reboot_modes
> new file mode 100644
> index 0000000000000000000000000000000000000000..6a3fc379afae3a6caf56ad0b73b1c06c43a9fee7
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-class-reboot-mode-reboot_modes
> @@ -0,0 +1,39 @@
> +What: /sys/class/reboot-mode/<driver>/reboot_modes
> +Date: August 2025
> +KernelVersion: 6.17.0-rc1
> +Contact: linux-pm@vger.kernel.org
> + Description:
> + This interface exposes the reboot-mode arguments
> + registered with the reboot-mode framework. It is
> + a read-only interface and provides a space
> + separated list of reboot-mode arguments supported
> + on the current platform.
> + Example:
> + recovery fastboot bootloader
> +
> + The exact sysfs path may vary depending on the
> + name of the driver that registers the arguments.
> + Example:
> + /sys/class/reboot-mode/nvmem-reboot-mode/reboot_modes
> + /sys/class/reboot-mode/syscon-reboot-mode/reboot_modes
> + /sys/class/reboot-mode/qcom-pon/reboot_modes
> +
> + The supported arguments can be used by userspace
> + to invoke device reset using the reboot() system
> + call, with the "argument" as string to "*arg"
> + parameter along with LINUX_REBOOT_CMD_RESTART2.
> + Example:
> + reboot(LINUX_REBOOT_MAGIC1, LINUX_REBOOT_MAGIC2,
> + LINUX_REBOOT_CMD_RESTART2, "bootloader");
> +
> + A driver can expose the supported arguments by
> + registering them with the reboot-mode framework
> + using the property names that follow the
> + mode-<argument> format.
> + Example:
> + mode-bootloader, mode-recovery.
> +
> + This attribute is useful for scripts or initramfs
> + logic that need to programmatically determine
> + which reboot-mode arguments are valid before
> + triggering a reboot.
>
> --
> 2.34.1
>
>