Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 6df87e65 authored by Andreas Gruenbacher's avatar Andreas Gruenbacher Committed by Jens Axboe
Browse files

block: improve the bio_add_page() and bio_add_pc_page() descriptions 



The descriptions of bio_add_page() and bio_add_pc_page() are slightly
inconsistent; improve them.

Signed-off-by: default avatarAndreas Gruenbacher <agruen@kernel.org>
Cc: Jens Axboe <axboe@kernel.dk>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Signed-off-by: default avatarJens Axboe <jaxboe@fusionio.com>
parent 29a6ccca

fs/bio.c

+8 −8
Original line number Original line Diff line number Diff line
@@ -638,10 +638,11 @@ static int __bio_add_page(struct request_queue *q, struct bio *bio, struct page 
 *	@offset: vec entry offset

 *	@offset: vec entry offset

 *

 *

 *	Attempt to add a page to the bio_vec maplist. This can fail for a

 *	Attempt to add a page to the bio_vec maplist. This can fail for a

 *	number of reasons, such as the bio being full or target block

 *	number of reasons, such as the bio being full or target block device

 *	device limitations. The target block device must allow bio's

 *	limitations. The target block device must allow bio's up to PAGE_SIZE,

 *      smaller than PAGE_SIZE, so it is always possible to add a single

 *	so it is always possible to add a single page to an empty bio.

 *      page to an empty bio. This should only be used by REQ_PC bios.

 *

 *	This should only be used by REQ_PC bios.

 */

 */

int bio_add_pc_page(struct request_queue *q, struct bio *bio, struct page *page,

int bio_add_pc_page(struct request_queue *q, struct bio *bio, struct page *page,

		    unsigned int len, unsigned int offset)

		    unsigned int len, unsigned int offset)
@@ -659,10 +660,9 @@ EXPORT_SYMBOL(bio_add_pc_page); 
 *	@offset: vec entry offset

 *	@offset: vec entry offset

 *

 *

 *	Attempt to add a page to the bio_vec maplist. This can fail for a

 *	Attempt to add a page to the bio_vec maplist. This can fail for a

 *	number of reasons, such as the bio being full or target block

 *	number of reasons, such as the bio being full or target block device

 *	device limitations. The target block device must allow bio's

 *	limitations. The target block device must allow bio's up to PAGE_SIZE,

 *      smaller than PAGE_SIZE, so it is always possible to add a single

 *	so it is always possible to add a single page to an empty bio.

 *      page to an empty bio.

 */

 */

int bio_add_page(struct bio *bio, struct page *page, unsigned int len,

int bio_add_page(struct bio *bio, struct page *page, unsigned int len,

		 unsigned int offset)

		 unsigned int offset)