drivers/hwtracing/intel_th/core.c:838: warning: Excess function parameter 'irq' description in 'intel_th_alloc'

From: kernel test robot
Date: Mon Feb 19 2024 - 13:43:33 EST


Hi Alexander,

FYI, the error/warning still remains.

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: b401b621758e46812da61fa58a67c3fd8d91de0d
commit: 62a593022c32380d040303a5e3d6b67fd9c415bc intel_th: Communicate IRQ via resource
date: 4 years, 10 months ago
config: x86_64-buildonly-randconfig-001-20231012 (https://download.01.org/0day-ci/archive/20240220/202402200202.TzVSNB1m-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/20240220/202402200202.TzVSNB1m-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/202402200202.TzVSNB1m-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

drivers/hwtracing/intel_th/core.c:838: warning: Function parameter or member 'drvdata' not described in 'intel_th_alloc'
drivers/hwtracing/intel_th/core.c:838: warning: Function parameter or member 'ndevres' not described in 'intel_th_alloc'
>> drivers/hwtracing/intel_th/core.c:838: warning: Excess function parameter 'irq' description in 'intel_th_alloc'


vim +838 drivers/hwtracing/intel_th/core.c

39f4034693b7c7 Alexander Shishkin 2015-09-22 828
39f4034693b7c7 Alexander Shishkin 2015-09-22 829 /**
39f4034693b7c7 Alexander Shishkin 2015-09-22 830 * intel_th_alloc() - allocate a new Intel TH device and its subdevices
39f4034693b7c7 Alexander Shishkin 2015-09-22 831 * @dev: parent device
db73a059de00ee Alexander Shishkin 2019-05-03 832 * @devres: resources indexed by th_mmio_idx
39f4034693b7c7 Alexander Shishkin 2015-09-22 833 * @irq: irq number
39f4034693b7c7 Alexander Shishkin 2015-09-22 834 */
39f4034693b7c7 Alexander Shishkin 2015-09-22 835 struct intel_th *
3321371b5d6484 Alexander Shishkin 2017-08-18 836 intel_th_alloc(struct device *dev, struct intel_th_drvdata *drvdata,
62a593022c3238 Alexander Shishkin 2019-05-03 837 struct resource *devres, unsigned int ndevres)
39f4034693b7c7 Alexander Shishkin 2015-09-22 @838 {
62a593022c3238 Alexander Shishkin 2019-05-03 839 int err, r, nr_mmios = 0;
39f4034693b7c7 Alexander Shishkin 2015-09-22 840 struct intel_th *th;
661b0df8489a35 Alexander Shishkin 2017-08-23 841
39f4034693b7c7 Alexander Shishkin 2015-09-22 842 th = kzalloc(sizeof(*th), GFP_KERNEL);
39f4034693b7c7 Alexander Shishkin 2015-09-22 843 if (!th)
39f4034693b7c7 Alexander Shishkin 2015-09-22 844 return ERR_PTR(-ENOMEM);
39f4034693b7c7 Alexander Shishkin 2015-09-22 845
39f4034693b7c7 Alexander Shishkin 2015-09-22 846 th->id = ida_simple_get(&intel_th_ida, 0, 0, GFP_KERNEL);
39f4034693b7c7 Alexander Shishkin 2015-09-22 847 if (th->id < 0) {
39f4034693b7c7 Alexander Shishkin 2015-09-22 848 err = th->id;
39f4034693b7c7 Alexander Shishkin 2015-09-22 849 goto err_alloc;
39f4034693b7c7 Alexander Shishkin 2015-09-22 850 }
39f4034693b7c7 Alexander Shishkin 2015-09-22 851
39f4034693b7c7 Alexander Shishkin 2015-09-22 852 th->major = __register_chrdev(0, 0, TH_POSSIBLE_OUTPUTS,
39f4034693b7c7 Alexander Shishkin 2015-09-22 853 "intel_th/output", &intel_th_output_fops);
39f4034693b7c7 Alexander Shishkin 2015-09-22 854 if (th->major < 0) {
39f4034693b7c7 Alexander Shishkin 2015-09-22 855 err = th->major;
39f4034693b7c7 Alexander Shishkin 2015-09-22 856 goto err_ida;
39f4034693b7c7 Alexander Shishkin 2015-09-22 857 }
62a593022c3238 Alexander Shishkin 2019-05-03 858 th->irq = -1;
39f4034693b7c7 Alexander Shishkin 2015-09-22 859 th->dev = dev;
3321371b5d6484 Alexander Shishkin 2017-08-18 860 th->drvdata = drvdata;
39f4034693b7c7 Alexander Shishkin 2015-09-22 861
db73a059de00ee Alexander Shishkin 2019-05-03 862 for (r = 0; r < ndevres; r++)
62a593022c3238 Alexander Shishkin 2019-05-03 863 switch (devres[r].flags & IORESOURCE_TYPE_BITS) {
62a593022c3238 Alexander Shishkin 2019-05-03 864 case IORESOURCE_MEM:
62a593022c3238 Alexander Shishkin 2019-05-03 865 th->resource[nr_mmios++] = devres[r];
62a593022c3238 Alexander Shishkin 2019-05-03 866 break;
62a593022c3238 Alexander Shishkin 2019-05-03 867 case IORESOURCE_IRQ:
62a593022c3238 Alexander Shishkin 2019-05-03 868 if (th->irq == -1)
62a593022c3238 Alexander Shishkin 2019-05-03 869 th->irq = devres[r].start;
62a593022c3238 Alexander Shishkin 2019-05-03 870 break;
62a593022c3238 Alexander Shishkin 2019-05-03 871 default:
62a593022c3238 Alexander Shishkin 2019-05-03 872 dev_warn(dev, "Unknown resource type %lx\n",
62a593022c3238 Alexander Shishkin 2019-05-03 873 devres[r].flags);
62a593022c3238 Alexander Shishkin 2019-05-03 874 break;
62a593022c3238 Alexander Shishkin 2019-05-03 875 }
62a593022c3238 Alexander Shishkin 2019-05-03 876
62a593022c3238 Alexander Shishkin 2019-05-03 877 th->num_resources = nr_mmios;
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 878
d7b1787161b78a Alexander Shishkin 2016-02-15 879 dev_set_drvdata(dev, th);
d7b1787161b78a Alexander Shishkin 2016-02-15 880
142dfeb2020960 Alexander Shishkin 2016-06-22 881 pm_runtime_no_callbacks(dev);
142dfeb2020960 Alexander Shishkin 2016-06-22 882 pm_runtime_put(dev);
142dfeb2020960 Alexander Shishkin 2016-06-22 883 pm_runtime_allow(dev);
142dfeb2020960 Alexander Shishkin 2016-06-22 884
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 885 err = intel_th_populate(th);
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 886 if (err) {
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 887 /* free the subdevices and undo everything */
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 888 intel_th_free(th);
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 889 return ERR_PTR(err);
a753bfcfdb1f31 Alexander Shishkin 2017-08-10 890 }
39f4034693b7c7 Alexander Shishkin 2015-09-22 891
39f4034693b7c7 Alexander Shishkin 2015-09-22 892 return th;
39f4034693b7c7 Alexander Shishkin 2015-09-22 893
39f4034693b7c7 Alexander Shishkin 2015-09-22 894 err_ida:
39f4034693b7c7 Alexander Shishkin 2015-09-22 895 ida_simple_remove(&intel_th_ida, th->id);
39f4034693b7c7 Alexander Shishkin 2015-09-22 896
39f4034693b7c7 Alexander Shishkin 2015-09-22 897 err_alloc:
39f4034693b7c7 Alexander Shishkin 2015-09-22 898 kfree(th);
39f4034693b7c7 Alexander Shishkin 2015-09-22 899
39f4034693b7c7 Alexander Shishkin 2015-09-22 900 return ERR_PTR(err);
39f4034693b7c7 Alexander Shishkin 2015-09-22 901 }
39f4034693b7c7 Alexander Shishkin 2015-09-22 902 EXPORT_SYMBOL_GPL(intel_th_alloc);
39f4034693b7c7 Alexander Shishkin 2015-09-22 903

:::::: The code at line 838 was first introduced by commit
:::::: 39f4034693b7c7bd1fe4cb58c93259d600f55561 intel_th: Add driver infrastructure for Intel(R) Trace Hub devices

:::::: TO: Alexander Shishkin <alexander.shishkin@xxxxxxxxxxxxxxx>
:::::: CC: Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>

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