bdev: Improve lookup_bdev documentation

Add a Context section and rewrite the rest to be clearer.

Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Reviewed-by: Nikolay Borisov <nborisov@suse.com>
Link: https://lore.kernel.org/r/20211213171113.3097631-1-willy@infradead.org
Signed-off-by: Jens Axboe <axboe@kernel.dk>
This commit is contained in:
Matthew Wilcox (Oracle)
2021-12-13 17:11:13 +00:00
committed by Jens Axboe
parent 17f81f9d4b
commit 0ba4566cd8

View File

@@ -955,15 +955,15 @@ void blkdev_put(struct block_device *bdev, fmode_t mode)
EXPORT_SYMBOL(blkdev_put); EXPORT_SYMBOL(blkdev_put);
/** /**
* lookup_bdev - lookup a struct block_device by name * lookup_bdev() - Look up a struct block_device by name.
* @pathname: special file representing the block device * @pathname: Name of the block device in the filesystem.
* @dev: return value of the block device's dev_t * @dev: Pointer to the block device's dev_t, if found.
* *
* Lookup the block device's dev_t at @pathname in the current * Lookup the block device's dev_t at @pathname in the current
* namespace if possible and return it by @dev. * namespace if possible and return it in @dev.
* *
* RETURNS: * Context: May sleep.
* 0 if succeeded, errno otherwise. * Return: 0 if succeeded, negative errno otherwise.
*/ */
int lookup_bdev(const char *pathname, dev_t *dev) int lookup_bdev(const char *pathname, dev_t *dev)
{ {