drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:279: warning: Function parameter or member 'rcfw' not described in '__poll_for_resp'

From: kernel test robot
Date: Thu Aug 17 2023 - 16:33:44 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 16931859a6500d360b90aeacab3b505a3560a3ed
commit: 354f5bd985af9515190828bc642ebdf59acea121 RDMA/bnxt_re: add helper function __poll_for_resp
date: 10 weeks ago
config: sparc-allyesconfig (https://download.01.org/0day-ci/archive/20230818/202308180401.iaj2ktTc-lkp@xxxxxxxxx/config)
compiler: sparc64-linux-gcc (GCC) 12.3.0
reproduce: (https://download.01.org/0day-ci/archive/20230818/202308180401.iaj2ktTc-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/202308180401.iaj2ktTc-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:73: warning: Function parameter or member 'opcode' not described in 'bnxt_qplib_map_rc'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:105: warning: Function parameter or member 'rcfw' not described in '__wait_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:105: warning: Function parameter or member 'cookie' not described in '__wait_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:105: warning: Function parameter or member 'opcode' not described in '__wait_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:147: warning: Function parameter or member 'rcfw' not described in '__block_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:147: warning: Function parameter or member 'cookie' not described in '__block_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:147: warning: Function parameter or member 'opcode' not described in '__block_for_resp'
>> drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:279: warning: Function parameter or member 'rcfw' not described in '__poll_for_resp'
>> drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:279: warning: Function parameter or member 'cookie' not described in '__poll_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:279: warning: Function parameter or member 'opcode' not described in '__poll_for_resp'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:348: warning: Function parameter or member 'rcfw' not described in '__bnxt_qplib_rcfw_send_message'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:348: warning: Function parameter or member 'msg' not described in '__bnxt_qplib_rcfw_send_message'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:418: warning: Function parameter or member 'rcfw' not described in 'bnxt_qplib_rcfw_send_message'
drivers/infiniband/hw/bnxt_re/qplib_rcfw.c:418: warning: Function parameter or member 'msg' not described in 'bnxt_qplib_rcfw_send_message'


vim +279 drivers/infiniband/hw/bnxt_re/qplib_rcfw.c

262
263 /**
264 * __poll_for_resp - self poll completion for rcfw command
265 * @rcfw - rcfw channel instance of rdev
266 * @cookie - cookie to track the command
267 * @opcode - rcfw submitted for given opcode
268 *
269 * It works same as __wait_for_resp except this function will
270 * do self polling in sort interval since interrupt is disabled.
271 * This function can not be called from non-sleepable context.
272 *
273 * Returns:
274 * -ETIMEOUT if command is not completed in specific time interval.
275 * 0 if command is completed by firmware.
276 */
277 static int __poll_for_resp(struct bnxt_qplib_rcfw *rcfw, u16 cookie,
278 u8 opcode)
> 279 {
280 struct bnxt_qplib_cmdq_ctx *cmdq = &rcfw->cmdq;
281 unsigned long issue_time;
282 u16 cbit;
283
284 cbit = cookie % rcfw->cmdq_depth;
285 issue_time = jiffies;
286
287 do {
288 if (test_bit(ERR_DEVICE_DETACHED, &cmdq->flags))
289 return bnxt_qplib_map_rc(opcode);
290
291 usleep_range(1000, 1001);
292
293 bnxt_qplib_service_creq(&rcfw->creq.creq_tasklet);
294 if (!test_bit(cbit, cmdq->cmdq_bitmap))
295 return 0;
296 if (jiffies_to_msecs(jiffies - issue_time) > 10000)
297 return -ETIMEDOUT;
298 } while (true);
299 };
300

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