Re: [PATCH v3 1/4] scsi: core: Add new helper to iterate all devices of host

[kernel test robot]

Hi Wenchao,

kernel test robot noticed the following build warnings:

[auto build test WARNING on mkp-scsi/for-next]
[also build test WARNING on jejb-scsi/for-next linus/master v6.6-rc6 next-20231017]
[If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch#_base_tree_information]

url:    https://github.com/intel-lab-lkp/linux/commits/Wenchao-Hao/scsi-core-Add-new-helper-to-iterate-all-devices-of-host/20231017-140049
base:   https://git.kernel.org/pub/scm/linux/kernel/git/mkp/scsi.git for-next
patch link:    https://lore.kernel.org/r/20231016020314.1269636-2-haowenchao2%40huawei.com
patch subject: [PATCH v3 1/4] scsi: core: Add new helper to iterate all devices of host
config: m68k-allyesconfig (https://download.01.org/0day-ci/archive/20231017/202310172345.jViTGPKD-lkp@xxxxxxxxx/config)
compiler: m68k-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231017/202310172345.jViTGPKD-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/202310172345.jViTGPKD-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/scsi/scsi.c:767: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * helper for shost_for_each_device, see that for documentation


vim +767 drivers/scsi/scsi.c

   765	
   766	/**
 > 767	 * helper for shost_for_each_device, see that for documentation
   768	 * @skip_deleted: if true, sdev in progress of removing would be skipped
   769	 */
   770	struct scsi_device *__scsi_iterate_devices(struct Scsi_Host *shost,
   771						   struct scsi_device *prev,
   772						   bool skip_deleted)
   773	{
   774		struct list_head *list = (prev ? &prev->siblings : &shost->__devices);
   775		struct scsi_device *next = NULL;
   776		unsigned long flags;
   777	
   778		spin_lock_irqsave(shost->host_lock, flags);
   779		while (list->next != &shost->__devices) {
   780			next = list_entry(list->next, struct scsi_device, siblings);
   781			/* skip devices that we can't get a reference to */
   782			if (!__scsi_device_get(next, skip_deleted))
   783				break;
   784			next = NULL;
   785			list = list->next;
   786		}
   787		spin_unlock_irqrestore(shost->host_lock, flags);
   788	
   789		if (prev)
   790			scsi_device_put(prev);
   791		return next;
   792	}
   793	EXPORT_SYMBOL(__scsi_iterate_devices);
   794	

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