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

From: kernel test robot
Date: Mon Dec 25 2023 - 21:06:01 EST


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@xxxxxxxxx/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@xxxxxxxxx/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@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202312261019.ZvgAHhpI-lkp@xxxxxxxxx/

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