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

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
...@@ -638,10 +638,11 @@ static int __bio_add_page(struct request_queue *q, struct bio *bio, struct page ...@@ -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); ...@@ -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)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment