From: kernel test robot <lkp@intel.com>
To: Aditya Srivastava <yashsri421@gmail.com>
Cc: kbuild-all@lists.01.org, linux-doc@vger.kernel.org,
Jonathan Corbet <corbet@lwn.net>
Subject: [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
Date: Fri, 16 Apr 2021 11:36:19 +0800 [thread overview]
Message-ID: <202104161115.4apqp35L-lkp@intel.com> (raw)
[-- 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 --]
reply other threads:[~2021-04-16 3:37 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=202104161115.4apqp35L-lkp@intel.com \
--to=lkp@intel.com \
--cc=corbet@lwn.net \
--cc=kbuild-all@lists.01.org \
--cc=linux-doc@vger.kernel.org \
--cc=yashsri421@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).