drivers/hv/channel.c:514: warning: Function parameter or member 'size' not described in 'request_arr_init'

From: kernel test robot
Date: Thu Jan 11 2024 - 02:18:38 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: de927f6c0b07d9e698416c5b287c521b07694cac
commit: e8b7db38449ac5b950a3f00519171c4be3e226ff Drivers: hv: vmbus: Add vmbus_requestor data structure for VMBus hardening
date: 3 years, 2 months ago
config: x86_64-buildonly-randconfig-006-20240105 (https://download.01.org/0day-ci/archive/20240111/202401111558.xOlI0nqd-lkp@xxxxxxxxx/config)
compiler: ClangBuiltLinux clang version 17.0.6 (https://github.com/llvm/llvm-project 6009708b4367171ccdbf4b5905cb6a803753fe18)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20240111/202401111558.xOlI0nqd-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/202401111558.xOlI0nqd-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/hv/channel.c:514: warning: Function parameter or member 'size' not described in 'request_arr_init'


vim +514 drivers/hv/channel.c

505
506 /**
507 * request_arr_init - Allocates memory for the requestor array. Each slot
508 * keeps track of the next available slot in the array. Initially, each
509 * slot points to the next one (as in a Linked List). The last slot
510 * does not point to anything, so its value is U64_MAX by default.
511 * @size The size of the array
512 */
513 static u64 *request_arr_init(u32 size)
> 514 {
515 int i;
516 u64 *req_arr;
517
518 req_arr = kcalloc(size, sizeof(u64), GFP_KERNEL);
519 if (!req_arr)
520 return NULL;
521
522 for (i = 0; i < size - 1; i++)
523 req_arr[i] = i + 1;
524
525 /* Last slot (no more available slots) */
526 req_arr[i] = U64_MAX;
527
528 return req_arr;
529 }
530

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