[openeuler:OLK-6.6 3542/3542] drivers/irqchip/irq-mbigen.c:127: warning: Function parameter or member 'vtimer_mbigen_chip' not described in 'mbigen_device'

[openeuler:OLK-6.6 3542/3542] drivers/irqchip/irq-mbigen.c:127: warning: Function parameter or member 'vtimer_mbigen_chip' not described in 'mbigen_device'

[kernel test robot]

tree:   https://gitee.com/openeuler/kernel.git OLK-6.6
head:   04473ee9ed912a16fff0d8846ad565bbf3d63c77
commit: 3ce0ad7d0b4cb6538fe25fb20ca838c06e3cc516 [3542/3542] mbigen: vtimer mbigen driver support
config: arm64-randconfig-001-20251215 (https://download.01.org/0day-ci/archive/20251222/202512221648.01it8GuK-lkp@intel.com/config)
compiler: clang version 22.0.0git (https://github.com/llvm/llvm-project 1335a05ab8bc8339ce24be3a9da89d8c3f4e0571)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20251222/202512221648.01it8GuK-lkp@intel.com/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202512221648.01it8GuK-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/irqchip/irq-mbigen.c:77: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * MBIX config register
>> drivers/irqchip/irq-mbigen.c:127: warning: Function parameter or member 'vtimer_mbigen_chip' not described in 'mbigen_device'
>> drivers/irqchip/irq-mbigen.c:136: warning: expecting prototype for Due to the existence of hyper(). Prototype was for GICR_LENGTH() instead

Kconfig warnings: (for reference only)
   WARNING: unmet direct dependencies detected for RESCTRL_FS
   Depends on [n]: MISC_FILESYSTEMS [=n] && ARCH_HAS_CPU_RESCTRL [=y]
   Selected by [y]:
   - ARM64_MPAM [=y]


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

3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  114  
717c3dbc118ecbb Ma Jun       2015-12-17  115  /**
717c3dbc118ecbb Ma Jun       2015-12-17  116   * struct mbigen_device - holds the information of mbigen device.
717c3dbc118ecbb Ma Jun       2015-12-17  117   *
717c3dbc118ecbb Ma Jun       2015-12-17  118   * @pdev:		pointer to the platform device structure of mbigen chip.
717c3dbc118ecbb Ma Jun       2015-12-17  119   * @base:		mapped address of this mbigen chip.
717c3dbc118ecbb Ma Jun       2015-12-17  120   */
717c3dbc118ecbb Ma Jun       2015-12-17  121  struct mbigen_device {
717c3dbc118ecbb Ma Jun       2015-12-17  122  	struct platform_device	*pdev;
717c3dbc118ecbb Ma Jun       2015-12-17  123  	void __iomem		*base;
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  124  #ifdef CONFIG_VIRT_VTIMER_IRQ_BYPASS
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  125  	struct vtimer_mbigen_device	*vtimer_mbigen_chip;
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  126  #endif
717c3dbc118ecbb Ma Jun       2015-12-17 @127  };
717c3dbc118ecbb Ma Jun       2015-12-17  128  
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  129  #ifdef CONFIG_VIRT_VTIMER_IRQ_BYPASS
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  130  static LIST_HEAD(vtimer_mgn_list);
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  131  
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  132  /**
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  133   * Due to the existence of hyper-threading technology, We need to get the
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  134   * absolute offset of a cpu relative to the base cpu.
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  135   */
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11 @136  #define GICR_LENGTH                            0x40000
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  137  static inline int get_abs_offset(int cpu, int cpu_base)
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  138  {
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  139  	return ((get_gicr_paddr(cpu) - get_gicr_paddr(cpu_base)) / GICR_LENGTH);
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  140  }
3ce0ad7d0b4cb65 Kunkun Jiang 2024-01-11  141  

:::::: The code at line 127 was first introduced by commit
:::::: 717c3dbc118ecbbd5dab06c7e02dac68d3f62e1d irqchip/mgigen: Add platform device driver for mbigen device

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

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki