[lwn:docs-next 127/127] drivers/scsi/aacraid/commsup.c:1953: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[lwn:docs-next 127/127] drivers/scsi/aacraid/commsup.c:1953: 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: 7402 bytes --]

tree:   git://git.lwn.net/linux-2.6 docs-next
head:   f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7 [127/127] scripts: kernel-doc: improve parsing for kernel-doc comments syntax
config: mips-randconfig-r024-20210415 (attached as .config)
compiler: mips-linux-gcc (GCC) 9.3.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 lwn git://git.lwn.net/linux-2.6
        git fetch --no-tags lwn docs-next
        git checkout f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-9.3.0 make.cross W=1 ARCH=mips 

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 >>):

   drivers/scsi/aacraid/commsup.c:334: warning: expecting prototype for fib_deallocate(). Prototype was for fib_dealloc() instead
>> drivers/scsi/aacraid/commsup.c:1953: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    *      aac_handle_sa_aif       Handle a message from the firmware
--
>> drivers/net/ethernet/intel/i40e/i40e_txrx.c:3348: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * i40e_create_tx_ctx Build the Tx context descriptor
--
>> drivers/net/ethernet/intel/iavf/iavf_txrx.c:2101: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * iavf_create_tx_ctx Build the Tx context descriptor
--
>> drivers/net/ethernet/intel/igb/igb_main.c:2040: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Detect and switch function for Media Auto Sense
   drivers/net/ethernet/intel/igb/igb_main.c:4036: warning: expecting prototype for igb_open(). Prototype was for __igb_open() instead
   drivers/net/ethernet/intel/igb/igb_main.c:4153: warning: expecting prototype for igb_close(). Prototype was for __igb_close() instead
--
   drivers/hid/intel-ish-hid/ishtp/hbm.c:409: warning: expecting prototype for ishtp_client_disconnect_request(). Prototype was for ishtp_hbm_fw_disconnect_req() instead
>> drivers/hid/intel-ish-hid/ishtp/hbm.c:441: warning: expecting prototype for ishtp_hbm_dma_xfer_ack(()(). Prototype was for ishtp_hbm_dma_xfer_ack() instead


vim +1953 drivers/scsi/aacraid/commsup.c

26c54d0ec25c18 Balsundar P              2019-10-15  1951  
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1952  /**
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02 @1953   *	aac_handle_sa_aif	Handle a message from the firmware
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1954   *	@dev: Which adapter this fib is from
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1955   *	@fibptr: Pointer to fibptr from adapter
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1956   *
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1957   *	This routine handles a driver notify fib from the adapter and
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1958   *	dispatches it to the appropriate routine for handling.
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1959   */
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1960  static void aac_handle_sa_aif(struct aac_dev *dev, struct fib *fibptr)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1961  {
f2d2cabadba00f Raghava Aditya Renukunta 2017-12-26  1962  	int i;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1963  	u32 events = 0;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1964  
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1965  	if (fibptr->hbacmd_size & SA_AIF_HOTPLUG)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1966  		events = SA_AIF_HOTPLUG;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1967  	else if (fibptr->hbacmd_size & SA_AIF_HARDWARE)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1968  		events = SA_AIF_HARDWARE;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1969  	else if (fibptr->hbacmd_size & SA_AIF_PDEV_CHANGE)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1970  		events = SA_AIF_PDEV_CHANGE;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1971  	else if (fibptr->hbacmd_size & SA_AIF_LDEV_CHANGE)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1972  		events = SA_AIF_LDEV_CHANGE;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1973  	else if (fibptr->hbacmd_size & SA_AIF_BPSTAT_CHANGE)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1974  		events = SA_AIF_BPSTAT_CHANGE;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1975  	else if (fibptr->hbacmd_size & SA_AIF_BPCFG_CHANGE)
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1976  		events = SA_AIF_BPCFG_CHANGE;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1977  
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1978  	switch (events) {
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1979  	case SA_AIF_HOTPLUG:
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1980  	case SA_AIF_HARDWARE:
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1981  	case SA_AIF_PDEV_CHANGE:
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1982  	case SA_AIF_LDEV_CHANGE:
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1983  	case SA_AIF_BPCFG_CHANGE:
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1984  
75be67cd155d95 Raghava Aditya Renukunta 2017-12-26  1985  		aac_scan_host(dev);
8ebaa67fc23a09 Raghava Aditya Renukunta 2017-12-26  1986  
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1987  		break;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1988  
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1989  	case SA_AIF_BPSTAT_CHANGE:
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1990  		/* currently do nothing */
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1991  		break;
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1992  	}
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1993  
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1994  	for (i = 1; i <= 10; ++i) {
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1995  		events = src_readl(dev, MUnit.IDR);
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1996  		if (events & (1<<23)) {
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1997  			pr_warn(" AIF not cleared by firmware - %d/%d)\n",
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1998  				i, 10);
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  1999  			ssleep(1);
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  2000  		}
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  2001  	}
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  2002  }
6223a39fe6fbbe Raghava Aditya Renukunta 2017-02-02  2003  

:::::: The code at line 1953 was first introduced by commit
:::::: 6223a39fe6fbbeef0877a56dc427a6351f22ef6c scsi: aacraid: Added support for hotplug

:::::: TO: Raghava Aditya Renukunta <RaghavaAditya.Renukunta@microsemi.com>
:::::: CC: Martin K. Petersen <martin.petersen@oracle.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: 32597 bytes --]