[yiliu1765-iommufd:wip/iommufd_pasid-20241203 11/27] drivers/iommu/iommufd/device.c:297: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[yiliu1765-iommufd:wip/iommufd_pasid-20241203 11/27] drivers/iommu/iommufd/device.c:297: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

tree:   https://github.com/yiliu1765/iommufd.git wip/iommufd_pasid-20241203
head:   09042d1f24b0dc9375b2357d36771b6997ef01cd
commit: 7f3cb770e52608fecf32524478384a883b8c3dcb [11/27] iommufd: Move the iommufd_handle helpers to device.c
config: i386-buildonly-randconfig-002-20241203 (https://download.01.org/0day-ci/archive/20241203/202412032044.MTRNSNMe-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/20241203/202412032044.MTRNSNMe-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/202412032044.MTRNSNMe-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/iommu/iommufd/device.c:297: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * This return the attach handle for the RID. Currently there is no


vim +297 drivers/iommu/iommufd/device.c

   295	
   296	/**
 > 297	 * This return the attach handle for the RID. Currently there is no
   298	 * locking to synchronize threads that access the returned handle
   299	 * with those attaching or replacing the domain which might change
   300	 * the handle. It's caller's duty to guarantee no use-after-free.
   301	 */
   302	struct iommufd_attach_handle *
   303	iommufd_device_get_attach_handle(struct iommufd_device *idev)
   304	{
   305		struct iommu_attach_handle *handle;
   306	
   307		handle = iommu_attach_handle_get(idev->igroup->group, IOMMU_NO_PASID, 0);
   308		if (IS_ERR(handle))
   309			return NULL;
   310	
   311		return to_iommufd_handle(handle);
   312	}
   313	

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