fs/freevxfs/vxfs_immed.c:67: warning: Function parameter or member 'fp' not described in 'vxfs_immed_read_folio'

From: kernel test robot
Date: Mon Dec 04 2023 - 14:41:58 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 33cc938e65a98f1d29d0a18403dbbee050dcad9a
commit: 42d7a524e9ee13f6ea8b1539a293a365db2ba2f5 freevxfs: Convert vxfs_immed to read_folio
date: 1 year, 7 months ago
config: x86_64-buildonly-randconfig-004-20231010 (https://download.01.org/0day-ci/archive/20231205/202312050334.bmiUtFL0-lkp@xxxxxxxxx/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/20231205/202312050334.bmiUtFL0-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/202312050334.bmiUtFL0-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> fs/freevxfs/vxfs_immed.c:67: warning: Function parameter or member 'fp' not described in 'vxfs_immed_read_folio'
>> fs/freevxfs/vxfs_immed.c:67: warning: Excess function parameter 'file' description in 'vxfs_immed_read_folio'


vim +67 fs/freevxfs/vxfs_immed.c

^1da177e4c3f41 Linus Torvalds 2005-04-16 49
^1da177e4c3f41 Linus Torvalds 2005-04-16 50 /**
42d7a524e9ee13 Matthew Wilcox (Oracle 2022-04-29 51) * vxfs_immed_read_folio - read part of an immed inode into pagecache
^1da177e4c3f41 Linus Torvalds 2005-04-16 52 * @file: file context (unused)
42d7a524e9ee13 Matthew Wilcox (Oracle 2022-04-29 53) * @folio: folio to fill in.
^1da177e4c3f41 Linus Torvalds 2005-04-16 54 *
^1da177e4c3f41 Linus Torvalds 2005-04-16 55 * Description:
42d7a524e9ee13 Matthew Wilcox (Oracle 2022-04-29 56) * vxfs_immed_read_folio reads a part of the immed area of the
^1da177e4c3f41 Linus Torvalds 2005-04-16 57 * file that hosts @pp into the pagecache.
^1da177e4c3f41 Linus Torvalds 2005-04-16 58 *
^1da177e4c3f41 Linus Torvalds 2005-04-16 59 * Returns:
^1da177e4c3f41 Linus Torvalds 2005-04-16 60 * Zero on success, else a negative error code.
^1da177e4c3f41 Linus Torvalds 2005-04-16 61 *
^1da177e4c3f41 Linus Torvalds 2005-04-16 62 * Locking status:
42d7a524e9ee13 Matthew Wilcox (Oracle 2022-04-29 63) * @folio is locked and will be unlocked.
^1da177e4c3f41 Linus Torvalds 2005-04-16 64 */
^1da177e4c3f41 Linus Torvalds 2005-04-16 65 static int
42d7a524e9ee13 Matthew Wilcox (Oracle 2022-04-29 66) vxfs_immed_read_folio(struct file *fp, struct folio *folio)
^1da177e4c3f41 Linus Torvalds 2005-04-16 @67 {

:::::: The code at line 67 was first introduced by commit
:::::: 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 Linux-2.6.12-rc2

:::::: TO: Linus Torvalds <torvalds@xxxxxxxxxxxxxxx>
:::::: CC: Linus Torvalds <torvalds@xxxxxxxxxxxxxxx>

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