[intel-lts:6.12/emt 9/9] arch/x86/kernel/tsc.c:1338: warning: Function parameter or struct member 'system_counter' not described in 'convert_tsc_to_art'

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

tree:   https://github.com/intel/linux-intel-lts.git 6.12/emt
head:   aac28a88afc1d68448c7e5672fed4da83e10fe8b
commit: 7f36119fd0bcdc0fee9bb16b971f924bb502b888 [9/9] ptp: tgpio: PSE TGPIO crosststamp, counttstamp
config: x86_64-allnoconfig-bpf (https://download.01.org/0day-ci/archive/20251211/202512111823.lILdCWOV-lkp@intel.com/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/20251211/202512111823.lILdCWOV-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/202512111823.lILdCWOV-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> arch/x86/kernel/tsc.c:1338: warning: Function parameter or struct member 'system_counter' not described in 'convert_tsc_to_art'
>> arch/x86/kernel/tsc.c:1338: warning: Function parameter or struct member 'art' not described in 'convert_tsc_to_art'


vim +1338 arch/x86/kernel/tsc.c

  1326	
  1327	/**
  1328	 * convert_tsc_to_art() - Returns ART value associated with system counter
  1329	 *
  1330	 * Converts input TSC to the corresponding ART value using conversion
  1331	 * factors discovered by detect_art()
  1332	 *
  1333	 * Return:
  1334	 * u64 ART value
  1335	 */
  1336	int convert_tsc_to_art(
  1337		const struct system_counterval_t *system_counter, u64 *art)
> 1338	{
  1339		u64 tmp, res, rem;
  1340	
  1341		if (system_counter->cs_id != CSID_X86_TSC)
  1342			return -EINVAL;
  1343	
  1344		res = system_counter->cycles - art_to_tsc_offset;
  1345		rem = do_div(res, art_to_tsc_numerator);
  1346	
  1347		*art = res * art_to_tsc_denominator;
  1348		tmp = rem * art_to_tsc_denominator;
  1349	
  1350		do_div(tmp, art_to_tsc_numerator);
  1351		*art += tmp;
  1352	
  1353		return 0;
  1354	}
  1355	EXPORT_SYMBOL(convert_tsc_to_art);
  1356	

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