kernel/irq/irqdomain.c:985: warning: Function parameter or member 'd' not described in 'irq_domain_translate_twocell'
From: kernel test robot
Date: Sun Sep 24 2023 - 23:52:00 EST
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 6465e260f48790807eef06b583b38ca9789b6072
commit: b5c231d8c8037f63d34199ea1667bbe1cd9f940f genirq: introduce irq_domain_translate_twocell
date: 4 years, 7 months ago
config: csky-allnoconfig (https://download.01.org/0day-ci/archive/20230925/202309251106.wRRxZioD-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/20230925/202309251106.wRRxZioD-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/202309251106.wRRxZioD-lkp@xxxxxxxxx/
All warnings (new ones prefixed by >>):
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
922
923 /**
924 * irq_domain_xlate_twocell() - Generic xlate for direct two cell bindings
925 *
926 * Device Tree IRQ specifier translation function which works with two cell
927 * bindings where the cell values map directly to the hwirq number
928 * and linux irq flags.
929 */
930 int irq_domain_xlate_twocell(struct irq_domain *d, struct device_node *ctrlr,
931 const u32 *intspec, unsigned int intsize,
932 irq_hw_number_t *out_hwirq, unsigned int *out_type)
> 933 {
934 struct irq_fwspec fwspec;
935
936 of_phandle_args_to_fwspec(ctrlr, intspec, intsize, &fwspec);
937 return irq_domain_translate_twocell(d, &fwspec, out_hwirq, out_type);
938 }
939 EXPORT_SYMBOL_GPL(irq_domain_xlate_twocell);
940
941 /**
942 * irq_domain_xlate_onetwocell() - Generic xlate for one or two cell bindings
943 *
944 * Device Tree IRQ specifier translation function which works with either one
945 * or two cell bindings where the cell values map directly to the hwirq number
946 * and linux irq flags.
947 *
948 * Note: don't use this function unless your interrupt controller explicitly
949 * supports both one and two cell bindings. For the majority of controllers
950 * the _onecell() or _twocell() variants above should be used.
951 */
952 int irq_domain_xlate_onetwocell(struct irq_domain *d,
953 struct device_node *ctrlr,
954 const u32 *intspec, unsigned int intsize,
955 unsigned long *out_hwirq, unsigned int *out_type)
> 956 {
957 if (WARN_ON(intsize < 1))
958 return -EINVAL;
959 *out_hwirq = intspec[0];
960 if (intsize > 1)
961 *out_type = intspec[1] & IRQ_TYPE_SENSE_MASK;
962 else
963 *out_type = IRQ_TYPE_NONE;
964 return 0;
965 }
966 EXPORT_SYMBOL_GPL(irq_domain_xlate_onetwocell);
967
968 const struct irq_domain_ops irq_domain_simple_ops = {
969 .xlate = irq_domain_xlate_onetwocell,
970 };
971 EXPORT_SYMBOL_GPL(irq_domain_simple_ops);
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