[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

[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

[kernel test robot]

[-- Attachment #1: Type: text/plain, Size: 5598 bytes --]

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@intel.com>

All warnings (new ones prefixed by >>):

>> fs/smbfs/connect.c:1093: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * 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@microsoft.com>
:::::: CC: Steve French <stfrench@microsoft.com>

---
0-DAY CI Kernel Test Service, Intel Corporation
https://lists.01.org/hyperkitty/list/kbuild-all@lists.01.org

[-- Attachment #2: .config.gz --]
[-- Type: application/gzip, Size: 55509 bytes --]