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

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

[kernel test robot]

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@intel.com/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@intel.com/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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202311260151.b1ciS4X3-lkp@intel.com/

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@ti.com>
:::::: CC: Paul Walmsley <paul@pwsan.com>

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