scripts/kernel-doc: fs/smb/server/auth.c:221: warning: Function parameter or struct member 'conn' not described in 'ksmbd_auth_ntlmv2'

From: kernel test robot
Date: Fri Dec 15 2023 - 16:33:35 EST


Hi Steve,

First bad commit (maybe != root cause):

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 3f7168591ebf7bbdb91797d02b1afaf00a4289b1
commit: 38c8a9a52082579090e34c033d439ed2cd1a462d smb: move client and server files to common directory fs/smb
date: 7 months ago
config: sh-allyesconfig (https://download.01.org/0day-ci/archive/20231216/202312160506.eMlIWFK0-lkp@xxxxxxxxx/config)
compiler: sh4-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231216/202312160506.eMlIWFK0-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202312160506.eMlIWFK0-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> scripts/kernel-doc: fs/smb/server/auth.c:221: warning: Function parameter or struct member 'conn' not described in 'ksmbd_auth_ntlmv2'
>> scripts/kernel-doc: fs/smb/server/auth.c:221: warning: Function parameter or struct member 'cryptkey' not described in 'ksmbd_auth_ntlmv2'
>> scripts/kernel-doc: fs/smb/server/auth.c:305: warning: Function parameter or struct member 'blob_len' not described in 'ksmbd_decode_ntlmssp_auth_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:305: warning: Function parameter or struct member 'conn' not described in 'ksmbd_decode_ntlmssp_auth_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:305: warning: Excess function parameter 'usr' description in 'ksmbd_decode_ntlmssp_auth_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:382: warning: Function parameter or struct member 'blob_len' not described in 'ksmbd_decode_ntlmssp_neg_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:382: warning: Function parameter or struct member 'conn' not described in 'ksmbd_decode_ntlmssp_neg_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:382: warning: Excess function parameter 'rsp' description in 'ksmbd_decode_ntlmssp_neg_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:382: warning: Excess function parameter 'sess' description in 'ksmbd_decode_ntlmssp_neg_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:410: warning: Function parameter or struct member 'conn' not described in 'ksmbd_build_ntlmssp_challenge_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:410: warning: Excess function parameter 'rsp' description in 'ksmbd_build_ntlmssp_challenge_blob'
>> scripts/kernel-doc: fs/smb/server/auth.c:410: warning: Excess function parameter 'sess' description in 'ksmbd_build_ntlmssp_challenge_blob'
--
>> scripts/kernel-doc: fs/smb/server/vfs.c:54: warning: Function parameter or struct member 'parent' not described in 'ksmbd_vfs_lock_parent'
>> scripts/kernel-doc: fs/smb/server/vfs.c:54: warning: Function parameter or struct member 'child' not described in 'ksmbd_vfs_lock_parent'
>> scripts/kernel-doc: fs/smb/server/vfs.c:356: warning: Function parameter or struct member 'fp' not described in 'ksmbd_vfs_read'
>> scripts/kernel-doc: fs/smb/server/vfs.c:356: warning: Excess function parameter 'fid' description in 'ksmbd_vfs_read'
>> scripts/kernel-doc: fs/smb/server/vfs.c:472: warning: Function parameter or struct member 'fp' not described in 'ksmbd_vfs_write'
>> scripts/kernel-doc: fs/smb/server/vfs.c:472: warning: Excess function parameter 'fid' description in 'ksmbd_vfs_write'
>> scripts/kernel-doc: fs/smb/server/vfs.c:535: warning: Function parameter or struct member 'path' not described in 'ksmbd_vfs_getattr'
>> scripts/kernel-doc: fs/smb/server/vfs.c:535: warning: Function parameter or struct member 'stat' not described in 'ksmbd_vfs_getattr'
>> scripts/kernel-doc: fs/smb/server/vfs.c:535: warning: Excess function parameter 'work' description in 'ksmbd_vfs_getattr'
>> scripts/kernel-doc: fs/smb/server/vfs.c:535: warning: Excess function parameter 'fid' description in 'ksmbd_vfs_getattr'
>> scripts/kernel-doc: fs/smb/server/vfs.c:535: warning: Excess function parameter 'attrs' description in 'ksmbd_vfs_getattr'
>> scripts/kernel-doc: fs/smb/server/vfs.c:552: warning: Function parameter or struct member 'p_id' not described in 'ksmbd_vfs_fsync'
>> scripts/kernel-doc: fs/smb/server/vfs.c:575: warning: Function parameter or struct member 'work' not described in 'ksmbd_vfs_remove_file'
>> scripts/kernel-doc: fs/smb/server/vfs.c:575: warning: Function parameter or struct member 'path' not described in 'ksmbd_vfs_remove_file'
>> scripts/kernel-doc: fs/smb/server/vfs.c:575: warning: Excess function parameter 'name' description in 'ksmbd_vfs_remove_file'
>> scripts/kernel-doc: fs/smb/server/vfs.c:613: warning: Function parameter or struct member 'work' not described in 'ksmbd_vfs_link'
>> scripts/kernel-doc: fs/smb/server/vfs.c:779: warning: Function parameter or struct member 'fp' not described in 'ksmbd_vfs_truncate'
>> scripts/kernel-doc: fs/smb/server/vfs.c:779: warning: Excess function parameter 'fid' description in 'ksmbd_vfs_truncate'
>> scripts/kernel-doc: fs/smb/server/vfs.c:820: warning: Excess function parameter 'size' description in 'ksmbd_vfs_listxattr'
>> scripts/kernel-doc: fs/smb/server/vfs.c:917: warning: Function parameter or struct member 'option' not described in 'ksmbd_vfs_set_fadvise'
scripts/kernel-doc: fs/smb/server/vfs.c:917: warning: Excess function parameter 'options' description in 'ksmbd_vfs_set_fadvise'
scripts/kernel-doc: fs/smb/server/vfs.c:1117: warning: Function parameter or struct member 'um' not described in 'ksmbd_vfs_lookup_in_dir'
scripts/kernel-doc: fs/smb/server/vfs.c:1152: warning: Function parameter or struct member 'work' not described in 'ksmbd_vfs_kern_path_locked'
--
>> scripts/kernel-doc: fs/smb/server/misc.c:269: warning: Function parameter or struct member 'um' not described in 'ksmbd_extract_sharename'
--
>> scripts/kernel-doc: fs/smb/server/transport_tcp.c:373: warning: Function parameter or struct member 'max_retries' not described in 'ksmbd_tcp_read'
>> scripts/kernel-doc: fs/smb/server/transport_tcp.c:422: warning: Function parameter or struct member 'iface' not described in 'create_socket'

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki