Skip to contentSkip to conversation

block: fixup the kerneldoc for bd_abort_claiming

PATCH New Christoph Hellwig 1 participant 2 messages Dec 22, 2020

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/2 block: fixup the kerneldoc for bd_abort_claiming

Remove the documentation for a removed parameter.

Fixes 37c3fc9abb25 ("block: simplify the block device claiming interface")
---
 fs/block_dev.c | 1 -
 1 file changed, 1 deletion(-)
fs/block_dev.c +0 -1
index 9e56ee1f265230..7633e5ac0885f7 100644
@@ -1056,7 +1056,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
Signature · 1 line
2.29.2
#1 lore raw

PATCH 2/2 block: fixup the kerneldoc for lookup_bdev

Document the new dev parameter and the changed return value convention.

Fixes 4e7b5671c6a8 ("block: remove i_bdev")
---
 fs/block_dev.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
fs/block_dev.c +4 -3
index 7633e5ac0885f7..d6ee0bb7005538 100644
@@ -1828,10 +1828,11 @@ const struct file_operations def_blk_fops = {
 /**
  * lookup_bdev  - lookup a struct block_device by name
  * @pathname:	special file representing the block device
+ * @dev:	returns the dev_t for the device
  *
- * Get a reference to the blockdevice at @pathname in the current
- * namespace if possible and return it.  Return ERR_PTR(error)
- * otherwise.
+ * Find the dev_t for the block device at @pathname.  Returns 0 if there is a
+ * block device at @pathname, or a negative errno value if not.  The dev_t for
+ * the block device is placed in the variable pointed to by the @dev parameter.
  */
 int lookup_bdev(const char *pathname, dev_t *dev)
 {
Signature · 1 line
2.29.2