block: add request clone interface (v2)
authorKiyoshi Ueda <k-ueda@ct.jp.nec.com>
Thu, 11 Jun 2009 11:10:16 +0000 (13:10 +0200)
committerJens Axboe <jens.axboe@oracle.com>
Thu, 11 Jun 2009 11:11:05 +0000 (13:11 +0200)
commitb0fd271d5fba0b2d00888363f3869e3f9b26caa9
tree0ffd49c013476e3dc96c8bcb2ddc4c1828797be5
parent5e50b9ef975219304cc91d601530994861585bfe
block: add request clone interface (v2)

This patch adds the following 2 interfaces for request-stacking drivers:

  - blk_rq_prep_clone(struct request *clone, struct request *orig,
      struct bio_set *bs, gfp_t gfp_mask,
      int (*bio_ctr)(struct bio *, struct bio*, void *),
      void *data)
      * Clones bios in the original request to the clone request
        (bio_ctr is called for each cloned bios.)
      * Copies attributes of the original request to the clone request.
        The actual data parts (e.g. ->cmd, ->buffer, ->sense) are not
        copied.

  - blk_rq_unprep_clone(struct request *clone)
      * Frees cloned bios from the clone request.

Request stacking drivers (e.g. request-based dm) need to make a clone
request for a submitted request and dispatch it to other devices.

To allocate request for the clone, request stacking drivers may not
be able to use blk_get_request() because the allocation may be done
in an irq-disabled context.
So blk_rq_prep_clone() takes a request allocated by the caller
as an argument.

For each clone bio in the clone request, request stacking drivers
should be able to set up their own completion handler.
So blk_rq_prep_clone() takes a callback function which is called
for each clone bio, and a pointer for private data which is passed
to the callback.

NOTE:
blk_rq_prep_clone() doesn't copy any actual data of the original
request.  Pages are shared between original bios and cloned bios.
So caller must not complete the original request before the clone
request.

Signed-off-by: Kiyoshi Ueda <k-ueda@ct.jp.nec.com>
Signed-off-by: Jun'ichi Nomura <j-nomura@ce.jp.nec.com>
Cc: Boaz Harrosh <bharrosh@panasas.com>
Signed-off-by: Jens Axboe <jens.axboe@oracle.com>
block/blk-core.c
include/linux/blkdev.h