]> git.ipfire.org Git - thirdparty/kernel/stable.git/commitdiff
ksmbd: fix kernel-doc warnings from ksmbd_conn_get/put()
authorNamjae Jeon <linkinjeon@kernel.org>
Thu, 30 Apr 2026 23:34:55 +0000 (08:34 +0900)
committerSteve French <stfrench@microsoft.com>
Sat, 2 May 2026 02:49:35 +0000 (21:49 -0500)
The kernel test robot reported W=1 build warnings for ksmbd_conn_get()
and ksmbd_conn_put() due to missing parameter descriptions.
Add the @conn description to fix these warnings.

Reported-by: kernel test robot <lkp@intel.com>
Signed-off-by: Namjae Jeon <linkinjeon@kernel.org>
Signed-off-by: Steve French <stfrench@microsoft.com>
fs/smb/server/connection.c

index 95654a8081628607eec0c6897f539ff456bd9f87..8347495dbc62842ffb3cb7a148b7316406bca71a 100644 (file)
@@ -122,6 +122,8 @@ static void __ksmbd_conn_release_work(struct work_struct *work)
 /**
  * ksmbd_conn_get() - take a reference on @conn and return it.
  *
+ * @conn: connection instance to get a reference to
+ *
  * Returns @conn unchanged so callers can write
  * "fp->conn = ksmbd_conn_get(work->conn);" in one expression.  Returns NULL
  * if @conn is NULL.
@@ -139,6 +141,8 @@ struct ksmbd_conn *ksmbd_conn_get(struct ksmbd_conn *conn)
  * ksmbd_conn_put() - drop a reference and, if it was the last, queue the
  * release onto ksmbd_conn_wq so it runs from process context.
  *
+ * @conn: connection instance to put a reference to
+ *
  * Callable from any context including RCU softirq callbacks and non-sleeping
  * locks; the actual release is deferred to the workqueue.  ksmbd_conn_wq is
  * created in ksmbd_server_init() before any conn can be allocated and is