linux-kernel - drivers/hid/intel-ish-hid/ishtp/bus.c:853: warning: Function parameter or member 'dev' not described in 'ishtp_wait

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202311060843.dXENYlGc-lkp@intel.com>
Date:   Mon, 6 Nov 2023 08:35:58 +0800
From:   kernel test robot <lkp@...el.com>
To:     Ye Xiang <xiang.ye@...el.com>
Cc:     oe-kbuild-all@...ts.linux.dev, linux-kernel@...r.kernel.org,
        Jiri Kosina <jkosina@...e.cz>
Subject: drivers/hid/intel-ish-hid/ishtp/bus.c:853: warning: Function
 parameter or member 'dev' not described in 'ishtp_wait_resume'

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   77fa2fbe87fc605c4bfa87dff87be9bfded0e9a3
commit: e48bf29cf9d6d60d810e2af71e54b71a324094e0 HID: intel-ish-hid: use async resume function
date:   2 years, 4 months ago
config: x86_64-randconfig-004-20230909 (https://download.01.org/0day-ci/archive/20231106/202311060843.dXENYlGc-lkp@intel.com/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231106/202311060843.dXENYlGc-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@...el.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202311060843.dXENYlGc-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/hid/intel-ish-hid/ishtp/bus.c:853: warning: Function parameter or member 'dev' not described in 'ishtp_wait_resume'


vim +853 drivers/hid/intel-ish-hid/ishtp/bus.c

   844	
   845	/**
   846	 * ishtp_wait_resume() - Wait for IPC resume
   847	 *
   848	 * Wait for IPC resume
   849	 *
   850	 * Return: resume complete or not
   851	 */
   852	bool ishtp_wait_resume(struct ishtp_device *dev)
 > 853	{
   854		/* 50ms to get resume response */
   855		#define WAIT_FOR_RESUME_ACK_MS		50
   856	
   857		/* Waiting to get resume response */
   858		if (dev->resume_flag)
   859			wait_event_interruptible_timeout(dev->resume_wait,
   860							 !dev->resume_flag,
   861							 msecs_to_jiffies(WAIT_FOR_RESUME_ACK_MS));
   862	
   863		return (!dev->resume_flag);
   864	}
   865	EXPORT_SYMBOL_GPL(ishtp_wait_resume);
   866	

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