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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202501112255.Mygdotrd-lkp@intel.com>
Date: Sat, 11 Jan 2025 22:24:00 +0800
From: kernel test robot <lkp@...el.com>
To: Wang Qing <wangqing@...o.com>
Cc: oe-kbuild-all@...ts.linux.dev, linux-kernel@...r.kernel.org,
	Tony Lindgren <tony@...mide.com>
Subject: arch/arm/mach-omap2/clockdomain.c:1303: warning: Function parameter
 or struct member 'unused' not described in '_clkdm_save_context'

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   77a903cd8e5a91d120ee014c8f8eae74d6c5d0f6
commit: 320f6f90cbe4818cf0d0f9441772d23aa441c506 ARM: OMAP2+: fix spellint typo
date:   4 years ago
config: arm-randconfig-r024-20230303 (https://download.01.org/0day-ci/archive/20250111/202501112255.Mygdotrd-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/20250111/202501112255.Mygdotrd-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@...el.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202501112255.Mygdotrd-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@...com>
:::::: CC: Tony Lindgren <tony@...mide.com>

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