[android-common:android16-6.12-desktop 1/1] sound/soc/codecs/rt-sdw-common.c:87: warning: Function parameter or struct member 'val' not described in 'rt_sdca_index_update_bits'

Hi Jack,

First bad commit (maybe != root cause):

tree:   https://android.googlesource.com/kernel/common android16-6.12-desktop
head:   24c37396da197463e1ff2bc69bb789e34dacad53
commit: ba46a64341209fd14a19c13e35a61bca6f571812 [1/1] UPSTREAM: ASoC: rt721-sdca: Add RT721 SDCA driver
config: i386-allmodconfig (https://download.01.org/0day-ci/archive/20260813/[email protected]/config)
compiler: gcc-14 (Debian 14.2.0-19) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20260813/[email protected]/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 <[email protected]>
| Closes: https://lore.kernel.org/oe-kbuild-all/[email protected]/

All warnings (new ones prefixed by >>):

>> sound/soc/codecs/rt-sdw-common.c:87: warning: Function parameter or struct member 'val' not described in 'rt_sdca_index_update_bits'
>> sound/soc/codecs/rt-sdw-common.c:87: warning: Excess function parameter 'value' description in 'rt_sdca_index_update_bits'


vim +87 sound/soc/codecs/rt-sdw-common.c

cbc3cb613e4044c Jack Yu 2024-10-01  71  
cbc3cb613e4044c Jack Yu 2024-10-01  72  /**
cbc3cb613e4044c Jack Yu 2024-10-01  73   * rt_sdca_index_update_bits - Update value on Realtek defined register.
cbc3cb613e4044c Jack Yu 2024-10-01  74   *
cbc3cb613e4044c Jack Yu 2024-10-01  75   * @map: map for setting.
cbc3cb613e4044c Jack Yu 2024-10-01  76   * @nid: Realtek-defined ID.
cbc3cb613e4044c Jack Yu 2024-10-01  77   * @reg: register.
cbc3cb613e4044c Jack Yu 2024-10-01  78   * @mask: Bitmask to change
cbc3cb613e4044c Jack Yu 2024-10-01  79   * @value: New value for bitmask
cbc3cb613e4044c Jack Yu 2024-10-01  80   *
cbc3cb613e4044c Jack Yu 2024-10-01  81   * A value of zero will be returned on success, a negative errno will
cbc3cb613e4044c Jack Yu 2024-10-01  82   * be returned in error cases.
cbc3cb613e4044c Jack Yu 2024-10-01  83   */
cbc3cb613e4044c Jack Yu 2024-10-01  84  
cbc3cb613e4044c Jack Yu 2024-10-01  85  int rt_sdca_index_update_bits(struct regmap *map,
cbc3cb613e4044c Jack Yu 2024-10-01  86  	unsigned int nid, unsigned int reg, unsigned int mask, unsigned int val)
cbc3cb613e4044c Jack Yu 2024-10-01 @87  {
cbc3cb613e4044c Jack Yu 2024-10-01  88  	unsigned int tmp;
cbc3cb613e4044c Jack Yu 2024-10-01  89  	int ret;
cbc3cb613e4044c Jack Yu 2024-10-01  90  
cbc3cb613e4044c Jack Yu 2024-10-01  91  	ret = rt_sdca_index_read(map, nid, reg, &tmp);
cbc3cb613e4044c Jack Yu 2024-10-01  92  	if (ret < 0)
cbc3cb613e4044c Jack Yu 2024-10-01  93  		return ret;
cbc3cb613e4044c Jack Yu 2024-10-01  94  
cbc3cb613e4044c Jack Yu 2024-10-01  95  	set_mask_bits(&tmp, mask, val);
cbc3cb613e4044c Jack Yu 2024-10-01  96  	return rt_sdca_index_write(map, nid, reg, tmp);
cbc3cb613e4044c Jack Yu 2024-10-01  97  }
cbc3cb613e4044c Jack Yu 2024-10-01  98  EXPORT_SYMBOL_GPL(rt_sdca_index_update_bits);
cbc3cb613e4044c Jack Yu 2024-10-01  99  

:::::: The code at line 87 was first introduced by commit
:::::: cbc3cb613e4044c076c6648ce0934818cba52545 UPSTREAM: ASoC: rt-sdw-common: Common functions for Realtek soundwire driver

:::::: TO: Jack Yu <[email protected]>
:::::: CC: Treehugger Robot <[email protected]>

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