gfs2: Improve gfs2_block_map comment

Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Bob Peterson <rpeterso@redhat.com>
This commit is contained in:
Andreas Gruenbacher
2018-03-05 06:24:28 -07:00
committed by Bob Peterson
parent b9e03f1861
commit d39d18e0ef

View File

@ -812,15 +812,22 @@ do_alloc:
} }
/** /**
* gfs2_block_map - Map a block from an inode to a disk block * gfs2_block_map - Map one or more blocks of an inode to a disk block
* @inode: The inode * @inode: The inode
* @lblock: The logical block number * @lblock: The logical block number
* @bh_map: The bh to be mapped * @bh_map: The bh to be mapped
* @create: True if its ok to alloc blocks to satify the request * @create: True if its ok to alloc blocks to satify the request
* *
* Sets buffer_mapped() if successful, sets buffer_boundary() if a * The size of the requested mapping is defined in bh_map->b_size.
* read of metadata will be required before the next block can be *
* mapped. Sets buffer_new() if new blocks were allocated. * Clears buffer_mapped(bh_map) and leaves bh_map->b_size unchanged
* when @lblock is not mapped. Sets buffer_mapped(bh_map) and
* bh_map->b_size to indicate the size of the mapping when @lblock and
* successive blocks are mapped, up to the requested size.
*
* Sets buffer_boundary() if a read of metadata will be required
* before the next block can be mapped. Sets buffer_new() if new
* blocks were allocated.
* *
* Returns: errno * Returns: errno
*/ */