kernel/irq/irqdomain.c:985: warning: Function parameter or member 'd' not described in 'irq_domain_translate_twocell'

[kernel test robot <lkp@intel.com>]

Hi Brian,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   fbafc3e621c3f4ded43720fdb1d6ce1728ec664e
commit: b5c231d8c8037f63d34199ea1667bbe1cd9f940f genirq: introduce irq_domain_translate_twocell
date:   4 years, 10 months ago
config: x86_64-alldefconfig (https://download.01.org/0day-ci/archive/20231226/202312261019.ZvgAHhpI-lkp@intel.com/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231226/202312261019.ZvgAHhpI-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/202312261019.ZvgAHhpI-lkp@intel.com/

All warnings (new ones prefixed by >>):

   kernel/irq/irqdomain.c:66: warning: expecting prototype for irq_domain_alloc_fwnode(). Prototype was for __irq_domain_alloc_fwnode() instead
   kernel/irq/irqdomain.c:104: warning: Function parameter or member 'fwnode' not described in 'irq_domain_free_fwnode'
   kernel/irq/irqdomain.c:914: warning: Function parameter or member 'd' not described in 'irq_domain_xlate_onecell'
   kernel/irq/irqdomain.c:914: warning: Function parameter or member 'ctrlr' not described in 'irq_domain_xlate_onecell'
   kernel/irq/irqdomain.c:914: warning: Function parameter or member 'intspec' not described in 'irq_domain_xlate_onecell'
   kernel/irq/irqdomain.c:914: warning: Function parameter or member 'intsize' not described in 'irq_domain_xlate_onecell'
   kernel/irq/irqdomain.c:914: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_xlate_onecell'
   kernel/irq/irqdomain.c:914: warning: Function parameter or member 'out_type' not described in 'irq_domain_xlate_onecell'
   kernel/irq/irqdomain.c:933: warning: Function parameter or member 'd' not described in 'irq_domain_xlate_twocell'
   kernel/irq/irqdomain.c:933: warning: Function parameter or member 'ctrlr' not described in 'irq_domain_xlate_twocell'
   kernel/irq/irqdomain.c:933: warning: Function parameter or member 'intspec' not described in 'irq_domain_xlate_twocell'
   kernel/irq/irqdomain.c:933: warning: Function parameter or member 'intsize' not described in 'irq_domain_xlate_twocell'
   kernel/irq/irqdomain.c:933: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_xlate_twocell'
   kernel/irq/irqdomain.c:933: warning: Function parameter or member 'out_type' not described in 'irq_domain_xlate_twocell'
   kernel/irq/irqdomain.c:956: warning: Function parameter or member 'd' not described in 'irq_domain_xlate_onetwocell'
   kernel/irq/irqdomain.c:956: warning: Function parameter or member 'ctrlr' not described in 'irq_domain_xlate_onetwocell'
   kernel/irq/irqdomain.c:956: warning: Function parameter or member 'intspec' not described in 'irq_domain_xlate_onetwocell'
   kernel/irq/irqdomain.c:956: warning: Function parameter or member 'intsize' not described in 'irq_domain_xlate_onetwocell'
   kernel/irq/irqdomain.c:956: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_xlate_onetwocell'
   kernel/irq/irqdomain.c:956: warning: Function parameter or member 'out_type' not described in 'irq_domain_xlate_onetwocell'
>> kernel/irq/irqdomain.c:985: warning: Function parameter or member 'd' not described in 'irq_domain_translate_twocell'
>> kernel/irq/irqdomain.c:985: warning: Function parameter or member 'fwspec' not described in 'irq_domain_translate_twocell'
>> kernel/irq/irqdomain.c:985: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_translate_twocell'
>> kernel/irq/irqdomain.c:985: warning: Function parameter or member 'out_type' not described in 'irq_domain_translate_twocell'
   kernel/irq/irqdomain.c:1564: warning: Function parameter or member 'domain' not described in 'irq_domain_alloc_irqs_parent'
   kernel/irq/irqdomain.c:1583: warning: Function parameter or member 'domain' not described in 'irq_domain_free_irqs_parent'


vim +985 kernel/irq/irqdomain.c

   972	
   973	/**
   974	 * irq_domain_translate_twocell() - Generic translate for direct two cell
   975	 * bindings
   976	 *
   977	 * Device Tree IRQ specifier translation function which works with two cell
   978	 * bindings where the cell values map directly to the hwirq number
   979	 * and linux irq flags.
   980	 */
   981	int irq_domain_translate_twocell(struct irq_domain *d,
   982					 struct irq_fwspec *fwspec,
   983					 unsigned long *out_hwirq,
   984					 unsigned int *out_type)
 > 985	{
   986		if (WARN_ON(fwspec->param_count < 2))
   987			return -EINVAL;
   988		*out_hwirq = fwspec->param[0];
   989		*out_type = fwspec->param[1] & IRQ_TYPE_SENSE_MASK;
   990		return 0;
   991	}
   992	EXPORT_SYMBOL_GPL(irq_domain_translate_twocell);
   993	

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