drivers/spmi/spmi-pmic-arb.c:215: warning: No description found for parameter 'pmic_arb'

[kernel test robot <yujie.liu@intel.com>]

Hi Kiran,

FYI, the error/warning was bisected to this commit, please ignore it if it's irrelevant.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   0f5cc96c367f2e780eb492cc9cab84e3b2ca88da
commit: 02abec3616c1b2027efc7e08abf7fc0d2436a837 spmi: pmic-arb: rename pa_xx to pmic_arb_xx and other cleanup
config: arm-randconfig-001-20231123 (https://download.01.org/0day-ci/archive/20231126/202311260405.YL0cVHtZ-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 7.5.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231126/202311260405.YL0cVHtZ-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 <yujie.liu@intel.com>
| Closes: https://lore.kernel.org/r/202311260405.YL0cVHtZ-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/spmi/spmi-pmic-arb.c: In function 'pmic_arb_write_cmd':
   drivers/spmi/spmi-pmic-arb.c:399:15: warning: comparison is always true due to limited range of data type [-Wtype-limits]
     else if (opc >= 0x00 && opc <= 0x0F)
                  ^~
   drivers/spmi/spmi-pmic-arb.c:137: warning: cannot understand function prototype: 'struct spmi_pmic_arb '
   drivers/spmi/spmi-pmic-arb.c:179: warning: cannot understand function prototype: 'struct pmic_arb_ver_ops '
>> drivers/spmi/spmi-pmic-arb.c:215: warning: No description found for parameter 'pmic_arb'
   drivers/spmi/spmi-pmic-arb.c:229: warning: No description found for parameter 'pmic_arb'


vim +/pmic_arb +215 drivers/spmi/spmi-pmic-arb.c

39ae93e3a31d0c Kenneth Heitke         2014-02-12  206  
39ae93e3a31d0c Kenneth Heitke         2014-02-12  207  /**
02abec3616c1b2 Kiran Gunda            2017-07-28  208   * pmic_arb_read_data: reads pmic-arb's register and copy 1..4 bytes to buf
39ae93e3a31d0c Kenneth Heitke         2014-02-12  209   * @bc:		byte count -1. range: 0..3
39ae93e3a31d0c Kenneth Heitke         2014-02-12  210   * @reg:	register's address
39ae93e3a31d0c Kenneth Heitke         2014-02-12  211   * @buf:	output parameter, length must be bc + 1
39ae93e3a31d0c Kenneth Heitke         2014-02-12  212   */
02abec3616c1b2 Kiran Gunda            2017-07-28  213  static void
02abec3616c1b2 Kiran Gunda            2017-07-28  214  pmic_arb_read_data(struct spmi_pmic_arb *pmic_arb, u8 *buf, u32 reg, u8 bc)
39ae93e3a31d0c Kenneth Heitke         2014-02-12 @215  {
02abec3616c1b2 Kiran Gunda            2017-07-28  216  	u32 data = __raw_readl(pmic_arb->rd_base + reg);
111a10bf3e53ae Abhijeet Dharmapurikar 2017-05-10  217  
39ae93e3a31d0c Kenneth Heitke         2014-02-12  218  	memcpy(buf, &data, (bc & 3) + 1);
39ae93e3a31d0c Kenneth Heitke         2014-02-12  219  }
39ae93e3a31d0c Kenneth Heitke         2014-02-12  220  

:::::: The code at line 215 was first introduced by commit
:::::: 39ae93e3a31d0c9ca99e35b754a9f3c6f1db2bee spmi: Add MSM PMIC Arbiter SPMI controller

:::::: TO: Kenneth Heitke <kheitke@codeaurora.org>
:::::: CC: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

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