[openeuler:OLK-6.6 3529/3529] fs/nfs/enfs/shard_route.c:273: warning: Function parameter or member '__struct_name' not described in 'DEFINE_CLEAR_LIST_FUNC'

[kernel test robot <lkp@intel.com>]

Hi ChenXiaoSong,

FYI, the error/warning still remains.

tree:   https://gitee.com/openeuler/kernel.git OLK-6.6
head:   d281438782e3c28a3df71a64513a3312d43dcf01
commit: 2d5981287b67cc1a5d9231bff267f90001251ba3 [3529/3529] nfs/enfs: introduce DEFINE_CLEAR_LIST_FUNC to define enfs_clear_fs_info()
config: x86_64-allyesconfig (https://download.01.org/0day-ci/archive/20251211/202512110548.FQDvrNPq-lkp@intel.com/config)
compiler: clang version 20.1.8 (https://github.com/llvm/llvm-project 87f0227cb60147a26a1eeb4fb06e3b505e9c7261)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20251211/202512110548.FQDvrNPq-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/202512110548.FQDvrNPq-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> fs/nfs/enfs/shard_route.c:273: warning: Function parameter or member '__struct_name' not described in 'DEFINE_CLEAR_LIST_FUNC'
>> fs/nfs/enfs/shard_route.c:273: warning: Function parameter or member '__list_name' not described in 'DEFINE_CLEAR_LIST_FUNC'
   fs/nfs/enfs/shard_route.c:273: warning: expecting prototype for enfs_clear_ ## __struct_name()(). Prototype was for DEFINE_CLEAR_LIST_FUNC() instead
   fs/nfs/enfs/shard_route.c:349: warning: Cannot understand  * @return:0 for success,otherwise for failed
    on line 349 - I thought it was a doc line


vim +273 fs/nfs/enfs/shard_route.c

   256	
   257	/**
   258	 * enfs_clear_ ## __struct_name() - delete and free all __struct_name from view_table
   259	 * @table: view table
   260	 *
   261	 * Context: protected by view_table write lock
   262	 * Return: None
   263	 */
   264	#define DEFINE_CLEAR_LIST_FUNC(__struct_name, __list_name)		\
   265	static void enfs_clear_ ## __struct_name(struct view_table *table)	\
   266	{									\
   267		struct __struct_name *item, *tmp;				\
   268										\
   269		list_for_each_entry_safe(item, tmp, &table->__list_name, next) {\
   270			list_del(&item->next);					\
   271			kfree(item);						\
   272		}								\
 > 273	}
   274	

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