arch/arm/mach-omap2/clockdomain.c:1303: warning: Function parameter or struct member 'unused' not described in '_clkdm_save_context'

[kernel test robot <lkp@intel.com>]

Hi Wang,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   4dc1d1bec89864d8076e5ab314f86f46442bfb02
commit: 320f6f90cbe4818cf0d0f9441772d23aa441c506 ARM: OMAP2+: fix spellint typo
date:   4 years, 1 month ago
config: arm-randconfig-r011-20220722 (https://download.01.org/0day-ci/archive/20250213/202502131858.NrCAEuh6-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 12.4.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250213/202502131858.NrCAEuh6-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/202502131858.NrCAEuh6-lkp@intel.com/

All warnings (new ones prefixed by >>):

   arch/arm/mach-omap2/clockdomain.c:546: warning: Function parameter or struct member 'user' not described in 'clkdm_for_each'
   arch/arm/mach-omap2/clockdomain.c:1003: warning: expecting prototype for clkdm_deny_idle(). Prototype was for clkdm_deny_idle_nolock() instead
   arch/arm/mach-omap2/clockdomain.c:1165: warning: Function parameter or struct member 'unused' not described in 'clkdm_clk_enable'
   arch/arm/mach-omap2/clockdomain.c:1165: warning: Excess function parameter 'clk' description in 'clkdm_clk_enable'
   arch/arm/mach-omap2/clockdomain.c:1303: warning: Function parameter or struct member 'clkdm' not described in '_clkdm_save_context'
>> arch/arm/mach-omap2/clockdomain.c:1303: warning: Function parameter or struct member 'unused' not described in '_clkdm_save_context'
   arch/arm/mach-omap2/clockdomain.c:1316: warning: Function parameter or struct member 'clkdm' not described in '_clkdm_restore_context'
>> arch/arm/mach-omap2/clockdomain.c:1316: warning: Function parameter or struct member 'unused' not described in '_clkdm_restore_context'


vim +1303 arch/arm/mach-omap2/clockdomain.c

d459bfe01f5239 Paul Walmsley 2008-08-19  1295  
1096d1c10bb3d8 Russ Dill     2018-05-16  1296  /**
1096d1c10bb3d8 Russ Dill     2018-05-16  1297   * _clkdm_save_context - save the context for the control of this clkdm
1096d1c10bb3d8 Russ Dill     2018-05-16  1298   *
1096d1c10bb3d8 Russ Dill     2018-05-16  1299   * Due to a suspend or hibernation operation, the state of the registers
1096d1c10bb3d8 Russ Dill     2018-05-16  1300   * controlling this clkdm will be lost, save their context.
1096d1c10bb3d8 Russ Dill     2018-05-16  1301   */
320f6f90cbe481 Wang Qing     2020-09-17  1302  static int _clkdm_save_context(struct clockdomain *clkdm, void *unused)
1096d1c10bb3d8 Russ Dill     2018-05-16 @1303  {
1096d1c10bb3d8 Russ Dill     2018-05-16  1304  	if (!arch_clkdm || !arch_clkdm->clkdm_save_context)
1096d1c10bb3d8 Russ Dill     2018-05-16  1305  		return -EINVAL;
1096d1c10bb3d8 Russ Dill     2018-05-16  1306  
1096d1c10bb3d8 Russ Dill     2018-05-16  1307  	return arch_clkdm->clkdm_save_context(clkdm);
1096d1c10bb3d8 Russ Dill     2018-05-16  1308  }
1096d1c10bb3d8 Russ Dill     2018-05-16  1309  
1096d1c10bb3d8 Russ Dill     2018-05-16  1310  /**
1096d1c10bb3d8 Russ Dill     2018-05-16  1311   * _clkdm_restore_context - restore context for control of this clkdm
1096d1c10bb3d8 Russ Dill     2018-05-16  1312   *
1096d1c10bb3d8 Russ Dill     2018-05-16  1313   * Restore the register values for this clockdomain.
1096d1c10bb3d8 Russ Dill     2018-05-16  1314   */
320f6f90cbe481 Wang Qing     2020-09-17  1315  static int _clkdm_restore_context(struct clockdomain *clkdm, void *unused)
1096d1c10bb3d8 Russ Dill     2018-05-16 @1316  {
1096d1c10bb3d8 Russ Dill     2018-05-16  1317  	if (!arch_clkdm || !arch_clkdm->clkdm_restore_context)
1096d1c10bb3d8 Russ Dill     2018-05-16  1318  		return -EINVAL;
1096d1c10bb3d8 Russ Dill     2018-05-16  1319  
1096d1c10bb3d8 Russ Dill     2018-05-16  1320  	return arch_clkdm->clkdm_restore_context(clkdm);
1096d1c10bb3d8 Russ Dill     2018-05-16  1321  }
1096d1c10bb3d8 Russ Dill     2018-05-16  1322  

:::::: The code at line 1303 was first introduced by commit
:::::: 1096d1c10bb3d869b5630dfa88f4c18f3d579752 ARM: OMAP2+: Add functions to save and restore clockdomain context en-masse.

:::::: TO: Russ Dill <Russ.Dill@ti.com>
:::::: CC: Tony Lindgren <tony@atomide.com>

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