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: Andreas Gruenbacher <agruen@kernel.org>
Cc: Jens Axboe <axboe@kernel.dk>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Jens Axboe <jaxboe@fusionio.com>
This commit is contained in:
Andreas Gruenbacher 2011-05-28 14:44:46 +02:00 committed by Jens Axboe
parent 29a6ccca38
commit 6df87e65db

View File

@ -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)