[openeuler:OLK-6.6 2229/2229] arch/x86/kvm/svm/csv.c:2037: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[openeuler:OLK-6.6 2229/2229] arch/x86/kvm/svm/csv.c:2037: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

tree:   https://gitee.com/openeuler/kernel.git OLK-6.6
head:   a53913bacac4876eee9ce118b3101dff842318ef
commit: c97c1d0165cc29f48725448620197d76e751d734 [2229/2229] KVM: SVM: CSV: Add ioctl API to unpin shared pages of CSV3 guest
config: x86_64-rhel-9.4-rust (https://download.01.org/0day-ci/archive/20250515/202505152346.3HOURWea-lkp@intel.com/config)
compiler: clang version 18.1.8 (https://github.com/llvm/llvm-project 3b5b5c1ec4a3095ab096dd780e84d7ab81f3d7ff)
rustc: rustc 1.73.0 (cc66ad468 2023-10-03)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250515/202505152346.3HOURWea-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/202505152346.3HOURWea-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> arch/x86/kvm/svm/csv.c:2037: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    *  Return negative error code on fail,


vim +2037 arch/x86/kvm/svm/csv.c

  2035	
  2036	/**
> 2037	 *  Return negative error code on fail,
  2038	 *  or return the number of pages unpinned successfully
  2039	 */
  2040	static int csv3_unpin_shared_memory(struct kvm *kvm, gpa_t gpa, u32 num_pages)
  2041	{
  2042		struct kvm_csv_info *csv;
  2043		struct shared_page *sp;
  2044		gfn_t gfn;
  2045		unsigned long i;
  2046		int unpin_cnt = 0;
  2047	
  2048		csv = &to_kvm_svm_csv(kvm)->csv_info;
  2049		gfn = gpa_to_gfn(gpa);
  2050	
  2051		mutex_lock(&csv->sp_lock);
  2052		for (i = 0; i < num_pages; i++, gfn++) {
  2053			sp = shared_page_remove(&csv->sp_mgr, gfn);
  2054			if (sp) {
  2055				unpin_user_page(sp->page);
  2056				kmem_cache_free(csv->sp_slab, sp);
  2057				csv->sp_mgr.count--;
  2058				unpin_cnt++;
  2059			}
  2060		}
  2061		mutex_unlock(&csv->sp_lock);
  2062	
  2063		return unpin_cnt;
  2064	}
  2065	

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