[freescale-fslc:pr/639 4388/24603] drivers/crypto/caam/jr.c:344: warning: Function parameter or member 'idx' not described in 'caam_jridx_alloc'

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

tree:   https://github.com/Freescale/linux-fslc pr/639
head:   857fbf7cebaba3b1ffccc558deee1d13ac0e11d7
commit: cf6c9073ad386aba7f02cce1ca1d49137b43dbc5 [4388/24603] crypto: caam - add functionality used by the caam_dma driver
config: arm-defconfig (https://download.01.org/0day-ci/archive/20230901/202309011415.vmjjiVOn-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20230901/202309011415.vmjjiVOn-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/202309011415.vmjjiVOn-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/crypto/caam/jr.c:344: warning: Function parameter or member 'idx' not described in 'caam_jridx_alloc'


vim +344 drivers/crypto/caam/jr.c

   336	
   337	/**
   338	 * caam_jridx_alloc() - Alloc a specific job ring based on its index.
   339	 *
   340	 * returns :  pointer to the newly allocated physical
   341	 *	      JobR dev can be written to if successful.
   342	 **/
   343	struct device *caam_jridx_alloc(int idx)
 > 344	{
   345		struct caam_drv_private_jr *jrpriv;
   346		struct device *dev = ERR_PTR(-ENODEV);
   347	
   348		spin_lock(&driver_data.jr_alloc_lock);
   349	
   350		if (list_empty(&driver_data.jr_list))
   351			goto end;
   352	
   353		list_for_each_entry(jrpriv, &driver_data.jr_list, list_node) {
   354			if (jrpriv->ridx == idx) {
   355				atomic_inc(&jrpriv->tfm_count);
   356				dev = jrpriv->dev;
   357				break;
   358			}
   359		}
   360	
   361	end:
   362		spin_unlock(&driver_data.jr_alloc_lock);
   363		return dev;
   364	}
   365	EXPORT_SYMBOL(caam_jridx_alloc);
   366	

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