linux-kernel - [PATCH] rtl8723bs: Add kernel-doc comment for rtw_reset_continual_io_error in rtw

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <tencent_BAB546E9C29DF17A0E3BCE8EAE1428D88206@qq.com>
Date: Sun, 14 Dec 2025 14:16:59 +0800
From: cjz <guagua210311@...com>
To: linux-staging@...r.kernel.org
Cc: gregkh@...uxfoundation.org,
	linux-wireless@...r.kernel.org,
	linux-kernel@...r.kernel.org,
	changjunzheng <guagua210311@...com>
Subject: [PATCH] rtl8723bs: Add kernel-doc comment for rtw_reset_continual_io_error in rtw_io.c

From: changjunzheng <guagua210311@...com>

rtw_reset_continual_io_error lacks a standard kernel-doc comment and has an incorrect
parameter name (dvobjprive vs dvobj) in the existing comment, which causes gcc W=1
warning and reduces code readability.

This change replaces the non-standard comment with a complete English kernel-doc comment,
fixes the parameter name error, and keeps all functional logic unchanged.

Signed-off-by: changjunzheng <guagua210311@...com>
---
 drivers/staging/rtl8723bs/core/rtw_io.c | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/drivers/staging/rtl8723bs/core/rtw_io.c b/drivers/staging/rtl8723bs/core/rtw_io.c
index fe9f94001eed..358a16b25a20 100644
--- a/drivers/staging/rtl8723bs/core/rtw_io.c
+++ b/drivers/staging/rtl8723bs/core/rtw_io.c
@@ -147,7 +147,15 @@ int rtw_inc_and_chk_continual_io_error(struct dvobj_priv *dvobj)
 	return false;
 }
 
-/* Set the continual_io_error of this @param dvobjprive to 0 */
+/**
+ * rtw_reset_continual_io_error - Reset the continual IO error counter to zero
+ * @dvobj: Pointer to the device object private data structure
+ *
+ * Atomically set the 'continual_io_error' atomic counter in the dvobj private data
+ * structure to zero, resetting the state of consecutive IO error counting for the device.
+ *
+ * Return: None
+ */
 void rtw_reset_continual_io_error(struct dvobj_priv *dvobj)
 {
 	atomic_set(&dvobj->continual_io_error, 0);
-- 
2.43.0