[PATCH v3 04/12] reboot: describe do_kernel_restart's cmd argument in kernel-doc
From: Ahmad Fatoum
Date: Mon Feb 17 2025 - 15:41:27 EST
A W=1 build rightfully complains about the function's kernel-doc
being incomplete.
Describe its single parameter to fix this.
Reviewed-by: Tzung-Bi Shih <tzungbi@xxxxxxxxxx>
Signed-off-by: Ahmad Fatoum <a.fatoum@xxxxxxxxxxxxxx>
---
kernel/reboot.c | 3 +++
1 file changed, 3 insertions(+)
diff --git a/kernel/reboot.c b/kernel/reboot.c
index f348f1ba9e22675ac1183149ba19f39be12edacd..6185cfe5d4ee910daf057884a7ff8dcf1e80df28 100644
--- a/kernel/reboot.c
+++ b/kernel/reboot.c
@@ -229,6 +229,9 @@ EXPORT_SYMBOL(unregister_restart_handler);
/**
* do_kernel_restart - Execute kernel restart handler call chain
*
+ * @cmd: pointer to buffer containing command to execute for restart
+ * or %NULL
+ *
* Calls functions registered with register_restart_handler.
*
* Expected to be called from machine_restart as last step of the restart
--
2.39.5