arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'xlate_clkctrl'

From: kernel test robot
Date: Sat Nov 25 2023 - 13:23:56 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 0f5cc96c367f2e780eb492cc9cab84e3b2ca88da
commit: 70f05be3213393f20f01e4d59625df7ee49fe32f ARM: OMAP2+: hwmod: populate clkctrl clocks for hwmods if available
date: 6 years ago
config: arm-randconfig-001-20231123 (https://download.01.org/0day-ci/archive/20231126/202311260151.b1ciS4X3-lkp@xxxxxxxxx/config)
compiler: arm-linux-gnueabi-gcc (GCC) 7.5.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231126/202311260151.b1ciS4X3-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/202311260151.b1ciS4X3-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'wait_target_ready'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'assert_hardreset'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'deassert_hardreset'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'is_hardreset_asserted'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'init_clkdm'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'update_context_lost'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'get_context_lost'
arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'disable_direct_prcm'
>> arch/arm/mach-omap2/omap_hwmod.c:228: warning: No description found for parameter 'xlate_clkctrl'
arch/arm/mach-omap2/omap_hwmod.c:583: warning: No description found for parameter 'v'
arch/arm/mach-omap2/omap_hwmod.c:616: warning: No description found for parameter 'v'
arch/arm/mach-omap2/omap_hwmod.c:670: warning: No description found for parameter 'init_oh'
arch/arm/mach-omap2/omap_hwmod.c:699: warning: No description found for parameter 'init_oh'
arch/arm/mach-omap2/omap_hwmod.c:1128: warning: No description found for parameter 'os'
arch/arm/mach-omap2/omap_hwmod.c:1128: warning: Excess function parameter 'oh' description in '_count_ocp_if_addr_spaces'
arch/arm/mach-omap2/omap_hwmod.c:2446: warning: No description found for parameter 'data'
arch/arm/mach-omap2/omap_hwmod.c:2446: warning: Excess function parameter 'n' description in '_init'
arch/arm/mach-omap2/omap_hwmod.c:2644: warning: No description found for parameter 'data'
arch/arm/mach-omap2/omap_hwmod.c:2644: warning: Excess function parameter 'n' description in '_setup'


vim +/xlate_clkctrl +228 arch/arm/mach-omap2/omap_hwmod.c

70f05be3213393 Tero Kristo 2017-05-31 202
9ebfd285371835 Kevin Hilman 2012-06-18 203 /**
9ebfd285371835 Kevin Hilman 2012-06-18 204 * struct omap_hwmod_soc_ops - fn ptrs for some SoC-specific operations
9ebfd285371835 Kevin Hilman 2012-06-18 205 * @enable_module: function to enable a module (via MODULEMODE)
9ebfd285371835 Kevin Hilman 2012-06-18 206 * @disable_module: function to disable a module (via MODULEMODE)
9ebfd285371835 Kevin Hilman 2012-06-18 207 *
9ebfd285371835 Kevin Hilman 2012-06-18 208 * XXX Eventually this functionality will be hidden inside the PRM/CM
9ebfd285371835 Kevin Hilman 2012-06-18 209 * device drivers. Until then, this should avoid huge blocks of cpu_is_*()
9ebfd285371835 Kevin Hilman 2012-06-18 210 * conditionals in this code.
9ebfd285371835 Kevin Hilman 2012-06-18 211 */
9ebfd285371835 Kevin Hilman 2012-06-18 212 struct omap_hwmod_soc_ops {
9ebfd285371835 Kevin Hilman 2012-06-18 213 void (*enable_module)(struct omap_hwmod *oh);
9ebfd285371835 Kevin Hilman 2012-06-18 214 int (*disable_module)(struct omap_hwmod *oh);
8f6aa8ee114fb5 Kevin Hilman 2012-06-18 215 int (*wait_target_ready)(struct omap_hwmod *oh);
b8249cf2d2b16d Kevin Hilman 2012-06-18 216 int (*assert_hardreset)(struct omap_hwmod *oh,
b8249cf2d2b16d Kevin Hilman 2012-06-18 217 struct omap_hwmod_rst_info *ohri);
b8249cf2d2b16d Kevin Hilman 2012-06-18 218 int (*deassert_hardreset)(struct omap_hwmod *oh,
b8249cf2d2b16d Kevin Hilman 2012-06-18 219 struct omap_hwmod_rst_info *ohri);
b8249cf2d2b16d Kevin Hilman 2012-06-18 220 int (*is_hardreset_asserted)(struct omap_hwmod *oh,
b8249cf2d2b16d Kevin Hilman 2012-06-18 221 struct omap_hwmod_rst_info *ohri);
0a179eaa436e58 Kevin Hilman 2012-06-18 222 int (*init_clkdm)(struct omap_hwmod *oh);
e6d3a8b0bdcd8f Rajendra Nayak 2012-11-21 223 void (*update_context_lost)(struct omap_hwmod *oh);
e6d3a8b0bdcd8f Rajendra Nayak 2012-11-21 224 int (*get_context_lost)(struct omap_hwmod *oh);
9fabc1a26e37f8 Tero Kristo 2016-07-04 225 int (*disable_direct_prcm)(struct omap_hwmod *oh);
70f05be3213393 Tero Kristo 2017-05-31 226 u32 (*xlate_clkctrl)(struct omap_hwmod *oh,
70f05be3213393 Tero Kristo 2017-05-31 227 struct clkctrl_provider *provider);
9ebfd285371835 Kevin Hilman 2012-06-18 @228 };
9ebfd285371835 Kevin Hilman 2012-06-18 229

:::::: The code at line 228 was first introduced by commit
:::::: 9ebfd285371835b1c0243d15aaacd72d5def76f8 ARM: OMAP2+: hwmod: use init-time function ptrs for enable/disable module

:::::: TO: Kevin Hilman <khilman@xxxxxx>
:::::: CC: Paul Walmsley <paul@xxxxxxxxx>

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