linux-kernel - Re: [PATCH] ksmbd: vfs: fix all kernel-doc warnings

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-prev] [day] [month] [year] [list]

Message-ID: <CAKYAXd8Am1EuaNiycenCy11KcuOBcd5j9g-5FQicMusOWiL6yQ@mail.gmail.com>
Date: Sat, 16 Dec 2023 13:27:54 +0900
From: Namjae Jeon <linkinjeon@...nel.org>
To: Randy Dunlap <rdunlap@...radead.org>
Cc: linux-kernel@...r.kernel.org, Steve French <sfrench@...ba.org>, 
	Sergey Senozhatsky <senozhatsky@...omium.org>, Tom Talpey <tom@...pey.com>, linux-cifs@...r.kernel.org
Subject: Re: [PATCH] ksmbd: vfs: fix all kernel-doc warnings

2023-12-16 12:28 GMT+09:00, Randy Dunlap <rdunlap@...radead.org>:
> Fix all kernel-doc warnings in vfs.c:
>
> vfs.c:54: warning: Function parameter or member 'parent' not described in
> 'ksmbd_vfs_lock_parent'
> vfs.c:54: warning: Function parameter or member 'child' not described in
> 'ksmbd_vfs_lock_parent'
> vfs.c:54: warning: No description found for return value of
> 'ksmbd_vfs_lock_parent'
> vfs.c:372: warning: Function parameter or member 'fp' not described in
> 'ksmbd_vfs_read'
> vfs.c:372: warning: Excess function parameter 'fid' description in
> 'ksmbd_vfs_read'
> vfs.c:489: warning: Function parameter or member 'fp' not described in
> 'ksmbd_vfs_write'
> vfs.c:489: warning: Excess function parameter 'fid' description in
> 'ksmbd_vfs_write'
> vfs.c:555: warning: Function parameter or member 'path' not described in
> 'ksmbd_vfs_getattr'
> vfs.c:555: warning: Function parameter or member 'stat' not described in
> 'ksmbd_vfs_getattr'
> vfs.c:555: warning: Excess function parameter 'work' description in
> 'ksmbd_vfs_getattr'
> vfs.c:555: warning: Excess function parameter 'fid' description in
> 'ksmbd_vfs_getattr'
> vfs.c:555: warning: Excess function parameter 'attrs' description in
> 'ksmbd_vfs_getattr'
> vfs.c:572: warning: Function parameter or member 'p_id' not described in
> 'ksmbd_vfs_fsync'
> vfs.c:595: warning: Function parameter or member 'work' not described in
> 'ksmbd_vfs_remove_file'
> vfs.c:595: warning: Function parameter or member 'path' not described in
> 'ksmbd_vfs_remove_file'
> vfs.c:595: warning: Excess function parameter 'name' description in
> 'ksmbd_vfs_remove_file'
> vfs.c:633: warning: Function parameter or member 'work' not described in
> 'ksmbd_vfs_link'
> vfs.c:805: warning: Function parameter or member 'fp' not described in
> 'ksmbd_vfs_truncate'
> vfs.c:805: warning: Excess function parameter 'fid' description in
> 'ksmbd_vfs_truncate'
> vfs.c:846: warning: Excess function parameter 'size' description in
> 'ksmbd_vfs_listxattr'
> vfs.c:953: warning: Function parameter or member 'option' not described in
> 'ksmbd_vfs_set_fadvise'
> vfs.c:953: warning: Excess function parameter 'options' description in
> 'ksmbd_vfs_set_fadvise'
> vfs.c:1167: warning: Function parameter or member 'um' not described in
> 'ksmbd_vfs_lookup_in_dir'
> vfs.c:1203: warning: Function parameter or member 'work' not described in
> 'ksmbd_vfs_kern_path_locked'
> vfs.c:1641: warning: No description found for return value of
> 'ksmbd_vfs_init_kstat'
>
> Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
> Cc: Namjae Jeon <linkinjeon@...nel.org>
> Cc: Steve French <sfrench@...ba.org>
> Cc: Sergey Senozhatsky <senozhatsky@...omium.org>
> Cc: Tom Talpey <tom@...pey.com>
> Cc: linux-cifs@...r.kernel.org
Acked-by: Namjae Jeon <linkinjeon@...nel.org>
Applied it to #ksmbd-for-next-next.
Thanks for your patch!