From nobody Thu Oct 2 06:33:06 2025 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2C4D930FC06 for ; Mon, 22 Sep 2025 13:41:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.168.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758548473; cv=none; b=RfakwBcd39IyftxWXY5Q1yyOWkBP5k55Nk8qxps7zcFkKD1OsyvcJbemPxv6SqDBmIPKXf6zOke4KH05j5VXd2ZD3q/tSeqbxSrYDuKyqqDAcDAuWQNJ1hxjhoZLOMJ7wGjZwV8Agw2LEGqmc/As65lUhuEvGgOMNQon685hYJw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758548473; c=relaxed/simple; bh=KkC4QSxclwx5Tk4AVwolzQwcYruXvNFOfpqU998deKY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=ujUrCJS0Y6KUFVCeCivB5m4ixHDH8kMgQBGGCdfQpJO5lCb2z1nPFccLdOmXxSCZPrFKM3/2pCWKk4BWQK7JDBlL4HU87abM7wYBRoTAhuppm1klvtfJ2IKDf1FAwSqbLuqqMhMDdwxhMc+zs48qPBt/tGrJw2k5BMGancOEmPw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=lbq14I6w; arc=none smtp.client-ip=205.220.168.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="lbq14I6w" Received: from pps.filterd (m0279862.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 58M8KFFJ001358 for ; Mon, 22 Sep 2025 13:41:09 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= 4zriVHHzMQQ8ELUT932V4l8RDRcEXWAm2X8YnUX13NY=; b=lbq14I6wezBqTHbX C3tBbifWxovD4vQWscjBArY3cpwx8tjFzHQCeVfSnfmi04z1gwgzQmE5UoCuSI3q zP8OzWx8dAJjcMnPpQrM5pDpFKD68xu1/EGI/N6IYUGiyObySRVM++qJHZv/au/2 7eTn2PKlh1DxOI5Sjrg9ciHaDM5JnZqepahHsH4a+BctuJOjhZpDAOB8eJlmI5+F VEtTrDvcHV0uFVivcQejILSDBkH4l93C5aonapUB8rItarW320SvBHdTHGwfVeOY IGoHyb+/p1wAnMu/EChVBnaFxlolZ2EntobmHbm00ur5KSp9bXg7yY+Ql6fiKWIs Fkt/WQ== Received: from mail-pl1-f197.google.com (mail-pl1-f197.google.com [209.85.214.197]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 499n1fctx0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NOT) for ; Mon, 22 Sep 2025 13:41:09 +0000 (GMT) Received: by mail-pl1-f197.google.com with SMTP id d9443c01a7336-272b7bdf41fso20594955ad.0 for ; Mon, 22 Sep 2025 06:41:09 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758548468; x=1759153268; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=4zriVHHzMQQ8ELUT932V4l8RDRcEXWAm2X8YnUX13NY=; b=Vnx3MzU3CDThVsi1S819NCmL+dAfJupOWOdc33VR6BLc7Rkh0KDPb9oyZGcCQIVFLw Sw0Rd9eEdVu6/P0rHbWlzxh8Dsk3fFKEYhkMCuwxzqCPO3YIf60UvwQQVC3rHV2HR0XK gk5jmf3rIp8ieSihxt7RMGEF4B3NRA+SGzpHeKfSGP78uyNizGQukshnDwRr0bav86b8 MDjo+sDSoSyqGlHLsr7jQ3mgaWqbOHhGfXKbC0EU1JZfyKmb1qq20vM0aE8ZlWg/29s1 fli4EIddMDb/dZ/klUaWibrzKuPNcMpkugTU0jyl7Jfu/PVnSw1qr8XoRbidHAM+wvHH 4xhA== X-Forwarded-Encrypted: i=1; AJvYcCWXphWFWL9KqQ7MuRNxGqK09/DTICVXCHOX2OampXCzUI7adTCXZtFT20TQosPv26vTCuXbVEhZ23C6zPE=@vger.kernel.org X-Gm-Message-State: AOJu0YzLVJu5qxobT5iejQd19XUbud+RgYRmAGV9S2XPI76vHR5gsCBd iRmISD4SUrI+g2uqY9C+7oo4nBqjZV5asgRfxJRcE/NpJMXefKjOckvaTdQ7sBJt9SxdbGjDZJi 8FFyjMEIMvCcdJzs7etnUECHLDzCj0wllYtVya3EmFpUsngANOxeLwetPulwsH12idbY= X-Gm-Gg: ASbGncudm+FnlTZc6VcvP6JD3o23GG2a+3Vnv2S/8Jq4G6tQXya2v8IT1iaDj7sJzUK InqSwd0JM0X373sqNuGPFzVMnpgVCTcafb3B0jaIi6ew3Xt/LCISdarnabsqzeLYGQJ/IRULASe 7O1ZqIvFTp6W8zRbjxR2kBtT4XcU2gOdD2J6bOaatueVf0y9+5Jbi4+Hy1KVDg3biNLt483cduj FGXWMnzd07Rj8XdZBwJ5quM4zPBPGPslhPHSJ3orHII/MblyxyzfIPst0H6Xr8Wf8zlU/kTrn9y 73Lfin19LGf1AQwpjBcT9fo5TEeuvVH9gxYCctK+uj3Z6sFlHOfdSkvy1bXeGqGrSGx6Auhy+On Q X-Received: by 2002:a17:902:f645:b0:258:c13d:9b1a with SMTP id d9443c01a7336-269ba534dc8mr157813865ad.41.1758548468270; Mon, 22 Sep 2025 06:41:08 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHduNm914Aec/xKw82GcSDYLVCzvWXbdPEGvEZBtKD9TBFGvd/XuvNECs8ldINaTjU69ejDGg== X-Received: by 2002:a17:902:f645:b0:258:c13d:9b1a with SMTP id d9443c01a7336-269ba534dc8mr157813555ad.41.1758548467797; Mon, 22 Sep 2025 06:41:07 -0700 (PDT) Received: from hu-spratap-hyd.qualcomm.com ([202.46.22.19]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2698016c13asm134246755ad.46.2025.09.22.06.40.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Sep 2025 06:41:07 -0700 (PDT) From: Shivendra Pratap Date: Mon, 22 Sep 2025 19:10:14 +0530 Subject: [PATCH v15 04/14] Documentation: ABI: Add sysfs-class-reboot-mode-reboot_modes Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250922-arm-psci-system_reset2-vendor-reboots-v15-4-7ce3a08878f1@oss.qualcomm.com> References: <20250922-arm-psci-system_reset2-vendor-reboots-v15-0-7ce3a08878f1@oss.qualcomm.com> In-Reply-To: <20250922-arm-psci-system_reset2-vendor-reboots-v15-0-7ce3a08878f1@oss.qualcomm.com> To: Bartosz Golaszewski , Bjorn Andersson , Sebastian Reichel , Rob Herring , Sudeep Holla , Souvik Chakravarty , Krzysztof Kozlowski , Conor Dooley , Andy Yan , Mark Rutland , Lorenzo Pieralisi , Arnd Bergmann , Konrad Dybcio , cros-qcom-dts-watchers@chromium.org, Vinod Koul , Catalin Marinas , Will Deacon , Florian Fainelli , Moritz Fischer , John Stultz , Matthias Brugger , Krzysztof Kozlowski Cc: Dmitry Baryshkov , Mukesh Ojha , Stephen Boyd , Andre Draszik , Kathiravan Thirumoorthy , linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, Elliot Berman , Shivendra Pratap , Srinivas Kandagatla , Sebastian Reichel X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1758548419; l=2381; i=shivendra.pratap@oss.qualcomm.com; s=20250710; h=from:subject:message-id; bh=KkC4QSxclwx5Tk4AVwolzQwcYruXvNFOfpqU998deKY=; b=uN/mNSJciqwPL2c846Ag2zmHUDTAwr0+DmX3GeKjBJun6SviBcqN2hIimRUdXBy5VUvYhksA1 lXOvd8ZvtgZApCFxM4p+PgWnnQaGrV1OVcuhR4WyI0oc7VoQWD4VOt4 X-Developer-Key: i=shivendra.pratap@oss.qualcomm.com; a=ed25519; pk=CpsuL7yZ8NReDPhGgq6Xn/SRoa59mAvzWOW0QZoo4gw= X-Proofpoint-ORIG-GUID: Ko_koeYE6MBW4KMAbbJR0AeY9zx0swNT X-Proofpoint-GUID: Ko_koeYE6MBW4KMAbbJR0AeY9zx0swNT X-Authority-Analysis: v=2.4 cv=No/Rc9dJ c=1 sm=1 tr=0 ts=68d151f5 cx=c_pps a=cmESyDAEBpBGqyK7t0alAg==:117 a=fChuTYTh2wq5r3m49p7fHw==:17 a=IkcTkHD0fZMA:10 a=yJojWOMRYYMA:10 a=QX4gbG5DAAAA:8 a=EUspDBNiAAAA:8 a=VwQbUJbxAAAA:8 a=5CgfHzhl2afHKY-Ush4A:9 a=QEXdDO2ut3YA:10 a=1OuFwYUASf3TG4hYMiVC:22 a=AbAUZ8qAyYyZVLSsDulk:22 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwOTIwMDAzNyBTYWx0ZWRfX5SFHi2Zk/BRd yplKbbKqH5aCWOXb7zWF1/ym3BjfldM2jXGm+ypPFPldmzfp1DqXUOu5pMSpZkyGN7q5swmSicr ykxn2M3HEeKaMGXrUosui9OXywBDa2FJpdXbN774TfmzTRbK/CtoTkzdujLzx0YV0xn9L/6c4KC 3+XE+vL7NYd5axYUNJFtc4ikAwK1CLi2CI0EEL9cS1xomYhNUF+dIukp1NG+3/IHNYfx0ZblpUV vPl73o0g2G5IHEsgMT1RWehHoz5W/f2prFMs2OUTFsGhJMqMpzZIhaz+93mbVZhIZEg0UyTvp8H YjE2YGwcgvl+KGVDtsUqTadtrZYpOQN6gIAaa37fRwviesUbxq3spFKYOoQ20MFLXto+w0jz1uS NaLQUDaz X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1117,Hydra:6.1.9,FMLib:17.12.80.40 definitions=2025-09-22_01,2025-09-22_01,2025-03-28_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 clxscore=1015 spamscore=0 suspectscore=0 adultscore=0 malwarescore=0 phishscore=0 bulkscore=0 priorityscore=1501 impostorscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.19.0-2507300000 definitions=main-2509200037 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. Reviewed-by: Sebastian Reichel Signed-off-by: Shivendra Pratap --- .../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..6a3fc379afae3a6caf56ad0b73b= 1c06c43a9fee7 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-reboot-mode-reboot_modes @@ -0,0 +1,39 @@ +What: /sys/class/reboot-mode//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- 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. --=20 2.34.1