blob: 6ccceb421ed2f7503b96c5e9cf58633400510d3f [file] [log] [blame]
Christoph Hellwig3dcf60bc2019-04-30 14:42:43 -04001// SPDX-License-Identifier: GPL-2.0
Jens Axboe86db1e22008-01-29 14:53:40 +01002/*
3 * Functions related to setting various queue properties from drivers
4 */
5#include <linux/kernel.h>
6#include <linux/module.h>
7#include <linux/init.h>
8#include <linux/bio.h>
9#include <linux/blkdev.h>
Matthew Wilcox (Oracle)4ee60ec2021-05-06 18:02:27 -070010#include <linux/pagemap.h>
Christoph Hellwigedb08722021-08-09 16:17:43 +020011#include <linux/backing-dev-defs.h>
Martin K. Petersen70dd5bf2009-07-31 11:49:12 -040012#include <linux/gcd.h>
Martin K. Petersen2cda2722010-03-15 12:46:51 +010013#include <linux/lcm.h>
Randy Dunlapad5ebd22009-11-11 13:47:45 +010014#include <linux/jiffies.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090015#include <linux/gfp.h>
Yoshihiro Shimoda45147fb2019-08-28 21:35:42 +090016#include <linux/dma-mapping.h>
Jens Axboe86db1e22008-01-29 14:53:40 +010017
18#include "blk.h"
Jens Axboe87760e52016-11-09 12:38:14 -070019#include "blk-wbt.h"
Jens Axboe86db1e22008-01-29 14:53:40 +010020
Jens Axboe242f9dc2008-09-14 05:55:09 -070021void blk_queue_rq_timeout(struct request_queue *q, unsigned int timeout)
22{
23 q->rq_timeout = timeout;
24}
25EXPORT_SYMBOL_GPL(blk_queue_rq_timeout);
26
Jens Axboe86db1e22008-01-29 14:53:40 +010027/**
Martin K. Petersene475bba2009-06-16 08:23:52 +020028 * blk_set_default_limits - reset limits to default values
Randy Dunlapf740f5ca2009-06-19 09:18:32 +020029 * @lim: the queue_limits structure to reset
Martin K. Petersene475bba2009-06-16 08:23:52 +020030 *
31 * Description:
Martin K. Petersenb1bd0552012-01-11 16:27:11 +010032 * Returns a queue_limit struct to its default state.
Martin K. Petersene475bba2009-06-16 08:23:52 +020033 */
34void blk_set_default_limits(struct queue_limits *lim)
35{
Martin K. Petersen8a783622010-02-26 00:20:39 -050036 lim->max_segments = BLK_MAX_SEGMENTS;
Christoph Hellwig1e739732017-02-08 14:46:49 +010037 lim->max_discard_segments = 1;
Martin K. Petersen13f05c82010-09-10 20:50:10 +020038 lim->max_integrity_segments = 0;
Martin K. Petersene475bba2009-06-16 08:23:52 +020039 lim->seg_boundary_mask = BLK_SEG_BOUNDARY_MASK;
Keith Busch03100aa2015-08-19 14:24:05 -070040 lim->virt_boundary_mask = 0;
Martin K. Peterseneb28d312010-02-26 00:20:37 -050041 lim->max_segment_size = BLK_MAX_SEGMENT_SIZE;
Keith Busch5f009d32016-02-10 16:52:47 -070042 lim->max_sectors = lim->max_hw_sectors = BLK_SAFE_MAX_SECTORS;
43 lim->max_dev_sectors = 0;
Jens Axboe762380a2014-06-05 13:38:39 -060044 lim->chunk_sectors = 0;
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -080045 lim->max_write_zeroes_sectors = 0;
Keith Busch0512a752020-05-12 17:55:47 +090046 lim->max_zone_append_sectors = 0;
Martin K. Petersen86b37282009-11-10 11:50:21 +010047 lim->max_discard_sectors = 0;
Jens Axboe0034af02015-07-16 09:14:26 -060048 lim->max_hw_discard_sectors = 0;
Christoph Hellwig44abff2c2022-04-15 06:52:57 +020049 lim->max_secure_erase_sectors = 0;
Martin K. Petersen86b37282009-11-10 11:50:21 +010050 lim->discard_granularity = 0;
51 lim->discard_alignment = 0;
52 lim->discard_misaligned = 0;
Martin K. Petersene475bba2009-06-16 08:23:52 +020053 lim->logical_block_size = lim->physical_block_size = lim->io_min = 512;
Christoph Hellwig9bb33f22021-03-31 09:30:00 +020054 lim->bounce = BLK_BOUNCE_NONE;
Martin K. Petersene475bba2009-06-16 08:23:52 +020055 lim->alignment_offset = 0;
56 lim->io_opt = 0;
57 lim->misaligned = 0;
Damien Le Moal797476b2016-10-18 15:40:29 +090058 lim->zoned = BLK_ZONED_NONE;
Damien Le Moala805a4f2021-01-28 13:47:30 +090059 lim->zone_write_granularity = 0;
Martin K. Petersene475bba2009-06-16 08:23:52 +020060}
61EXPORT_SYMBOL(blk_set_default_limits);
62
63/**
Martin K. Petersenb1bd0552012-01-11 16:27:11 +010064 * blk_set_stacking_limits - set default limits for stacking devices
65 * @lim: the queue_limits structure to reset
66 *
67 * Description:
68 * Returns a queue_limit struct to its default state. Should be used
69 * by stacking drivers like DM that have no internal limits.
70 */
71void blk_set_stacking_limits(struct queue_limits *lim)
72{
73 blk_set_default_limits(lim);
74
75 /* Inherit limits from component devices */
Martin K. Petersenb1bd0552012-01-11 16:27:11 +010076 lim->max_segments = USHRT_MAX;
Mike Snitzer42c9cdf2018-07-20 14:57:38 -040077 lim->max_discard_segments = USHRT_MAX;
Martin K. Petersenb1bd0552012-01-11 16:27:11 +010078 lim->max_hw_sectors = UINT_MAX;
Mike Snitzerd82ae522013-10-18 09:44:49 -060079 lim->max_segment_size = UINT_MAX;
Mike Snitzerfe86cdc2012-08-01 10:44:28 +020080 lim->max_sectors = UINT_MAX;
Martin K. Petersenca369d52015-11-13 16:46:48 -050081 lim->max_dev_sectors = UINT_MAX;
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -080082 lim->max_write_zeroes_sectors = UINT_MAX;
Keith Busch0512a752020-05-12 17:55:47 +090083 lim->max_zone_append_sectors = UINT_MAX;
Martin K. Petersenb1bd0552012-01-11 16:27:11 +010084}
85EXPORT_SYMBOL(blk_set_stacking_limits);
86
87/**
Jens Axboe86db1e22008-01-29 14:53:40 +010088 * blk_queue_bounce_limit - set bounce buffer limit for queue
Tejun Heocd0aca22009-04-15 22:10:25 +090089 * @q: the request queue for the device
Christoph Hellwig9bb33f22021-03-31 09:30:00 +020090 * @bounce: bounce limit to enforce
Jens Axboe86db1e22008-01-29 14:53:40 +010091 *
92 * Description:
Christoph Hellwig9bb33f22021-03-31 09:30:00 +020093 * Force bouncing for ISA DMA ranges or highmem.
94 *
95 * DEPRECATED, don't use in new code.
Jens Axboe86db1e22008-01-29 14:53:40 +010096 **/
Christoph Hellwig9bb33f22021-03-31 09:30:00 +020097void blk_queue_bounce_limit(struct request_queue *q, enum blk_bounce bounce)
Jens Axboe86db1e22008-01-29 14:53:40 +010098{
Christoph Hellwig9bb33f22021-03-31 09:30:00 +020099 q->limits.bounce = bounce;
Jens Axboe86db1e22008-01-29 14:53:40 +0100100}
Jens Axboe86db1e22008-01-29 14:53:40 +0100101EXPORT_SYMBOL(blk_queue_bounce_limit);
102
103/**
Martin K. Petersenca369d52015-11-13 16:46:48 -0500104 * blk_queue_max_hw_sectors - set max sectors for a request for this queue
105 * @q: the request queue for the device
Martin K. Petersen2800aac2010-02-26 00:20:35 -0500106 * @max_hw_sectors: max hardware sectors in the usual 512b unit
Jens Axboe86db1e22008-01-29 14:53:40 +0100107 *
108 * Description:
Martin K. Petersen2800aac2010-02-26 00:20:35 -0500109 * Enables a low level driver to set a hard upper limit,
110 * max_hw_sectors, on the size of requests. max_hw_sectors is set by
Martin K. Petersen4f258a42015-06-23 12:13:59 -0400111 * the device driver based upon the capabilities of the I/O
112 * controller.
Martin K. Petersen2800aac2010-02-26 00:20:35 -0500113 *
Martin K. Petersenca369d52015-11-13 16:46:48 -0500114 * max_dev_sectors is a hard limit imposed by the storage device for
115 * READ/WRITE requests. It is set by the disk driver.
116 *
Martin K. Petersen2800aac2010-02-26 00:20:35 -0500117 * max_sectors is a soft limit imposed by the block layer for
118 * filesystem type requests. This value can be overridden on a
119 * per-device basis in /sys/block/<device>/queue/max_sectors_kb.
120 * The soft limit can not exceed max_hw_sectors.
Jens Axboe86db1e22008-01-29 14:53:40 +0100121 **/
Martin K. Petersenca369d52015-11-13 16:46:48 -0500122void blk_queue_max_hw_sectors(struct request_queue *q, unsigned int max_hw_sectors)
Jens Axboe86db1e22008-01-29 14:53:40 +0100123{
Martin K. Petersenca369d52015-11-13 16:46:48 -0500124 struct queue_limits *limits = &q->limits;
125 unsigned int max_sectors;
126
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300127 if ((max_hw_sectors << 9) < PAGE_SIZE) {
128 max_hw_sectors = 1 << (PAGE_SHIFT - 9);
Harvey Harrison24c03d42008-05-01 04:35:17 -0700129 printk(KERN_INFO "%s: set to minimum %d\n",
Martin K. Petersen2800aac2010-02-26 00:20:35 -0500130 __func__, max_hw_sectors);
Jens Axboe86db1e22008-01-29 14:53:40 +0100131 }
132
Damien Le Moal817046e2020-11-20 10:55:13 +0900133 max_hw_sectors = round_down(max_hw_sectors,
134 limits->logical_block_size >> SECTOR_SHIFT);
Jeff Moyer30e2bc02015-08-13 14:57:56 -0400135 limits->max_hw_sectors = max_hw_sectors;
Damien Le Moal817046e2020-11-20 10:55:13 +0900136
Martin K. Petersenca369d52015-11-13 16:46:48 -0500137 max_sectors = min_not_zero(max_hw_sectors, limits->max_dev_sectors);
138 max_sectors = min_t(unsigned int, max_sectors, BLK_DEF_MAX_SECTORS);
Damien Le Moal817046e2020-11-20 10:55:13 +0900139 max_sectors = round_down(max_sectors,
140 limits->logical_block_size >> SECTOR_SHIFT);
Martin K. Petersenca369d52015-11-13 16:46:48 -0500141 limits->max_sectors = max_sectors;
Damien Le Moal817046e2020-11-20 10:55:13 +0900142
Christoph Hellwigd152c682021-08-16 15:46:24 +0200143 if (!q->disk)
Christoph Hellwigedb08722021-08-09 16:17:43 +0200144 return;
Christoph Hellwigd152c682021-08-16 15:46:24 +0200145 q->disk->bdi->io_pages = max_sectors >> (PAGE_SHIFT - 9);
Jens Axboe86db1e22008-01-29 14:53:40 +0100146}
Martin K. Petersen086fa5f2010-02-26 00:20:38 -0500147EXPORT_SYMBOL(blk_queue_max_hw_sectors);
Jens Axboe86db1e22008-01-29 14:53:40 +0100148
149/**
Jens Axboe762380a2014-06-05 13:38:39 -0600150 * blk_queue_chunk_sectors - set size of the chunk for this queue
151 * @q: the request queue for the device
152 * @chunk_sectors: chunk sectors in the usual 512b unit
153 *
154 * Description:
155 * If a driver doesn't want IOs to cross a given chunk size, it can set
Mike Snitzer07d098e2020-09-21 22:32:49 -0400156 * this limit and prevent merging across chunks. Note that the block layer
157 * must accept a page worth of data at any offset. So if the crossing of
158 * chunks is a hard limitation in the driver, it must still be prepared
159 * to split single page bios.
Jens Axboe762380a2014-06-05 13:38:39 -0600160 **/
161void blk_queue_chunk_sectors(struct request_queue *q, unsigned int chunk_sectors)
162{
Jens Axboe762380a2014-06-05 13:38:39 -0600163 q->limits.chunk_sectors = chunk_sectors;
164}
165EXPORT_SYMBOL(blk_queue_chunk_sectors);
166
167/**
Christoph Hellwig67efc922009-09-30 13:54:20 +0200168 * blk_queue_max_discard_sectors - set max sectors for a single discard
169 * @q: the request queue for the device
Randy Dunlapc7ebf062009-10-12 08:20:47 +0200170 * @max_discard_sectors: maximum number of sectors to discard
Christoph Hellwig67efc922009-09-30 13:54:20 +0200171 **/
172void blk_queue_max_discard_sectors(struct request_queue *q,
173 unsigned int max_discard_sectors)
174{
Jens Axboe0034af02015-07-16 09:14:26 -0600175 q->limits.max_hw_discard_sectors = max_discard_sectors;
Christoph Hellwig67efc922009-09-30 13:54:20 +0200176 q->limits.max_discard_sectors = max_discard_sectors;
177}
178EXPORT_SYMBOL(blk_queue_max_discard_sectors);
179
180/**
Christoph Hellwig44abff2c2022-04-15 06:52:57 +0200181 * blk_queue_max_secure_erase_sectors - set max sectors for a secure erase
182 * @q: the request queue for the device
183 * @max_sectors: maximum number of sectors to secure_erase
184 **/
185void blk_queue_max_secure_erase_sectors(struct request_queue *q,
186 unsigned int max_sectors)
187{
188 q->limits.max_secure_erase_sectors = max_sectors;
189}
190EXPORT_SYMBOL(blk_queue_max_secure_erase_sectors);
191
192/**
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800193 * blk_queue_max_write_zeroes_sectors - set max sectors for a single
194 * write zeroes
195 * @q: the request queue for the device
196 * @max_write_zeroes_sectors: maximum number of sectors to write per command
197 **/
198void blk_queue_max_write_zeroes_sectors(struct request_queue *q,
199 unsigned int max_write_zeroes_sectors)
200{
201 q->limits.max_write_zeroes_sectors = max_write_zeroes_sectors;
202}
203EXPORT_SYMBOL(blk_queue_max_write_zeroes_sectors);
204
205/**
Keith Busch0512a752020-05-12 17:55:47 +0900206 * blk_queue_max_zone_append_sectors - set max sectors for a single zone append
207 * @q: the request queue for the device
208 * @max_zone_append_sectors: maximum number of sectors to write per command
209 **/
210void blk_queue_max_zone_append_sectors(struct request_queue *q,
211 unsigned int max_zone_append_sectors)
212{
213 unsigned int max_sectors;
214
215 if (WARN_ON(!blk_queue_is_zoned(q)))
216 return;
217
218 max_sectors = min(q->limits.max_hw_sectors, max_zone_append_sectors);
219 max_sectors = min(q->limits.chunk_sectors, max_sectors);
220
221 /*
222 * Signal eventual driver bugs resulting in the max_zone_append sectors limit
223 * being 0 due to a 0 argument, the chunk_sectors limit (zone size) not set,
224 * or the max_hw_sectors limit not set.
225 */
226 WARN_ON(!max_sectors);
227
228 q->limits.max_zone_append_sectors = max_sectors;
229}
230EXPORT_SYMBOL_GPL(blk_queue_max_zone_append_sectors);
231
232/**
Martin K. Petersen8a783622010-02-26 00:20:39 -0500233 * blk_queue_max_segments - set max hw segments for a request for this queue
Jens Axboe86db1e22008-01-29 14:53:40 +0100234 * @q: the request queue for the device
235 * @max_segments: max number of segments
236 *
237 * Description:
238 * Enables a low level driver to set an upper limit on the number of
Martin K. Petersen8a783622010-02-26 00:20:39 -0500239 * hw data segments in a request.
Jens Axboe86db1e22008-01-29 14:53:40 +0100240 **/
Martin K. Petersen8a783622010-02-26 00:20:39 -0500241void blk_queue_max_segments(struct request_queue *q, unsigned short max_segments)
Jens Axboe86db1e22008-01-29 14:53:40 +0100242{
243 if (!max_segments) {
244 max_segments = 1;
Harvey Harrison24c03d42008-05-01 04:35:17 -0700245 printk(KERN_INFO "%s: set to minimum %d\n",
246 __func__, max_segments);
Jens Axboe86db1e22008-01-29 14:53:40 +0100247 }
248
Martin K. Petersen8a783622010-02-26 00:20:39 -0500249 q->limits.max_segments = max_segments;
Jens Axboe86db1e22008-01-29 14:53:40 +0100250}
Martin K. Petersen8a783622010-02-26 00:20:39 -0500251EXPORT_SYMBOL(blk_queue_max_segments);
Jens Axboe86db1e22008-01-29 14:53:40 +0100252
253/**
Christoph Hellwig1e739732017-02-08 14:46:49 +0100254 * blk_queue_max_discard_segments - set max segments for discard requests
255 * @q: the request queue for the device
256 * @max_segments: max number of segments
257 *
258 * Description:
259 * Enables a low level driver to set an upper limit on the number of
260 * segments in a discard request.
261 **/
262void blk_queue_max_discard_segments(struct request_queue *q,
263 unsigned short max_segments)
264{
265 q->limits.max_discard_segments = max_segments;
266}
267EXPORT_SYMBOL_GPL(blk_queue_max_discard_segments);
268
269/**
Jens Axboe86db1e22008-01-29 14:53:40 +0100270 * blk_queue_max_segment_size - set max segment size for blk_rq_map_sg
271 * @q: the request queue for the device
272 * @max_size: max size of segment in bytes
273 *
274 * Description:
275 * Enables a low level driver to set an upper limit on the size of a
276 * coalesced segment
277 **/
278void blk_queue_max_segment_size(struct request_queue *q, unsigned int max_size)
279{
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300280 if (max_size < PAGE_SIZE) {
281 max_size = PAGE_SIZE;
Harvey Harrison24c03d42008-05-01 04:35:17 -0700282 printk(KERN_INFO "%s: set to minimum %d\n",
283 __func__, max_size);
Jens Axboe86db1e22008-01-29 14:53:40 +0100284 }
285
Christoph Hellwig09324d32019-05-21 09:01:41 +0200286 /* see blk_queue_virt_boundary() for the explanation */
287 WARN_ON_ONCE(q->limits.virt_boundary_mask);
288
Martin K. Petersen025146e2009-05-22 17:17:51 -0400289 q->limits.max_segment_size = max_size;
Jens Axboe86db1e22008-01-29 14:53:40 +0100290}
Jens Axboe86db1e22008-01-29 14:53:40 +0100291EXPORT_SYMBOL(blk_queue_max_segment_size);
292
293/**
Martin K. Petersene1defc42009-05-22 17:17:49 -0400294 * blk_queue_logical_block_size - set logical block size for the queue
Jens Axboe86db1e22008-01-29 14:53:40 +0100295 * @q: the request queue for the device
Martin K. Petersene1defc42009-05-22 17:17:49 -0400296 * @size: the logical block size, in bytes
Jens Axboe86db1e22008-01-29 14:53:40 +0100297 *
298 * Description:
Martin K. Petersene1defc42009-05-22 17:17:49 -0400299 * This should be set to the lowest possible block size that the
300 * storage device can address. The default of 512 covers most
301 * hardware.
Jens Axboe86db1e22008-01-29 14:53:40 +0100302 **/
Mikulas Patockaad6bf882020-01-15 08:35:25 -0500303void blk_queue_logical_block_size(struct request_queue *q, unsigned int size)
Jens Axboe86db1e22008-01-29 14:53:40 +0100304{
Damien Le Moal817046e2020-11-20 10:55:13 +0900305 struct queue_limits *limits = &q->limits;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400306
Damien Le Moal817046e2020-11-20 10:55:13 +0900307 limits->logical_block_size = size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400308
Damien Le Moal817046e2020-11-20 10:55:13 +0900309 if (limits->physical_block_size < size)
310 limits->physical_block_size = size;
311
312 if (limits->io_min < limits->physical_block_size)
313 limits->io_min = limits->physical_block_size;
314
315 limits->max_hw_sectors =
316 round_down(limits->max_hw_sectors, size >> SECTOR_SHIFT);
317 limits->max_sectors =
318 round_down(limits->max_sectors, size >> SECTOR_SHIFT);
Jens Axboe86db1e22008-01-29 14:53:40 +0100319}
Martin K. Petersene1defc42009-05-22 17:17:49 -0400320EXPORT_SYMBOL(blk_queue_logical_block_size);
Jens Axboe86db1e22008-01-29 14:53:40 +0100321
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400322/**
323 * blk_queue_physical_block_size - set physical block size for the queue
324 * @q: the request queue for the device
325 * @size: the physical block size, in bytes
326 *
327 * Description:
328 * This should be set to the lowest possible sector size that the
329 * hardware can operate on without reverting to read-modify-write
330 * operations.
331 */
Martin K. Petersen892b6f92010-10-13 21:18:03 +0200332void blk_queue_physical_block_size(struct request_queue *q, unsigned int size)
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400333{
334 q->limits.physical_block_size = size;
335
336 if (q->limits.physical_block_size < q->limits.logical_block_size)
337 q->limits.physical_block_size = q->limits.logical_block_size;
338
339 if (q->limits.io_min < q->limits.physical_block_size)
340 q->limits.io_min = q->limits.physical_block_size;
341}
342EXPORT_SYMBOL(blk_queue_physical_block_size);
343
344/**
Damien Le Moala805a4f2021-01-28 13:47:30 +0900345 * blk_queue_zone_write_granularity - set zone write granularity for the queue
346 * @q: the request queue for the zoned device
347 * @size: the zone write granularity size, in bytes
348 *
349 * Description:
350 * This should be set to the lowest possible size allowing to write in
351 * sequential zones of a zoned block device.
352 */
353void blk_queue_zone_write_granularity(struct request_queue *q,
354 unsigned int size)
355{
356 if (WARN_ON_ONCE(!blk_queue_is_zoned(q)))
357 return;
358
359 q->limits.zone_write_granularity = size;
360
361 if (q->limits.zone_write_granularity < q->limits.logical_block_size)
362 q->limits.zone_write_granularity = q->limits.logical_block_size;
363}
364EXPORT_SYMBOL_GPL(blk_queue_zone_write_granularity);
365
366/**
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400367 * blk_queue_alignment_offset - set physical block alignment offset
368 * @q: the request queue for the device
Randy Dunlap8ebf9752009-06-11 20:00:41 -0700369 * @offset: alignment offset in bytes
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400370 *
371 * Description:
372 * Some devices are naturally misaligned to compensate for things like
373 * the legacy DOS partition table 63-sector offset. Low-level drivers
374 * should call this function for devices whose first sector is not
375 * naturally aligned.
376 */
377void blk_queue_alignment_offset(struct request_queue *q, unsigned int offset)
378{
379 q->limits.alignment_offset =
380 offset & (q->limits.physical_block_size - 1);
381 q->limits.misaligned = 0;
382}
383EXPORT_SYMBOL(blk_queue_alignment_offset);
384
Christoph Hellwig471aa702021-08-09 16:17:41 +0200385void disk_update_readahead(struct gendisk *disk)
Christoph Hellwigc2e4cd52020-09-24 08:51:34 +0200386{
Christoph Hellwig471aa702021-08-09 16:17:41 +0200387 struct request_queue *q = disk->queue;
388
Christoph Hellwigc2e4cd52020-09-24 08:51:34 +0200389 /*
390 * For read-ahead of large files to be effective, we need to read ahead
391 * at least twice the optimal I/O size.
392 */
Christoph Hellwigedb08722021-08-09 16:17:43 +0200393 disk->bdi->ra_pages =
Christoph Hellwigc2e4cd52020-09-24 08:51:34 +0200394 max(queue_io_opt(q) * 2 / PAGE_SIZE, VM_READAHEAD_PAGES);
Christoph Hellwigedb08722021-08-09 16:17:43 +0200395 disk->bdi->io_pages = queue_max_sectors(q) >> (PAGE_SHIFT - 9);
Christoph Hellwigc2e4cd52020-09-24 08:51:34 +0200396}
Christoph Hellwig471aa702021-08-09 16:17:41 +0200397EXPORT_SYMBOL_GPL(disk_update_readahead);
Christoph Hellwigc2e4cd52020-09-24 08:51:34 +0200398
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400399/**
Martin K. Petersen7c958e32009-07-31 11:49:11 -0400400 * blk_limits_io_min - set minimum request size for a device
401 * @limits: the queue limits
402 * @min: smallest I/O size in bytes
403 *
404 * Description:
405 * Some devices have an internal block size bigger than the reported
406 * hardware sector size. This function can be used to signal the
407 * smallest I/O the device can perform without incurring a performance
408 * penalty.
409 */
410void blk_limits_io_min(struct queue_limits *limits, unsigned int min)
411{
412 limits->io_min = min;
413
414 if (limits->io_min < limits->logical_block_size)
415 limits->io_min = limits->logical_block_size;
416
417 if (limits->io_min < limits->physical_block_size)
418 limits->io_min = limits->physical_block_size;
419}
420EXPORT_SYMBOL(blk_limits_io_min);
421
422/**
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400423 * blk_queue_io_min - set minimum request size for the queue
424 * @q: the request queue for the device
Randy Dunlap8ebf9752009-06-11 20:00:41 -0700425 * @min: smallest I/O size in bytes
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400426 *
427 * Description:
Martin K. Petersen7e5f5fb2009-07-31 11:49:13 -0400428 * Storage devices may report a granularity or preferred minimum I/O
429 * size which is the smallest request the device can perform without
430 * incurring a performance penalty. For disk drives this is often the
431 * physical block size. For RAID arrays it is often the stripe chunk
432 * size. A properly aligned multiple of minimum_io_size is the
433 * preferred request size for workloads where a high number of I/O
434 * operations is desired.
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400435 */
436void blk_queue_io_min(struct request_queue *q, unsigned int min)
437{
Martin K. Petersen7c958e32009-07-31 11:49:11 -0400438 blk_limits_io_min(&q->limits, min);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400439}
440EXPORT_SYMBOL(blk_queue_io_min);
441
442/**
Martin K. Petersen3c5820c2009-09-11 21:54:52 +0200443 * blk_limits_io_opt - set optimal request size for a device
444 * @limits: the queue limits
445 * @opt: smallest I/O size in bytes
446 *
447 * Description:
448 * Storage devices may report an optimal I/O size, which is the
449 * device's preferred unit for sustained I/O. This is rarely reported
450 * for disk drives. For RAID arrays it is usually the stripe width or
451 * the internal track size. A properly aligned multiple of
452 * optimal_io_size is the preferred request size for workloads where
453 * sustained throughput is desired.
454 */
455void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt)
456{
457 limits->io_opt = opt;
458}
459EXPORT_SYMBOL(blk_limits_io_opt);
460
461/**
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400462 * blk_queue_io_opt - set optimal request size for the queue
463 * @q: the request queue for the device
Randy Dunlap8ebf9752009-06-11 20:00:41 -0700464 * @opt: optimal request size in bytes
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400465 *
466 * Description:
Martin K. Petersen7e5f5fb2009-07-31 11:49:13 -0400467 * Storage devices may report an optimal I/O size, which is the
468 * device's preferred unit for sustained I/O. This is rarely reported
469 * for disk drives. For RAID arrays it is usually the stripe width or
470 * the internal track size. A properly aligned multiple of
471 * optimal_io_size is the preferred request size for workloads where
472 * sustained throughput is desired.
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400473 */
474void blk_queue_io_opt(struct request_queue *q, unsigned int opt)
475{
Martin K. Petersen3c5820c2009-09-11 21:54:52 +0200476 blk_limits_io_opt(&q->limits, opt);
Christoph Hellwigd152c682021-08-16 15:46:24 +0200477 if (!q->disk)
Christoph Hellwigedb08722021-08-09 16:17:43 +0200478 return;
Christoph Hellwigd152c682021-08-16 15:46:24 +0200479 q->disk->bdi->ra_pages =
Christoph Hellwigc2e4cd52020-09-24 08:51:34 +0200480 max(queue_io_opt(q) * 2 / PAGE_SIZE, VM_READAHEAD_PAGES);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400481}
482EXPORT_SYMBOL(blk_queue_io_opt);
483
Christoph Hellwig89098b02022-04-15 06:52:49 +0200484static int queue_limit_alignment_offset(struct queue_limits *lim,
485 sector_t sector)
486{
487 unsigned int granularity = max(lim->physical_block_size, lim->io_min);
488 unsigned int alignment = sector_div(sector, granularity >> SECTOR_SHIFT)
489 << SECTOR_SHIFT;
490
491 return (granularity + lim->alignment_offset - alignment) % granularity;
492}
493
Christoph Hellwig5c4b4a52022-04-15 06:52:52 +0200494static unsigned int queue_limit_discard_alignment(struct queue_limits *lim,
495 sector_t sector)
496{
497 unsigned int alignment, granularity, offset;
498
499 if (!lim->max_discard_sectors)
500 return 0;
501
502 /* Why are these in bytes, not sectors? */
503 alignment = lim->discard_alignment >> SECTOR_SHIFT;
504 granularity = lim->discard_granularity >> SECTOR_SHIFT;
505 if (!granularity)
506 return 0;
507
508 /* Offset of the partition start in 'granularity' sectors */
509 offset = sector_div(sector, granularity);
510
511 /* And why do we do this modulus *again* in blkdev_issue_discard()? */
512 offset = (granularity + alignment - offset) % granularity;
513
514 /* Turn it back into bytes, gaah */
515 return offset << SECTOR_SHIFT;
516}
517
Mikulas Patocka97f433c2021-02-23 19:25:30 -0700518static unsigned int blk_round_down_sectors(unsigned int sectors, unsigned int lbs)
519{
520 sectors = round_down(sectors, lbs >> SECTOR_SHIFT);
521 if (sectors < PAGE_SIZE >> SECTOR_SHIFT)
522 sectors = PAGE_SIZE >> SECTOR_SHIFT;
523 return sectors;
524}
525
Jens Axboe86db1e22008-01-29 14:53:40 +0100526/**
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400527 * blk_stack_limits - adjust queue_limits for stacked devices
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100528 * @t: the stacking driver limits (top device)
529 * @b: the underlying queue limits (bottom, component device)
Martin K. Petersene03a72e2010-01-11 03:21:51 -0500530 * @start: first data sector within component device
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400531 *
532 * Description:
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100533 * This function is used by stacking drivers like MD and DM to ensure
534 * that all component devices have compatible block sizes and
535 * alignments. The stacking driver must provide a queue_limits
536 * struct (top) and then iteratively call the stacking function for
537 * all component (bottom) devices. The stacking function will
538 * attempt to combine the values and ensure proper alignment.
539 *
540 * Returns 0 if the top and bottom queue_limits are compatible. The
541 * top device's block sizes and alignment offsets may be adjusted to
542 * ensure alignment with the bottom device. If no compatible sizes
543 * and alignments exist, -1 is returned and the resulting top
544 * queue_limits will have the misaligned flag set to indicate that
545 * the alignment_offset is undefined.
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400546 */
547int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
Martin K. Petersene03a72e2010-01-11 03:21:51 -0500548 sector_t start)
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400549{
Martin K. Petersene03a72e2010-01-11 03:21:51 -0500550 unsigned int top, bottom, alignment, ret = 0;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100551
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400552 t->max_sectors = min_not_zero(t->max_sectors, b->max_sectors);
553 t->max_hw_sectors = min_not_zero(t->max_hw_sectors, b->max_hw_sectors);
Martin K. Petersenca369d52015-11-13 16:46:48 -0500554 t->max_dev_sectors = min_not_zero(t->max_dev_sectors, b->max_dev_sectors);
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800555 t->max_write_zeroes_sectors = min(t->max_write_zeroes_sectors,
556 b->max_write_zeroes_sectors);
Keith Busch0512a752020-05-12 17:55:47 +0900557 t->max_zone_append_sectors = min(t->max_zone_append_sectors,
558 b->max_zone_append_sectors);
Christoph Hellwig9bb33f22021-03-31 09:30:00 +0200559 t->bounce = max(t->bounce, b->bounce);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400560
561 t->seg_boundary_mask = min_not_zero(t->seg_boundary_mask,
562 b->seg_boundary_mask);
Keith Busch03100aa2015-08-19 14:24:05 -0700563 t->virt_boundary_mask = min_not_zero(t->virt_boundary_mask,
564 b->virt_boundary_mask);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400565
Martin K. Petersen8a783622010-02-26 00:20:39 -0500566 t->max_segments = min_not_zero(t->max_segments, b->max_segments);
Christoph Hellwig1e739732017-02-08 14:46:49 +0100567 t->max_discard_segments = min_not_zero(t->max_discard_segments,
568 b->max_discard_segments);
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200569 t->max_integrity_segments = min_not_zero(t->max_integrity_segments,
570 b->max_integrity_segments);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400571
572 t->max_segment_size = min_not_zero(t->max_segment_size,
573 b->max_segment_size);
574
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500575 t->misaligned |= b->misaligned;
576
Martin K. Petersene03a72e2010-01-11 03:21:51 -0500577 alignment = queue_limit_alignment_offset(b, start);
Martin K. Petersen9504e082009-12-21 15:55:51 +0100578
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100579 /* Bottom device has different alignment. Check that it is
580 * compatible with the current top alignment.
581 */
Martin K. Petersen9504e082009-12-21 15:55:51 +0100582 if (t->alignment_offset != alignment) {
583
584 top = max(t->physical_block_size, t->io_min)
585 + t->alignment_offset;
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100586 bottom = max(b->physical_block_size, b->io_min) + alignment;
Martin K. Petersen9504e082009-12-21 15:55:51 +0100587
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100588 /* Verify that top and bottom intervals line up */
Mike Snitzerb8839b82014-10-08 18:26:13 -0400589 if (max(top, bottom) % min(top, bottom)) {
Martin K. Petersen9504e082009-12-21 15:55:51 +0100590 t->misaligned = 1;
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500591 ret = -1;
592 }
Martin K. Petersen9504e082009-12-21 15:55:51 +0100593 }
594
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400595 t->logical_block_size = max(t->logical_block_size,
596 b->logical_block_size);
597
598 t->physical_block_size = max(t->physical_block_size,
599 b->physical_block_size);
600
601 t->io_min = max(t->io_min, b->io_min);
Mike Snitzere9637412015-03-30 13:39:09 -0400602 t->io_opt = lcm_not_zero(t->io_opt, b->io_opt);
Mike Snitzer7e7986f2020-12-01 11:07:09 -0500603
604 /* Set non-power-of-2 compatible chunk_sectors boundary */
605 if (b->chunk_sectors)
606 t->chunk_sectors = gcd(t->chunk_sectors, b->chunk_sectors);
Martin K. Petersen9504e082009-12-21 15:55:51 +0100607
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100608 /* Physical block size a multiple of the logical block size? */
Martin K. Petersen9504e082009-12-21 15:55:51 +0100609 if (t->physical_block_size & (t->logical_block_size - 1)) {
610 t->physical_block_size = t->logical_block_size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400611 t->misaligned = 1;
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500612 ret = -1;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100613 }
614
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100615 /* Minimum I/O a multiple of the physical block size? */
Martin K. Petersen9504e082009-12-21 15:55:51 +0100616 if (t->io_min & (t->physical_block_size - 1)) {
617 t->io_min = t->physical_block_size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400618 t->misaligned = 1;
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500619 ret = -1;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400620 }
621
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100622 /* Optimal I/O a multiple of the physical block size? */
Martin K. Petersen9504e082009-12-21 15:55:51 +0100623 if (t->io_opt & (t->physical_block_size - 1)) {
624 t->io_opt = 0;
625 t->misaligned = 1;
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500626 ret = -1;
Martin K. Petersen9504e082009-12-21 15:55:51 +0100627 }
Martin K. Petersen70dd5bf2009-07-31 11:49:12 -0400628
Mike Snitzer22ada802020-09-21 22:32:48 -0400629 /* chunk_sectors a multiple of the physical block size? */
630 if ((t->chunk_sectors << 9) & (t->physical_block_size - 1)) {
631 t->chunk_sectors = 0;
632 t->misaligned = 1;
633 ret = -1;
634 }
635
Kent Overstreetc78afc62013-07-11 22:39:53 -0700636 t->raid_partial_stripes_expensive =
637 max(t->raid_partial_stripes_expensive,
638 b->raid_partial_stripes_expensive);
639
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100640 /* Find lowest common alignment_offset */
Mike Snitzere9637412015-03-30 13:39:09 -0400641 t->alignment_offset = lcm_not_zero(t->alignment_offset, alignment)
Mike Snitzerb8839b82014-10-08 18:26:13 -0400642 % max(t->physical_block_size, t->io_min);
Martin K. Petersen70dd5bf2009-07-31 11:49:12 -0400643
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100644 /* Verify that new alignment_offset is on a logical block boundary */
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500645 if (t->alignment_offset & (t->logical_block_size - 1)) {
Martin K. Petersen9504e082009-12-21 15:55:51 +0100646 t->misaligned = 1;
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500647 ret = -1;
648 }
Martin K. Petersen9504e082009-12-21 15:55:51 +0100649
Mikulas Patocka97f433c2021-02-23 19:25:30 -0700650 t->max_sectors = blk_round_down_sectors(t->max_sectors, t->logical_block_size);
651 t->max_hw_sectors = blk_round_down_sectors(t->max_hw_sectors, t->logical_block_size);
652 t->max_dev_sectors = blk_round_down_sectors(t->max_dev_sectors, t->logical_block_size);
653
Martin K. Petersen9504e082009-12-21 15:55:51 +0100654 /* Discard alignment and granularity */
655 if (b->discard_granularity) {
Martin K. Petersene03a72e2010-01-11 03:21:51 -0500656 alignment = queue_limit_discard_alignment(b, start);
Martin K. Petersen9504e082009-12-21 15:55:51 +0100657
658 if (t->discard_granularity != 0 &&
659 t->discard_alignment != alignment) {
660 top = t->discard_granularity + t->discard_alignment;
661 bottom = b->discard_granularity + alignment;
662
663 /* Verify that top and bottom intervals line up */
Shaohua Li8dd2cb72012-12-14 11:15:36 +0800664 if ((max(top, bottom) % min(top, bottom)) != 0)
Martin K. Petersen9504e082009-12-21 15:55:51 +0100665 t->discard_misaligned = 1;
666 }
667
Martin K. Petersen81744ee2009-12-29 08:35:35 +0100668 t->max_discard_sectors = min_not_zero(t->max_discard_sectors,
669 b->max_discard_sectors);
Jens Axboe0034af02015-07-16 09:14:26 -0600670 t->max_hw_discard_sectors = min_not_zero(t->max_hw_discard_sectors,
671 b->max_hw_discard_sectors);
Martin K. Petersen9504e082009-12-21 15:55:51 +0100672 t->discard_granularity = max(t->discard_granularity,
673 b->discard_granularity);
Mike Snitzere9637412015-03-30 13:39:09 -0400674 t->discard_alignment = lcm_not_zero(t->discard_alignment, alignment) %
Shaohua Li8dd2cb72012-12-14 11:15:36 +0800675 t->discard_granularity;
Martin K. Petersen9504e082009-12-21 15:55:51 +0100676 }
Christoph Hellwig44abff2c2022-04-15 06:52:57 +0200677 t->max_secure_erase_sectors = min_not_zero(t->max_secure_erase_sectors,
678 b->max_secure_erase_sectors);
Damien Le Moala805a4f2021-01-28 13:47:30 +0900679 t->zone_write_granularity = max(t->zone_write_granularity,
680 b->zone_write_granularity);
Christoph Hellwig3093a472020-07-20 08:12:49 +0200681 t->zoned = max(t->zoned, b->zoned);
Martin K. Petersenfe0b3932010-01-11 03:21:47 -0500682 return ret;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400683}
Mike Snitzer5d85d322009-05-28 11:04:53 +0200684EXPORT_SYMBOL(blk_stack_limits);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400685
686/**
687 * disk_stack_limits - adjust queue limits for stacked drivers
Martin K. Petersen77634f32009-06-09 06:23:22 +0200688 * @disk: MD/DM gendisk (top)
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400689 * @bdev: the underlying block device (bottom)
690 * @offset: offset to beginning of data within component device
691 *
692 * Description:
Martin K. Petersene03a72e2010-01-11 03:21:51 -0500693 * Merges the limits for a top level gendisk and a bottom level
694 * block_device.
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400695 */
696void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
697 sector_t offset)
698{
699 struct request_queue *t = disk->queue;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400700
Christoph Hellwig9efa82e2020-07-20 08:12:50 +0200701 if (blk_stack_limits(&t->limits, &bdev_get_queue(bdev)->limits,
Christoph Hellwig453b8ab2021-07-27 08:25:16 +0200702 get_start_sect(bdev) + (offset >> 9)) < 0)
703 pr_notice("%s: Warning: Device %pg is misaligned\n",
704 disk->disk_name, bdev);
Konstantin Khlebnikove74d93e2020-02-28 17:51:48 +0300705
Christoph Hellwig471aa702021-08-09 16:17:41 +0200706 disk_update_readahead(disk);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400707}
708EXPORT_SYMBOL(disk_stack_limits);
709
710/**
FUJITA Tomonori27f82212008-07-04 09:30:03 +0200711 * blk_queue_update_dma_pad - update pad mask
712 * @q: the request queue for the device
713 * @mask: pad mask
714 *
715 * Update dma pad mask.
716 *
717 * Appending pad buffer to a request modifies the last entry of a
718 * scatter list such that it includes the pad buffer.
719 **/
720void blk_queue_update_dma_pad(struct request_queue *q, unsigned int mask)
721{
722 if (mask > q->dma_pad_mask)
723 q->dma_pad_mask = mask;
724}
725EXPORT_SYMBOL(blk_queue_update_dma_pad);
726
727/**
Jens Axboe86db1e22008-01-29 14:53:40 +0100728 * blk_queue_segment_boundary - set boundary rules for segment merging
729 * @q: the request queue for the device
730 * @mask: the memory boundary mask
731 **/
732void blk_queue_segment_boundary(struct request_queue *q, unsigned long mask)
733{
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +0300734 if (mask < PAGE_SIZE - 1) {
735 mask = PAGE_SIZE - 1;
Harvey Harrison24c03d42008-05-01 04:35:17 -0700736 printk(KERN_INFO "%s: set to minimum %lx\n",
737 __func__, mask);
Jens Axboe86db1e22008-01-29 14:53:40 +0100738 }
739
Martin K. Petersen025146e2009-05-22 17:17:51 -0400740 q->limits.seg_boundary_mask = mask;
Jens Axboe86db1e22008-01-29 14:53:40 +0100741}
Jens Axboe86db1e22008-01-29 14:53:40 +0100742EXPORT_SYMBOL(blk_queue_segment_boundary);
743
744/**
Keith Busch03100aa2015-08-19 14:24:05 -0700745 * blk_queue_virt_boundary - set boundary rules for bio merging
746 * @q: the request queue for the device
747 * @mask: the memory boundary mask
748 **/
749void blk_queue_virt_boundary(struct request_queue *q, unsigned long mask)
750{
751 q->limits.virt_boundary_mask = mask;
Christoph Hellwig09324d32019-05-21 09:01:41 +0200752
753 /*
754 * Devices that require a virtual boundary do not support scatter/gather
755 * I/O natively, but instead require a descriptor list entry for each
756 * page (which might not be idential to the Linux PAGE_SIZE). Because
757 * of that they are not limited by our notion of "segment size".
758 */
Christoph Hellwigc6c84f72019-07-24 18:26:56 +0200759 if (mask)
760 q->limits.max_segment_size = UINT_MAX;
Keith Busch03100aa2015-08-19 14:24:05 -0700761}
762EXPORT_SYMBOL(blk_queue_virt_boundary);
763
764/**
Jens Axboe86db1e22008-01-29 14:53:40 +0100765 * blk_queue_dma_alignment - set dma length and memory alignment
766 * @q: the request queue for the device
767 * @mask: alignment mask
768 *
769 * description:
Randy Dunlap710027a2008-08-19 20:13:11 +0200770 * set required memory and length alignment for direct dma transactions.
Alan Cox8feb4d22009-04-01 15:01:39 +0100771 * this is used when building direct io requests for the queue.
Jens Axboe86db1e22008-01-29 14:53:40 +0100772 *
773 **/
774void blk_queue_dma_alignment(struct request_queue *q, int mask)
775{
776 q->dma_alignment = mask;
777}
Jens Axboe86db1e22008-01-29 14:53:40 +0100778EXPORT_SYMBOL(blk_queue_dma_alignment);
779
780/**
781 * blk_queue_update_dma_alignment - update dma length and memory alignment
782 * @q: the request queue for the device
783 * @mask: alignment mask
784 *
785 * description:
Randy Dunlap710027a2008-08-19 20:13:11 +0200786 * update required memory and length alignment for direct dma transactions.
Jens Axboe86db1e22008-01-29 14:53:40 +0100787 * If the requested alignment is larger than the current alignment, then
788 * the current queue alignment is updated to the new value, otherwise it
789 * is left alone. The design of this is to allow multiple objects
790 * (driver, device, transport etc) to set their respective
791 * alignments without having them interfere.
792 *
793 **/
794void blk_queue_update_dma_alignment(struct request_queue *q, int mask)
795{
796 BUG_ON(mask > PAGE_SIZE);
797
798 if (mask > q->dma_alignment)
799 q->dma_alignment = mask;
800}
Jens Axboe86db1e22008-01-29 14:53:40 +0100801EXPORT_SYMBOL(blk_queue_update_dma_alignment);
802
Jens Axboe93e9d8e2016-04-12 12:32:46 -0600803/**
Jens Axboed278d4a2016-03-30 10:21:08 -0600804 * blk_set_queue_depth - tell the block layer about the device queue depth
805 * @q: the request queue for the device
806 * @depth: queue depth
807 *
808 */
809void blk_set_queue_depth(struct request_queue *q, unsigned int depth)
810{
811 q->queue_depth = depth;
Tejun Heo9677a3e2019-08-28 15:05:55 -0700812 rq_qos_queue_depth_changed(q);
Jens Axboed278d4a2016-03-30 10:21:08 -0600813}
814EXPORT_SYMBOL(blk_set_queue_depth);
815
816/**
Jens Axboe93e9d8e2016-04-12 12:32:46 -0600817 * blk_queue_write_cache - configure queue's write cache
818 * @q: the request queue for the device
819 * @wc: write back cache on or off
820 * @fua: device supports FUA writes, if true
821 *
822 * Tell the block layer about the write cache of @q.
823 */
824void blk_queue_write_cache(struct request_queue *q, bool wc, bool fua)
825{
Jens Axboec888a8f2016-04-13 13:33:19 -0600826 if (wc)
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100827 blk_queue_flag_set(QUEUE_FLAG_WC, q);
Jens Axboec888a8f2016-04-13 13:33:19 -0600828 else
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100829 blk_queue_flag_clear(QUEUE_FLAG_WC, q);
Jens Axboec888a8f2016-04-13 13:33:19 -0600830 if (fua)
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100831 blk_queue_flag_set(QUEUE_FLAG_FUA, q);
Jens Axboec888a8f2016-04-13 13:33:19 -0600832 else
Christoph Hellwig57d74df2018-11-14 17:02:07 +0100833 blk_queue_flag_clear(QUEUE_FLAG_FUA, q);
Jens Axboe87760e52016-11-09 12:38:14 -0700834
Josef Bacika7905042018-07-03 09:32:35 -0600835 wbt_set_write_cache(q, test_bit(QUEUE_FLAG_WC, &q->queue_flags));
Jens Axboe93e9d8e2016-04-12 12:32:46 -0600836}
837EXPORT_SYMBOL_GPL(blk_queue_write_cache);
838
Damien Le Moal68c43f12019-09-05 18:51:31 +0900839/**
840 * blk_queue_required_elevator_features - Set a queue required elevator features
841 * @q: the request queue for the target device
842 * @features: Required elevator features OR'ed together
843 *
844 * Tell the block layer that for the device controlled through @q, only the
845 * only elevators that can be used are those that implement at least the set of
846 * features specified by @features.
847 */
848void blk_queue_required_elevator_features(struct request_queue *q,
849 unsigned int features)
850{
851 q->required_elevator_features = features;
852}
853EXPORT_SYMBOL_GPL(blk_queue_required_elevator_features);
854
Linus Torvalds671df182019-09-19 13:27:23 -0700855/**
Yoshihiro Shimoda45147fb2019-08-28 21:35:42 +0900856 * blk_queue_can_use_dma_map_merging - configure queue for merging segments.
857 * @q: the request queue for the device
858 * @dev: the device pointer for dma
859 *
860 * Tell the block layer about merging the segments by dma map of @q.
861 */
862bool blk_queue_can_use_dma_map_merging(struct request_queue *q,
863 struct device *dev)
864{
865 unsigned long boundary = dma_get_merge_boundary(dev);
866
867 if (!boundary)
868 return false;
869
870 /* No need to update max_segment_size. see blk_queue_virt_boundary() */
871 blk_queue_virt_boundary(q, boundary);
872
873 return true;
874}
875EXPORT_SYMBOL_GPL(blk_queue_can_use_dma_map_merging);
876
Shin'ichiro Kawasakie0c60d02021-10-26 15:01:15 +0900877static bool disk_has_partitions(struct gendisk *disk)
878{
879 unsigned long idx;
880 struct block_device *part;
881 bool ret = false;
882
883 rcu_read_lock();
884 xa_for_each(&disk->part_tbl, idx, part) {
885 if (bdev_is_partition(part)) {
886 ret = true;
887 break;
888 }
889 }
890 rcu_read_unlock();
891
892 return ret;
893}
894
Damien Le Moal27ba3e82020-09-15 16:33:46 +0900895/**
896 * blk_queue_set_zoned - configure a disk queue zoned model.
897 * @disk: the gendisk of the queue to configure
898 * @model: the zoned model to set
899 *
900 * Set the zoned model of the request queue of @disk according to @model.
901 * When @model is BLK_ZONED_HM (host managed), this should be called only
902 * if zoned block device support is enabled (CONFIG_BLK_DEV_ZONED option).
903 * If @model specifies BLK_ZONED_HA (host aware), the effective model used
904 * depends on CONFIG_BLK_DEV_ZONED settings and on the existence of partitions
905 * on the disk.
906 */
907void blk_queue_set_zoned(struct gendisk *disk, enum blk_zoned_model model)
908{
Damien Le Moala805a4f2021-01-28 13:47:30 +0900909 struct request_queue *q = disk->queue;
910
Damien Le Moal27ba3e82020-09-15 16:33:46 +0900911 switch (model) {
912 case BLK_ZONED_HM:
913 /*
914 * Host managed devices are supported only if
915 * CONFIG_BLK_DEV_ZONED is enabled.
916 */
917 WARN_ON_ONCE(!IS_ENABLED(CONFIG_BLK_DEV_ZONED));
918 break;
919 case BLK_ZONED_HA:
920 /*
921 * Host aware devices can be treated either as regular block
922 * devices (similar to drive managed devices) or as zoned block
923 * devices to take advantage of the zone command set, similarly
924 * to host managed devices. We try the latter if there are no
925 * partitions and zoned block device support is enabled, else
926 * we do nothing special as far as the block layer is concerned.
927 */
928 if (!IS_ENABLED(CONFIG_BLK_DEV_ZONED) ||
Shin'ichiro Kawasakie0c60d02021-10-26 15:01:15 +0900929 disk_has_partitions(disk))
Damien Le Moal27ba3e82020-09-15 16:33:46 +0900930 model = BLK_ZONED_NONE;
931 break;
932 case BLK_ZONED_NONE:
933 default:
934 if (WARN_ON_ONCE(model != BLK_ZONED_NONE))
935 model = BLK_ZONED_NONE;
936 break;
937 }
938
Damien Le Moala805a4f2021-01-28 13:47:30 +0900939 q->limits.zoned = model;
940 if (model != BLK_ZONED_NONE) {
941 /*
942 * Set the zone write granularity to the device logical block
943 * size by default. The driver can change this value if needed.
944 */
945 blk_queue_zone_write_granularity(q,
946 queue_logical_block_size(q));
Damien Le Moal508aebb2021-01-28 13:47:32 +0900947 } else {
948 blk_queue_clear_zone_settings(q);
Damien Le Moala805a4f2021-01-28 13:47:30 +0900949 }
Damien Le Moal27ba3e82020-09-15 16:33:46 +0900950}
951EXPORT_SYMBOL_GPL(blk_queue_set_zoned);
Christoph Hellwig89098b02022-04-15 06:52:49 +0200952
953int bdev_alignment_offset(struct block_device *bdev)
954{
955 struct request_queue *q = bdev_get_queue(bdev);
956
957 if (q->limits.misaligned)
958 return -1;
959 if (bdev_is_partition(bdev))
960 return queue_limit_alignment_offset(&q->limits,
961 bdev->bd_start_sect);
962 return q->limits.alignment_offset;
963}
964EXPORT_SYMBOL_GPL(bdev_alignment_offset);
Christoph Hellwig5c4b4a52022-04-15 06:52:52 +0200965
966unsigned int bdev_discard_alignment(struct block_device *bdev)
967{
968 struct request_queue *q = bdev_get_queue(bdev);
969
970 if (bdev_is_partition(bdev))
971 return queue_limit_discard_alignment(&q->limits,
972 bdev->bd_start_sect);
973 return q->limits.discard_alignment;
974}
975EXPORT_SYMBOL_GPL(bdev_discard_alignment);