Commit 875b2376 authored Dec 28, 2020 by Randy Dunlap Committed by Jens Axboe Dec 29, 2020

fs: block_dev.c: fix kernel-doc warnings from struct block_device changes



Fix new kernel-doc warnings in fs/block_dev.c:

../fs/block_dev.c:1066: warning: Excess function parameter 'whole' description in 'bd_abort_claiming'
../fs/block_dev.c:1837: warning: Function parameter or member 'dev' not described in 'lookup_bdev'

Fixes: 4e7b5671 ("block: remove i_bdev")
Fixes: 37c3fc9a ("block: simplify the block device claiming interface")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jens Axboe <axboe@kernel.dk>
Cc: Christoph Hellwig <hch@lst.de>
Cc: linux-fsdevel@vger.kernel.org
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
Signed-off-by: Jens Axboe <axboe@kernel.dk>

parent 5c8fe583

fs/block_dev.c

+1 −1

Original line number	Diff line number	Diff line
		@@ -1055,7 +1055,6 @@ static void bd_finish_claiming(struct block_device bdev, void holder)
		/**
		* bd_abort_claiming - abort claiming of a block device
		* @bdev: block device of interest
		* @whole: whole block device
		* @holder: holder that has claimed @bdev
		*
		* Abort claiming of a block device when the exclusive open failed. This can be
		@@ -1828,6 +1827,7 @@ const struct file_operations def_blk_fops = {
		/**
		* lookup_bdev - lookup a struct block_device by name
		* @pathname: special file representing the block device
		* @dev: return value of the block device's dev_t
		*
		* Get a reference to the blockdevice at @pathname in the current
		* namespace if possible and return it. Return ERR_PTR(error)