drivers/opp/core.c:2304: warning: Function parameter or member 'opp_table' not described in '_opp_set_config_regulators_helper'

From: kernel test robot
Date: Sat Sep 09 2023 - 22:46:06 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: a3c57ab79a06e333a869ae340420cb3c6f5921d3
commit: aee3352f6ecf8cfad1f1ee5838cfc4d37c6b8f75 OPP: Add support for config_regulators() helper
date: 1 year, 2 months ago
config: csky-defconfig (https://download.01.org/0day-ci/archive/20230910/202309101018.J5Y4Fs3E-lkp@xxxxxxxxx/config)
compiler: csky-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20230910/202309101018.J5Y4Fs3E-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/202309101018.J5Y4Fs3E-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

drivers/opp/core.c:1989: warning: Function parameter or member 'opp_table' not described in '_opp_set_supported_hw'
drivers/opp/core.c:1989: warning: Excess function parameter 'dev' description in '_opp_set_supported_hw'
drivers/opp/core.c:2032: warning: Function parameter or member 'opp_table' not described in '_opp_set_prop_name'
drivers/opp/core.c:2032: warning: Excess function parameter 'dev' description in '_opp_set_prop_name'
drivers/opp/core.c:2073: warning: Function parameter or member 'opp_table' not described in '_opp_set_regulators'
drivers/opp/core.c:2073: warning: Excess function parameter 'count' description in '_opp_set_regulators'
drivers/opp/core.c:2186: warning: Function parameter or member 'opp_table' not described in '_opp_set_clknames'
drivers/opp/core.c:2250: warning: Function parameter or member 'opp_table' not described in '_opp_register_set_opp_helper'
>> drivers/opp/core.c:2304: warning: Function parameter or member 'opp_table' not described in '_opp_set_config_regulators_helper'
drivers/opp/core.c:2368: warning: Function parameter or member 'opp_table' not described in '_opp_attach_genpd'
drivers/opp/core.c:2602: warning: Function parameter or member 'token' not described in 'dev_pm_opp_clear_config'
drivers/opp/core.c:2602: warning: Excess function parameter 'opp_table' description in 'dev_pm_opp_clear_config'


vim +2304 drivers/opp/core.c

2292
2293 /**
2294 * _opp_set_config_regulators_helper() - Register custom set regulator helper.
2295 * @dev: Device for which the helper is getting registered.
2296 * @config_regulators: Custom set regulator helper.
2297 *
2298 * This is useful to support platforms with multiple regulators per device.
2299 *
2300 * This must be called before any OPPs are initialized for the device.
2301 */
2302 static int _opp_set_config_regulators_helper(struct opp_table *opp_table,
2303 struct device *dev, config_regulators_t config_regulators)
> 2304 {
2305 /* Another CPU that shares the OPP table has set the helper ? */
2306 if (!opp_table->config_regulators)
2307 opp_table->config_regulators = config_regulators;
2308
2309 return 0;
2310 }
2311

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