[bcachefs:bcachefs-testing 331/338] fs/dcache.c:3223: warning: Function parameter or struct member 'dentry' not described in 'd_casefold_disabled_put'

[bcachefs:bcachefs-testing 331/338] fs/dcache.c:3223: warning: Function parameter or struct member 'dentry' not described in 'd_casefold_disabled_put'

[kernel test robot]

tree:   https://evilpiepirate.org/git/bcachefs.git bcachefs-testing
head:   ac9cb68e998c4a17159a05fb750fc7e9f3850c41
commit: 520ad9104545fd112f172076b4ed10797c1cc8da [331/338] fs: dcache exlusion between overlayfs, casefolding
config: x86_64-rhel-9.4-rust (https://download.01.org/0day-ci/archive/20250602/202506020428.aKtBuNbS-lkp@intel.com/config)
compiler: clang version 18.1.8 (https://github.com/llvm/llvm-project 3b5b5c1ec4a3095ab096dd780e84d7ab81f3d7ff)
rustc: rustc 1.78.0 (9b00956e5 2024-04-29)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250602/202506020428.aKtBuNbS-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/202506020428.aKtBuNbS-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> fs/dcache.c:3223: warning: Function parameter or struct member 'dentry' not described in 'd_casefold_disabled_put'
>> fs/dcache.c:3247: warning: Function parameter or struct member 'dentry' not described in 'd_casefold_disabled_get'


vim +3223 fs/dcache.c

  3216	
  3217	/**
  3218	 * d_casefold_disabled_put - drop a "casefold disabled" ref
  3219	 *
  3220	 * Only for overlayfs.
  3221	 */
  3222	void d_casefold_disabled_put(struct dentry *dentry)
> 3223	{
  3224		struct super_block *sb = dentry->d_sb;
  3225	
  3226		if (!(sb->s_flags & SB_CASEFOLD))
  3227			return;
  3228	
  3229		guard(mutex)(&sb->s_casefold_enable_lock);
  3230		no_casefold_dentry_put(dentry, ref_casefold_disable);
  3231	}
  3232	EXPORT_SYMBOL_GPL(d_casefold_disabled_put);
  3233	
  3234	/**
  3235	 * d_casefold_disabled_get - attempt to disable casefold on a tree
  3236	 *
  3237	 * Only for overlayfs.
  3238	 *
  3239	 * Returns -EINVAL if casefolding is in use on any subdirectory; this must be
  3240	 * tracked by the filesystem.
  3241	 *
  3242	 * On success, returns with a reference held that must be released by
  3243	 * d_casefold_disabled_put(); this ref blocks casefold from being enabled
  3244	 * by d_casefold_enable().
  3245	 */
  3246	int d_casefold_disabled_get(struct dentry *dentry)
> 3247	{
  3248		struct super_block *sb = dentry->d_sb;
  3249	
  3250		if (!(sb->s_flags & SB_CASEFOLD))
  3251			return 0;
  3252	
  3253		guard(mutex)(&sb->s_casefold_enable_lock);
  3254	
  3255		if (!(dentry->d_inode->i_flags & S_NO_CASEFOLD))
  3256			return -EINVAL;
  3257	
  3258		return no_casefold_dentry_get(dentry, ref_casefold_disable);
  3259	}
  3260	EXPORT_SYMBOL_GPL(d_casefold_disabled_get);
  3261	

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