Skip to content

Commit

Permalink
Merge branch 'for-5.14/block' into for-next
Browse files Browse the repository at this point in the history
* for-5.14/block:
  block: Update blk_update_request() documentation
  • Loading branch information
axboe committed Jun 3, 2021
2 parents f32f639 + 7cc2623 commit 808d854
Showing 1 changed file with 4 additions and 8 deletions.
12 changes: 4 additions & 8 deletions block/blk-core.c
Original file line number Diff line number Diff line change
Expand Up @@ -1384,26 +1384,22 @@ void blk_steal_bios(struct bio_list *list, struct request *rq)
EXPORT_SYMBOL_GPL(blk_steal_bios);

/**
* blk_update_request - Special helper function for request stacking drivers
* blk_update_request - Complete multiple bytes without completing the request
* @req: the request being processed
* @error: block status code
* @nr_bytes: number of bytes to complete @req
* @nr_bytes: number of bytes to complete for @req
*
* Description:
* Ends I/O on a number of bytes attached to @req, but doesn't complete
* the request structure even if @req doesn't have leftover.
* If @req has leftover, sets it up for the next range of segments.
*
* This special helper function is only for request stacking drivers
* (e.g. request-based dm) so that they can handle partial completion.
* Actual device drivers should use blk_mq_end_request instead.
*
* Passing the result of blk_rq_bytes() as @nr_bytes guarantees
* %false return from this function.
*
* Note:
* The RQF_SPECIAL_PAYLOAD flag is ignored on purpose in both
* blk_rq_bytes() and in blk_update_request().
* The RQF_SPECIAL_PAYLOAD flag is ignored on purpose in this function
* except in the consistency check at the end of this function.
*
* Return:
* %false - this request doesn't have any more data
Expand Down

0 comments on commit 808d854

Please sign in to comment.