linux-kernel - drivers/irqchip/irq-mbigen.c:29: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202109031755.7w6A5xrS-lkp@intel.com>
Date:   Fri, 3 Sep 2021 17:25:12 +0800
From:   kernel test robot <lkp@...el.com>
To:     Aditya Srivastava <yashsri421@...il.com>
Cc:     llvm@...ts.linux.dev, kbuild-all@...ts.01.org,
        linux-kernel@...r.kernel.org, Jonathan Corbet <corbet@....net>,
        linux-doc@...r.kernel.org
Subject: drivers/irqchip/irq-mbigen.c:29: warning: This comment starts with
 '/**', but isn't a kernel-doc comment. Refer
 Documentation/doc-guide/kernel-doc.rst

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   a9c9a6f741cdaa2fa9ba24a790db8d07295761e3
commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7 scripts: kernel-doc: improve parsing for kernel-doc comments syntax
date:   5 months ago
config: arm64-buildonly-randconfig-r004-20210903 (attached as .config)
compiler: clang version 14.0.0 (https://github.com/llvm/llvm-project c9948e9254fbb6ea00f66c7b4542311d21e060be)
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
        # install arm64 cross compiling tool for clang build
        # apt-get install binutils-aarch64-linux-gnu
        # https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross ARCH=arm64 

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@...el.com>

All warnings (new ones prefixed by >>):

>> drivers/irqchip/irq-mbigen.c:29: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * In mbigen vector register
   drivers/irqchip/irq-mbigen.c:43: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * offset of clear register in mbigen node
   drivers/irqchip/irq-mbigen.c:50: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * offset of interrupt type register


vim +29 drivers/irqchip/irq-mbigen.c

9650c60ebfec05 Ma Jun 2015-12-17  27  
9650c60ebfec05 Ma Jun 2015-12-17  28  /**
9650c60ebfec05 Ma Jun 2015-12-17 @29   * In mbigen vector register
9650c60ebfec05 Ma Jun 2015-12-17  30   * bit[21:12]:	event id value
9650c60ebfec05 Ma Jun 2015-12-17  31   * bit[11:0]:	device id
9650c60ebfec05 Ma Jun 2015-12-17  32   */
9650c60ebfec05 Ma Jun 2015-12-17  33  #define IRQ_EVENT_ID_SHIFT		12
9650c60ebfec05 Ma Jun 2015-12-17  34  #define IRQ_EVENT_ID_MASK		0x3ff
9650c60ebfec05 Ma Jun 2015-12-17  35  

:::::: The code at line 29 was first introduced by commit
:::::: 9650c60ebfec05fcf74d9b3eb97837501f2bb541 irqchip/mbigen: Create irq domain for each mbigen device

:::::: TO: Ma Jun <majun258@...wei.com>
:::::: CC: Marc Zyngier <marc.zyngier@....com>

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

Download attachment ".config.gz" of type "application/gzip" (39694 bytes)