123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313 |
- /*
- * Functions related to setting various queue properties from drivers
- */
- #include <linux/kernel.h>
- #include <linux/module.h>
- #include <linux/init.h>
- #include <linux/bio.h>
- #include <linux/blkdev.h>
- #include <linux/bootmem.h> /* for max_pfn/max_low_pfn */
- #include <linux/gcd.h>
- #include <linux/lcm.h>
- #include <linux/jiffies.h>
- #include <linux/gfp.h>
- #include "blk.h"
- unsigned long blk_max_low_pfn;
- EXPORT_SYMBOL(blk_max_low_pfn);
- unsigned long blk_max_pfn;
- /**
- * blk_queue_prep_rq - set a prepare_request function for queue
- * @q: queue
- * @pfn: prepare_request function
- *
- * It's possible for a queue to register a prepare_request callback which
- * is invoked before the request is handed to the request_fn. The goal of
- * the function is to prepare a request for I/O, it can be used to build a
- * cdb from the request data for instance.
- *
- */
- void blk_queue_prep_rq(struct request_queue *q, prep_rq_fn *pfn)
- {
- q->prep_rq_fn = pfn;
- }
- EXPORT_SYMBOL(blk_queue_prep_rq);
- /**
- * blk_queue_unprep_rq - set an unprepare_request function for queue
- * @q: queue
- * @ufn: unprepare_request function
- *
- * It's possible for a queue to register an unprepare_request callback
- * which is invoked before the request is finally completed. The goal
- * of the function is to deallocate any data that was allocated in the
- * prepare_request callback.
- *
- */
- void blk_queue_unprep_rq(struct request_queue *q, unprep_rq_fn *ufn)
- {
- q->unprep_rq_fn = ufn;
- }
- EXPORT_SYMBOL(blk_queue_unprep_rq);
- /**
- * blk_queue_merge_bvec - set a merge_bvec function for queue
- * @q: queue
- * @mbfn: merge_bvec_fn
- *
- * Usually queues have static limitations on the max sectors or segments that
- * we can put in a request. Stacking drivers may have some settings that
- * are dynamic, and thus we have to query the queue whether it is ok to
- * add a new bio_vec to a bio at a given offset or not. If the block device
- * has such limitations, it needs to register a merge_bvec_fn to control
- * the size of bio's sent to it. Note that a block device *must* allow a
- * single page to be added to an empty bio. The block device driver may want
- * to use the bio_split() function to deal with these bio's. By default
- * no merge_bvec_fn is defined for a queue, and only the fixed limits are
- * honored.
- */
- void blk_queue_merge_bvec(struct request_queue *q, merge_bvec_fn *mbfn)
- {
- q->merge_bvec_fn = mbfn;
- }
- EXPORT_SYMBOL(blk_queue_merge_bvec);
- void blk_queue_softirq_done(struct request_queue *q, softirq_done_fn *fn)
- {
- q->softirq_done_fn = fn;
- }
- EXPORT_SYMBOL(blk_queue_softirq_done);
- void blk_queue_rq_timeout(struct request_queue *q, unsigned int timeout)
- {
- q->rq_timeout = timeout;
- }
- EXPORT_SYMBOL_GPL(blk_queue_rq_timeout);
- void blk_queue_rq_timed_out(struct request_queue *q, rq_timed_out_fn *fn)
- {
- q->rq_timed_out_fn = fn;
- }
- EXPORT_SYMBOL_GPL(blk_queue_rq_timed_out);
- void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn)
- {
- q->lld_busy_fn = fn;
- }
- EXPORT_SYMBOL_GPL(blk_queue_lld_busy);
- /**
- * blk_set_default_limits - reset limits to default values
- * @lim: the queue_limits structure to reset
- *
- * Description:
- * Returns a queue_limit struct to its default state.
- */
- void blk_set_default_limits(struct queue_limits *lim)
- {
- lim->max_segments = BLK_MAX_SEGMENTS;
- lim->max_integrity_segments = 0;
- lim->seg_boundary_mask = BLK_SEG_BOUNDARY_MASK;
- lim->max_segment_size = BLK_MAX_SEGMENT_SIZE;
- lim->max_sectors = lim->max_hw_sectors = BLK_SAFE_MAX_SECTORS;
- lim->max_write_same_sectors = 0;
- lim->max_discard_sectors = 0;
- lim->discard_granularity = 0;
- lim->discard_alignment = 0;
- lim->discard_misaligned = 0;
- lim->discard_zeroes_data = 0;
- lim->logical_block_size = lim->physical_block_size = lim->io_min = 512;
- lim->bounce_pfn = (unsigned long)(BLK_BOUNCE_ANY >> PAGE_SHIFT);
- lim->alignment_offset = 0;
- lim->io_opt = 0;
- lim->misaligned = 0;
- lim->cluster = 1;
- }
- EXPORT_SYMBOL(blk_set_default_limits);
- /**
- * blk_set_stacking_limits - set default limits for stacking devices
- * @lim: the queue_limits structure to reset
- *
- * Description:
- * Returns a queue_limit struct to its default state. Should be used
- * by stacking drivers like DM that have no internal limits.
- */
- void blk_set_stacking_limits(struct queue_limits *lim)
- {
- blk_set_default_limits(lim);
- /* Inherit limits from component devices */
- lim->discard_zeroes_data = 1;
- lim->max_segments = USHRT_MAX;
- lim->max_hw_sectors = UINT_MAX;
- lim->max_sectors = UINT_MAX;
- lim->max_write_same_sectors = UINT_MAX;
- }
- EXPORT_SYMBOL(blk_set_stacking_limits);
- /**
- * blk_queue_make_request - define an alternate make_request function for a device
- * @q: the request queue for the device to be affected
- * @mfn: the alternate make_request function
- *
- * Description:
- * The normal way for &struct bios to be passed to a device
- * driver is for them to be collected into requests on a request
- * queue, and then to allow the device driver to select requests
- * off that queue when it is ready. This works well for many block
- * devices. However some block devices (typically virtual devices
- * such as md or lvm) do not benefit from the processing on the
- * request queue, and are served best by having the requests passed
- * directly to them. This can be achieved by providing a function
- * to blk_queue_make_request().
- *
- * Caveat:
- * The driver that does this *must* be able to deal appropriately
- * with buffers in "highmemory". This can be accomplished by either calling
- * __bio_kmap_atomic() to get a temporary kernel mapping, or by calling
- * blk_queue_bounce() to create a buffer in normal memory.
- **/
- void blk_queue_make_request(struct request_queue *q, make_request_fn *mfn)
- {
- /*
- * set defaults
- */
- q->nr_requests = BLKDEV_MAX_RQ;
- q->make_request_fn = mfn;
- blk_queue_dma_alignment(q, 511);
- blk_queue_congestion_threshold(q);
- q->nr_batching = BLK_BATCH_REQ;
- blk_set_default_limits(&q->limits);
- /*
- * by default assume old behaviour and bounce for any highmem page
- */
- blk_queue_bounce_limit(q, BLK_BOUNCE_HIGH);
- }
- EXPORT_SYMBOL(blk_queue_make_request);
- /**
- * blk_queue_bounce_limit - set bounce buffer limit for queue
- * @q: the request queue for the device
- * @dma_mask: the maximum address the device can handle
- *
- * Description:
- * Different hardware can have different requirements as to what pages
- * it can do I/O directly to. A low level driver can call
- * blk_queue_bounce_limit to have lower memory pages allocated as bounce
- * buffers for doing I/O to pages residing above @dma_mask.
- **/
- void blk_queue_bounce_limit(struct request_queue *q, u64 dma_mask)
- {
- unsigned long b_pfn = dma_mask >> PAGE_SHIFT;
- int dma = 0;
- q->bounce_gfp = GFP_NOIO;
- #if BITS_PER_LONG == 64
- /*
- * Assume anything <= 4GB can be handled by IOMMU. Actually
- * some IOMMUs can handle everything, but I don't know of a
- * way to test this here.
- */
- if (b_pfn < (min_t(u64, 0xffffffffUL, BLK_BOUNCE_HIGH) >> PAGE_SHIFT))
- dma = 1;
- q->limits.bounce_pfn = max(max_low_pfn, b_pfn);
- #else
- if (b_pfn < blk_max_low_pfn)
- dma = 1;
- q->limits.bounce_pfn = b_pfn;
- #endif
- if (dma) {
- init_emergency_isa_pool();
- q->bounce_gfp = GFP_NOIO | GFP_DMA;
- q->limits.bounce_pfn = b_pfn;
- }
- }
- EXPORT_SYMBOL(blk_queue_bounce_limit);
- /**
- * blk_limits_max_hw_sectors - set hard and soft limit of max sectors for request
- * @limits: the queue limits
- * @max_hw_sectors: max hardware sectors in the usual 512b unit
- *
- * Description:
- * Enables a low level driver to set a hard upper limit,
- * max_hw_sectors, on the size of requests. max_hw_sectors is set by
- * the device driver based upon the combined capabilities of I/O
- * controller and storage device.
- *
- * max_sectors is a soft limit imposed by the block layer for
- * filesystem type requests. This value can be overridden on a
- * per-device basis in /sys/block/<device>/queue/max_sectors_kb.
- * The soft limit can not exceed max_hw_sectors.
- **/
- void blk_limits_max_hw_sectors(struct queue_limits *limits, unsigned int max_hw_sectors)
- {
- if ((max_hw_sectors << 9) < PAGE_CACHE_SIZE) {
- max_hw_sectors = 1 << (PAGE_CACHE_SHIFT - 9);
- printk(KERN_INFO "%s: set to minimum %d\n",
- __func__, max_hw_sectors);
- }
- limits->max_hw_sectors = max_hw_sectors;
- limits->max_sectors = min_t(unsigned int, max_hw_sectors,
- BLK_DEF_MAX_SECTORS);
- }
- EXPORT_SYMBOL(blk_limits_max_hw_sectors);
- /**
- * blk_queue_max_hw_sectors - set max sectors for a request for this queue
- * @q: the request queue for the device
- * @max_hw_sectors: max hardware sectors in the usual 512b unit
- *
- * Description:
- * See description for blk_limits_max_hw_sectors().
- **/
- void blk_queue_max_hw_sectors(struct request_queue *q, unsigned int max_hw_sectors)
- {
- blk_limits_max_hw_sectors(&q->limits, max_hw_sectors);
- }
- EXPORT_SYMBOL(blk_queue_max_hw_sectors);
- /**
- * blk_queue_max_discard_sectors - set max sectors for a single discard
- * @q: the request queue for the device
- * @max_discard_sectors: maximum number of sectors to discard
- **/
- void blk_queue_max_discard_sectors(struct request_queue *q,
- unsigned int max_discard_sectors)
- {
- q->limits.max_discard_sectors = max_discard_sectors;
- }
- EXPORT_SYMBOL(blk_queue_max_discard_sectors);
- /**
- * blk_queue_max_write_same_sectors - set max sectors for a single write same
- * @q: the request queue for the device
- * @max_write_same_sectors: maximum number of sectors to write per command
- **/
- void blk_queue_max_write_same_sectors(struct request_queue *q,
- unsigned int max_write_same_sectors)
- {
- q->limits.max_write_same_sectors = max_write_same_sectors;
- }
- EXPORT_SYMBOL(blk_queue_max_write_same_sectors);
- /**
- * blk_queue_max_segments - set max hw segments for a request for this queue
- * @q: the request queue for the device
- * @max_segments: max number of segments
- *
- * Description:
- * Enables a low level driver to set an upper limit on the number of
- * hw data segments in a request.
- **/
- void blk_queue_max_segments(struct request_queue *q, unsigned short max_segments)
- {
- if (!max_segments) {
|