[linux-next:master 6682/11453] drivers/gpu/drm/amd/amdgpu/amdgpu_doorbell_mgr.c:123: warning: Function parameter or member 'doorbell_index' not described in 'amdgpu_doorbell_index_on_bar'

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

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master
head:   47d9bb711707d15b19fad18c8e2b4b027a264a3a
commit: d124aa0ac96358042ba34df091a3bfa6e77fcf6f [6682/11453] drm/amdgpu: get absolute offset from doorbell index
config: i386-randconfig-i016-20230821 (https://download.01.org/0day-ci/archive/20230822/202308220614.h0EIBlon-lkp@intel.com/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce: (https://download.01.org/0day-ci/archive/20230822/202308220614.h0EIBlon-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/202308220614.h0EIBlon-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/amd/amdgpu/amdgpu_doorbell_mgr.c:123: warning: Function parameter or member 'doorbell_index' not described in 'amdgpu_doorbell_index_on_bar'
>> drivers/gpu/drm/amd/amdgpu/amdgpu_doorbell_mgr.c:123: warning: Excess function parameter 'db_index' description in 'amdgpu_doorbell_index_on_bar'


vim +123 drivers/gpu/drm/amd/amdgpu/amdgpu_doorbell_mgr.c

   110	
   111	/**
   112	 * amdgpu_doorbell_index_on_bar - Find doorbell's absolute offset in BAR
   113	 *
   114	 * @adev: amdgpu_device pointer
   115	 * @db_bo: doorbell object's bo
   116	 * @db_index: doorbell relative index in this doorbell object
   117	 *
   118	 * returns doorbell's absolute index in BAR
   119	 */
   120	uint32_t amdgpu_doorbell_index_on_bar(struct amdgpu_device *adev,
   121					       struct amdgpu_bo *db_bo,
   122					       uint32_t doorbell_index)
 > 123	{
   124		int db_bo_offset;
   125	
   126		db_bo_offset = amdgpu_bo_gpu_offset_no_check(db_bo);
   127	
   128		/* doorbell index is 32 bit but doorbell's size is 64-bit, so *2 */
   129		return db_bo_offset / sizeof(u32) + doorbell_index * 2;
   130	}
   131	

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