Commit 0b116ff4 authored by Matthew Wilcox (Oracle)'s avatar Matthew Wilcox (Oracle) Committed by Andrew Morton
Browse files

buffer: improve bdev_getblk documentation 

Add some more information about the state of the buffer_head returned.

Link: https://lkml.kernel.org/r/20240416031754.4076917-8-willy@infradead.org


Signed-off-by: default avatarMatthew Wilcox (Oracle) <willy@infradead.org>
Cc: Pankaj Raghav <p.raghav@samsung.com>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent b73a936f

fs/buffer.c

+5 −0
Original line number Diff line number Diff line
@@ -1424,6 +1424,11 @@ EXPORT_SYMBOL(__find_get_block); 
 * @size: The size of buffer_heads for this @bdev.

 * @gfp: The memory allocation flags to use.

 *

 * The returned buffer head has its reference count incremented, but is

 * not locked.  The caller should call brelse() when it has finished

 * with the buffer.  The buffer may not be uptodate.  If needed, the

 * caller can bring it uptodate either by reading it or overwriting it.

 *

 * Return: The buffer head, or NULL if memory could not be allocated.

 */

struct buffer_head *bdev_getblk(struct block_device *bdev, sector_t block,