Received-SPF: pass (google.com: domain of linux-kernel+bounces-2062-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1;
Precedence: bulk
MIME-Version: 1.0
In-Reply-To: <20231216032814.10560-1-rdunlap@infradead.org>
References: <20231216032814.10560-1-rdunlap@infradead.org>
From: Namjae Jeon <linkinjeon@kernel.org>
Date: Sat, 16 Dec 2023 13:27:54 +0900
Message-ID: <CAKYAXd8Am1EuaNiycenCy11KcuOBcd5j9g-5FQicMusOWiL6yQ@mail.gmail.com>
Subject: Re: [PATCH] ksmbd: vfs: fix all kernel-doc warnings
To: Randy Dunlap <rdunlap@infradead.org>
Cc: linux-kernel@vger.kernel.org, Steve French <sfrench@samba.org>, 
	Sergey Senozhatsky <senozhatsky@chromium.org>, Tom Talpey <tom@talpey.com>, linux-cifs@vger.kernel.org
Content-Type: text/plain; charset="UTF-8"

2023-12-16 12:28 GMT+09:00, Randy Dunlap <rdunlap@infradead.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@infradead.org>
> Cc: Namjae Jeon <linkinjeon@kernel.org>
> Cc: Steve French <sfrench@samba.org>
> Cc: Sergey Senozhatsky <senozhatsky@chromium.org>
> Cc: Tom Talpey <tom@talpey.com>
> Cc: linux-cifs@vger.kernel.org
Acked-by: Namjae Jeon <linkinjeon@kernel.org>
Applied it to #ksmbd-for-next-next.
Thanks for your patch!