[kbuild-all] [cifs:for-next 1/1] fs/smbfs/connect.c:1093: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Hi Steve, First bad commit (maybe != root cause): tree: git://git.samba.org/sfrench/cifs-2.6.git for-next head: bba805a46c91e7a8a1d04704e5409f890acf8b66 commit: bba805a46c91e7a8a1d04704e5409f890acf8b66 [1/1] cifs: rename fs/cifs directory to fs/smbfs config: sh-allmodconfig (attached as .config) compiler: sh4-linux-gcc (GCC) 11.2.0 reproduce (this is a W=1 build): wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross chmod +x ~/bin/make.cross git remote add cifs git://git.samba.org/sfrench/cifs-2.6.git git fetch --no-tags cifs for-next git checkout bba805a46c91e7a8a1d04704e5409f890acf8b66 # save the attached .config to linux build tree COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-11.2.0 make.cross ARCH=sh If you fix the issue, kindly add following tag as appropriate Reported-by: kernel test robot <lkp(a)intel.com&gt; All warnings (new ones prefixed by >>): * Returns true if srcaddr isn't specified and rhs isn't specified, or fs/smbfs/connect.c:1558: warning: Function parameter or member 'ses' not described in 'cifs_setup_ipc' fs/smbfs/connect.c:1558: warning: Function parameter or member 'ctx' not described in 'cifs_setup_ipc' fs/smbfs/connect.c:1618: warning: Function parameter or member 'ses' not described in 'cifs_free_ipc' fs/smbfs/connect.c:1864: warning: Function parameter or member 'server' not described in 'cifs_get_smb_ses' fs/smbfs/connect.c:1864: warning: Function parameter or member 'ctx' not described in 'cifs_get_smb_ses' fs/smbfs/connect.c:2087: warning: Function parameter or member 'ses' not described in 'cifs_get_tcon' fs/smbfs/connect.c:2087: warning: Function parameter or member 'ctx' not described in 'cifs_get_tcon' fs/smbfs/connect.c:3046: warning: Function parameter or member 'xid' not described in 'expand_dfs_referral' fs/smbfs/connect.c:3046: warning: Function parameter or member 'ses' not described in 'expand_dfs_referral' fs/smbfs/connect.c:3046: warning: Function parameter or member 'ctx' not described in 'expand_dfs_referral' fs/smbfs/connect.c:3046: warning: Function parameter or member 'cifs_sb' not described in 'expand_dfs_referral' fs/smbfs/connect.c:3046: warning: Function parameter or member 'ref_path' not described in 'expand_dfs_referral' vim +1093 fs/smbfs/connect.c ^1da177e4c3f41 fs/cifs/connect.c Linus Torvalds 2005-04-16 1091 bc04499477d9f0 fs/cifs/connect.c Steve French 2020-12-11 1092 /** bc04499477d9f0 fs/cifs/connect.c Steve French 2020-12-11 @1093 * Returns true if srcaddr isn't specified and rhs isn't specified, or bc04499477d9f0 fs/cifs/connect.c Steve French 2020-12-11 1094 * if srcaddr is specified and matches the IP address of the rhs argument 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1095 */ e4af35fa55b072 fs/cifs/connect.c Paulo Alcantara 2020-05-19 1096 bool e4af35fa55b072 fs/cifs/connect.c Paulo Alcantara 2020-05-19 1097 cifs_match_ipaddr(struct sockaddr *srcaddr, struct sockaddr *rhs) 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1098 { 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1099 switch (srcaddr->sa_family) { 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1100 case AF_UNSPEC: 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1101 return (rhs->sa_family == AF_UNSPEC); 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1102 case AF_INET: { 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1103 struct sockaddr_in *saddr4 = (struct sockaddr_in *)srcaddr; 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1104 struct sockaddr_in *vaddr4 = (struct sockaddr_in *)rhs; 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1105 return (saddr4->sin_addr.s_addr == vaddr4->sin_addr.s_addr); 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1106 } 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1107 case AF_INET6: { 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1108 struct sockaddr_in6 *saddr6 = (struct sockaddr_in6 *)srcaddr; e3e2775cedc9d6 fs/cifs/connect.c Nickolai Zeldovich 2013-01-16 1109 struct sockaddr_in6 *vaddr6 = (struct sockaddr_in6 *)rhs; 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1110 return ipv6_addr_equal(&saddr6->sin6_addr, &vaddr6->sin6_addr); 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1111 } 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1112 default: 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1113 WARN_ON(1); 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1114 return false; /* don't expect to be here */ 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1115 } 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1116 } 3eb9a8893a76cf fs/cifs/connect.c Ben Greear 2010-09-01 1117 :::::: The code at line 1093 was first introduced by commit :::::: bc04499477d9f01034c2afb6097e835c705ac3bd cifs: minor kernel style fixes for comments :::::: TO: Steve French <stfrench(a)microsoft.com&gt; :::::: CC: Steve French <stfrench(a)microsoft.com&gt; --- 0-DAY CI Kernel Test Service, Intel Corporation https://lists.01.org/hyperkitty/list/kbuild-all@lists.01.org