lkml.org 
[lkml]   [2022]   [Apr]   [8]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
Subject[kdave:for-next 112/127] fs/btrfs/raid56.c:1000: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
tree:   https://git.kernel.org/pub/scm/linux/kernel/git/kdave/linux.git for-next
head: cc4b66eaf7fbeab15e9c3dd2f2c12e41a1d741eb
commit: a32642fa6cda14b43626226169dc248ccdbdd63d [112/127] btrfs: raid56: make rbio_add_io_page() subpage compatible
config: x86_64-randconfig-a015 (https://download.01.org/0day-ci/archive/20220409/202204091154.PHMWy5ha-lkp@intel.com/config)
compiler: gcc-11 (Debian 11.2.0-19) 11.2.0
reproduce (this is a W=1 build):
# https://git.kernel.org/pub/scm/linux/kernel/git/kdave/linux.git/commit/?id=a32642fa6cda14b43626226169dc248ccdbdd63d
git remote add kdave https://git.kernel.org/pub/scm/linux/kernel/git/kdave/linux.git
git fetch --no-tags kdave for-next
git checkout a32642fa6cda14b43626226169dc248ccdbdd63d
# save the config file to linux build tree
mkdir build_dir
make W=1 O=build_dir ARCH=x86_64 SHELL=/bin/bash arch/x86/kvm/ fs/btrfs/

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@intel.com>

All warnings (new ones prefixed by >>):

>> fs/btrfs/raid56.c:1000: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Get a sector pointer specified by its @stripe_nr and @sector_nr


vim +1000 fs/btrfs/raid56.c

998
999 /**
> 1000 * Get a sector pointer specified by its @stripe_nr and @sector_nr
1001 *
1002 * @rbio: The raid bio
1003 * @stripe_nr: Stripe number, valid range [0, real_stripe)
1004 * @sector_nr: Sector number inside the stripe,
1005 * valid range [0, stripe_nsectors)
1006 * @bio_list_only: Whether to use sectors inside the bio list only.
1007 *
1008 * The read/modify/write code wants to reuse the original bio page as much
1009 * as possible, and only use stripe_sectors as fallback.
1010 */
1011 static struct sector_ptr *sector_in_rbio(struct btrfs_raid_bio *rbio,
1012 int stripe_nr, int sector_nr,
1013 bool bio_list_only)
1014 {
1015 struct sector_ptr *sector;
1016 int index;
1017
1018 ASSERT(stripe_nr >= 0 && stripe_nr < rbio->real_stripes);
1019 ASSERT(sector_nr >= 0 && sector_nr < rbio->stripe_nsectors);
1020
1021 index = stripe_nr * rbio->stripe_nsectors + sector_nr;
1022 ASSERT(index >= 0 && index < rbio->nr_sectors);
1023
1024 spin_lock_irq(&rbio->bio_list_lock);
1025 sector = &rbio->bio_sectors[index];
1026 if (sector->page || bio_list_only) {
1027 /* Don't return sector without a valid page pointer */
1028 if (!sector->page)
1029 sector = NULL;
1030 spin_unlock_irq(&rbio->bio_list_lock);
1031 return sector;
1032 }
1033 spin_unlock_irq(&rbio->bio_list_lock);
1034
1035 return &rbio->stripe_sectors[index];
1036 }
1037

--
0-DAY CI Kernel Test Service
https://01.org/lkp

\
 
 \ /
  Last update: 2022-04-09 05:30    [W:0.124 / U:0.968 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site