[kbuild-all] [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

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(a)intel.com&gt; All warnings (new ones prefixed by >>): drivers/scsi/aacraid/commsup.c:334: warning: expecting prototype for fib_deallocate(). Prototype was for fib_dealloc() instead * aac_handle_sa_aif Handle a message from the firmware -- * i40e_create_tx_ctx Build the Tx context descriptor -- * iavf_create_tx_ctx Build the Tx context descriptor -- * 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 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(a)microsemi.com&gt; :::::: CC: Martin K. Petersen <martin.petersen(a)oracle.com&gt; --- 0-DAY CI Kernel Test Service, Intel Corporation https://lists.01.org/hyperkitty/list/kbuild-all@lists.01.org