kernel/irq/irqdomain.c:997: warning: Function parameter or member 'd' not described in 'irq_domain_translate_onecell'
From: kernel test robot
Date: Wed Sep 27 2023 - 15:45:35 EST
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 633b47cb009d09dc8f4ba9cdb3a0ca138809c7c7
commit: b01ecceaf2c0c4b3f2d24aa0adcf096ab1648253 genirq: Introduce irq_domain_translate_onecell
date: 3 years, 8 months ago
config: csky-allnoconfig (https://download.01.org/0day-ci/archive/20230928/202309280333.zqeI0H4x-lkp@xxxxxxxxx/config)
compiler: csky-linux-gcc (GCC) 12.3.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20230928/202309280333.zqeI0H4x-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/202309280333.zqeI0H4x-lkp@xxxxxxxxx/
All warnings (new ones prefixed by >>):
kernel/irq/irqdomain.c:105: warning: Function parameter or member 'fwnode' not described in 'irq_domain_free_fwnode'
kernel/irq/irqdomain.c:930: warning: Function parameter or member 'd' not described in 'irq_domain_xlate_onecell'
kernel/irq/irqdomain.c:930: warning: Function parameter or member 'ctrlr' not described in 'irq_domain_xlate_onecell'
kernel/irq/irqdomain.c:930: warning: Function parameter or member 'intspec' not described in 'irq_domain_xlate_onecell'
kernel/irq/irqdomain.c:930: warning: Function parameter or member 'intsize' not described in 'irq_domain_xlate_onecell'
kernel/irq/irqdomain.c:930: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_xlate_onecell'
kernel/irq/irqdomain.c:930: warning: Function parameter or member 'out_type' not described in 'irq_domain_xlate_onecell'
kernel/irq/irqdomain.c:949: warning: Function parameter or member 'd' not described in 'irq_domain_xlate_twocell'
kernel/irq/irqdomain.c:949: warning: Function parameter or member 'ctrlr' not described in 'irq_domain_xlate_twocell'
kernel/irq/irqdomain.c:949: warning: Function parameter or member 'intspec' not described in 'irq_domain_xlate_twocell'
kernel/irq/irqdomain.c:949: warning: Function parameter or member 'intsize' not described in 'irq_domain_xlate_twocell'
kernel/irq/irqdomain.c:949: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_xlate_twocell'
kernel/irq/irqdomain.c:949: warning: Function parameter or member 'out_type' not described in 'irq_domain_xlate_twocell'
kernel/irq/irqdomain.c:972: warning: Function parameter or member 'd' not described in 'irq_domain_xlate_onetwocell'
kernel/irq/irqdomain.c:972: warning: Function parameter or member 'ctrlr' not described in 'irq_domain_xlate_onetwocell'
kernel/irq/irqdomain.c:972: warning: Function parameter or member 'intspec' not described in 'irq_domain_xlate_onetwocell'
kernel/irq/irqdomain.c:972: warning: Function parameter or member 'intsize' not described in 'irq_domain_xlate_onetwocell'
kernel/irq/irqdomain.c:972: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_xlate_onetwocell'
kernel/irq/irqdomain.c:972: warning: Function parameter or member 'out_type' not described in 'irq_domain_xlate_onetwocell'
>> kernel/irq/irqdomain.c:997: warning: Function parameter or member 'd' not described in 'irq_domain_translate_onecell'
>> kernel/irq/irqdomain.c:997: warning: Function parameter or member 'fwspec' not described in 'irq_domain_translate_onecell'
>> kernel/irq/irqdomain.c:997: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_translate_onecell'
>> kernel/irq/irqdomain.c:997: warning: Function parameter or member 'out_type' not described in 'irq_domain_translate_onecell'
kernel/irq/irqdomain.c:1018: warning: Function parameter or member 'd' not described in 'irq_domain_translate_twocell'
kernel/irq/irqdomain.c:1018: warning: Function parameter or member 'fwspec' not described in 'irq_domain_translate_twocell'
kernel/irq/irqdomain.c:1018: warning: Function parameter or member 'out_hwirq' not described in 'irq_domain_translate_twocell'
kernel/irq/irqdomain.c:1018: warning: Function parameter or member 'out_type' not described in 'irq_domain_translate_twocell'
kernel/irq/irqdomain.c:1597: warning: Function parameter or member 'domain' not described in 'irq_domain_alloc_irqs_parent'
kernel/irq/irqdomain.c:1616: warning: Function parameter or member 'domain' not described in 'irq_domain_free_irqs_parent'
vim +997 kernel/irq/irqdomain.c
938
939 /**
940 * irq_domain_xlate_twocell() - Generic xlate for direct two cell bindings
941 *
942 * Device Tree IRQ specifier translation function which works with two cell
943 * bindings where the cell values map directly to the hwirq number
944 * and linux irq flags.
945 */
946 int irq_domain_xlate_twocell(struct irq_domain *d, struct device_node *ctrlr,
947 const u32 *intspec, unsigned int intsize,
948 irq_hw_number_t *out_hwirq, unsigned int *out_type)
> 949 {
950 struct irq_fwspec fwspec;
951
952 of_phandle_args_to_fwspec(ctrlr, intspec, intsize, &fwspec);
953 return irq_domain_translate_twocell(d, &fwspec, out_hwirq, out_type);
954 }
955 EXPORT_SYMBOL_GPL(irq_domain_xlate_twocell);
956
957 /**
958 * irq_domain_xlate_onetwocell() - Generic xlate for one or two cell bindings
959 *
960 * Device Tree IRQ specifier translation function which works with either one
961 * or two cell bindings where the cell values map directly to the hwirq number
962 * and linux irq flags.
963 *
964 * Note: don't use this function unless your interrupt controller explicitly
965 * supports both one and two cell bindings. For the majority of controllers
966 * the _onecell() or _twocell() variants above should be used.
967 */
968 int irq_domain_xlate_onetwocell(struct irq_domain *d,
969 struct device_node *ctrlr,
970 const u32 *intspec, unsigned int intsize,
971 unsigned long *out_hwirq, unsigned int *out_type)
> 972 {
973 if (WARN_ON(intsize < 1))
974 return -EINVAL;
975 *out_hwirq = intspec[0];
976 if (intsize > 1)
977 *out_type = intspec[1] & IRQ_TYPE_SENSE_MASK;
978 else
979 *out_type = IRQ_TYPE_NONE;
980 return 0;
981 }
982 EXPORT_SYMBOL_GPL(irq_domain_xlate_onetwocell);
983
984 const struct irq_domain_ops irq_domain_simple_ops = {
985 .xlate = irq_domain_xlate_onetwocell,
986 };
987 EXPORT_SYMBOL_GPL(irq_domain_simple_ops);
988
989 /**
990 * irq_domain_translate_onecell() - Generic translate for direct one cell
991 * bindings
992 */
993 int irq_domain_translate_onecell(struct irq_domain *d,
994 struct irq_fwspec *fwspec,
995 unsigned long *out_hwirq,
996 unsigned int *out_type)
> 997 {
998 if (WARN_ON(fwspec->param_count < 1))
999 return -EINVAL;
1000 *out_hwirq = fwspec->param[0];
1001 *out_type = IRQ_TYPE_NONE;
1002 return 0;
1003 }
1004 EXPORT_SYMBOL_GPL(irq_domain_translate_onecell);
1005
--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki