[kdave:for-next 138/150] fs/btrfs/volumes.c:2334: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

* [kdave:for-next 138/150] fs/btrfs/volumes.c:2334: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
@ 2021-10-15  1:52 ` kernel test robot
  0 siblings, 0 replies; 2+ messages in thread
From: kernel test robot @ 2021-10-15  1:52 UTC (permalink / raw)
  To: Josef Bacik
  Cc: llvm, kbuild-all, linux-kernel, David Sterba, Nikolay Borisov,
	Anand Jain, linux-doc

[-- Attachment #1: Type: text/plain, Size: 3704 bytes --]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/kdave/linux.git for-next
head:   00c9626f46bece739cb413d1399ead6473809c54
commit: ea57e6e833a234ebe22efbb68e31c252f2478d15 [138/150] btrfs: add a btrfs_get_dev_args_from_path helper
config: hexagon-randconfig-r041-20211014 (attached as .config)
compiler: clang version 14.0.0 (https://github.com/llvm/llvm-project 6c76d0101193aa4eb891a6954ff047eda2f9cf71)
reproduce (this is a W=1 build):
        wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
        chmod +x ~/bin/make.cross
        # https://git.kernel.org/pub/scm/linux/kernel/git/kdave/linux.git/commit/?id=ea57e6e833a234ebe22efbb68e31c252f2478d15
        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 ea57e6e833a234ebe22efbb68e31c252f2478d15
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross W=1 ARCH=hexagon 

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/volumes.c:2334: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Populate args from device at path

vim +2334 fs/btrfs/volumes.c

  2332	
  2333	/**
> 2334	 * Populate args from device at path
  2335	 *
  2336	 * @fs_info:	the filesystem
  2337	 * @args:	the args to populate
  2338	 * @path:	the path to the device
  2339	 *
  2340	 * This will read the super block of the device at @path and populate @args with
  2341	 * the devid, fsid, and uuid.  This is meant to be used for ioctls that need to
  2342	 * lookup a device to operate on, but need to do it before we take any locks.
  2343	 * This properly handles the special case of "missing" that a user may pass in,
  2344	 * and does some basic sanity checks.  The caller must make sure that @path is
  2345	 * properly NUL terminated before calling in, and must call
  2346	 * btrfs_put_dev_args_from_path() in order to free up the temporary fsid and
  2347	 * uuid buffers.
  2348	 *
  2349	 * Return: 0 for success, -errno for failure
  2350	 */
  2351	int btrfs_get_dev_args_from_path(struct btrfs_fs_info *fs_info,
  2352					 struct btrfs_dev_lookup_args *args,
  2353					 const char *path)
  2354	{
  2355		struct btrfs_super_block *disk_super;
  2356		struct block_device *bdev;
  2357		int ret;
  2358	
  2359		if (!path || !path[0])
  2360			return -EINVAL;
  2361		if (!strcmp(path, "missing")) {
  2362			args->missing = true;
  2363			return 0;
  2364		}
  2365	
  2366		args->uuid = kzalloc(BTRFS_UUID_SIZE, GFP_KERNEL);
  2367		args->fsid = kzalloc(BTRFS_FSID_SIZE, GFP_KERNEL);
  2368		if (!args->uuid || !args->fsid) {
  2369			btrfs_put_dev_args_from_path(args);
  2370			return -ENOMEM;
  2371		}
  2372	
  2373		ret = btrfs_get_bdev_and_sb(path, FMODE_READ, fs_info->bdev_holder, 0,
  2374					    &bdev, &disk_super);
  2375		if (ret)
  2376			return ret;
  2377		args->devid = btrfs_stack_device_id(&disk_super->dev_item);
  2378		memcpy(args->uuid, disk_super->dev_item.uuid, BTRFS_UUID_SIZE);
  2379		if (btrfs_fs_incompat(fs_info, METADATA_UUID))
  2380			memcpy(args->fsid, disk_super->metadata_uuid, BTRFS_FSID_SIZE);
  2381		else
  2382			memcpy(args->fsid, disk_super->fsid, BTRFS_FSID_SIZE);
  2383		btrfs_release_disk_super(disk_super);
  2384		blkdev_put(bdev, FMODE_READ);
  2385		return 0;
  2386	}
  2387	

---
0-DAY CI Kernel Test Service, Intel Corporation
https://lists.01.org/hyperkitty/list/kbuild-all@lists.01.org

[-- Attachment #2: .config.gz --]
[-- Type: application/gzip, Size: 40598 bytes --]

^ permalink raw reply	[flat|nested] 2+ messages in thread