[ammarfaizi2-block:google/android/kernel/common/android13-5.15 2562/2575] arch/arm64/kvm/iommu/s2mpu.c:129: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

From: kernel test robot <lkp@intel.com>
To: David Brazdil <dbrazdil@google.com>
Cc: kbuild-all@lists.01.org, GNU/Weeb Mailing List <gwml@gnuweeb.org>,
	linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org
Subject: [ammarfaizi2-block:google/android/kernel/common/android13-5.15 2562/2575] arch/arm64/kvm/iommu/s2mpu.c:129: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
Date: Tue, 11 Jan 2022 09:17:45 +0800	[thread overview]
Message-ID: <202201110931.duyXOD4g-lkp@intel.com> (raw)

tree:   https://github.com/ammarfaizi2/linux-block google/android/kernel/common/android13-5.15
head:   d52e3e4473075ddf199c9ae763e747302d729468
commit: 4a75e1b060286edbc814df36ab6b314826d2dc5e [2562/2575] ANDROID: KVM: arm64: Implement IRQ handler for S2MPU faults
config: arm64-allyesconfig (https://download.01.org/0day-ci/archive/20220111/202201110931.duyXOD4g-lkp@intel.com/config)
compiler: aarch64-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
        # https://github.com/ammarfaizi2/linux-block/commit/4a75e1b060286edbc814df36ab6b314826d2dc5e
        git remote add ammarfaizi2-block https://github.com/ammarfaizi2/linux-block
        git fetch --no-tags ammarfaizi2-block google/android/kernel/common/android13-5.15
        git checkout 4a75e1b060286edbc814df36ab6b314826d2dc5e
        # save the config file to linux build tree
        mkdir build_dir
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-11.2.0 make.cross O=build_dir ARCH=arm64 SHELL=/bin/bash arch/arm64/kvm/iommu/

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

>> arch/arm64/kvm/iommu/s2mpu.c:129: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Parse interrupt information from DT and if found, register IRQ handler.

vim +129 arch/arm64/kvm/iommu/s2mpu.c

   127	
   128	/**
 > 129	 * Parse interrupt information from DT and if found, register IRQ handler.
   130	 * This is considered optional and will not fail even if the initialization is
   131	 * unsuccessful. In that case the IRQ will remain masked.
   132	 */
   133	static void s2mpu_probe_irq(struct platform_device *pdev, void __iomem *kaddr)
   134	{
   135		struct s2mpu_irq_info *irq_info;
   136		int ret, irq;
   137	
   138		irq = platform_get_irq_optional(pdev, 0);
   139	
   140		if (irq == -ENXIO)
   141			return; /* No IRQ specified. */
   142	
   143		if (irq < 0) {
   144			/* IRQ specified but failed to parse. */
   145			dev_err(&pdev->dev, "failed to parse IRQ, IRQ not enabled");
   146			return;
   147		}
   148	
   149		irq_info = devm_kmalloc(&pdev->dev, sizeof(*irq_info), GFP_KERNEL);
   150		if (!irq_info)
   151			return;
   152	
   153		*irq_info = (struct s2mpu_irq_info){
   154			.dev = &pdev->dev,
   155			.va = kaddr,
   156		};
   157	
   158		ret = devm_request_irq(&pdev->dev, irq, s2mpu_irq_handler, 0,
   159				       dev_name(&pdev->dev), irq_info);
   160		if (ret) {
   161			dev_err(&pdev->dev, "failed to register IRQ, IRQ not enabled");
   162			return;
   163		}
   164	}
   165	

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