blob: 338604dff7d04315555105d8c0f806fad349c701 [file] [log] [blame]
Greg Kroah-Hartmanb2441312017-11-01 15:07:57 +01001/* SPDX-License-Identifier: GPL-2.0 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002#ifndef _LINUX_BLKDEV_H
3#define _LINUX_BLKDEV_H
4
Russell King85fd0bc2012-05-14 08:29:23 +02005#include <linux/sched.h>
Ingo Molnare6017572017-02-01 16:36:40 +01006#include <linux/sched/clock.h>
Russell King85fd0bc2012-05-14 08:29:23 +02007
Jens Axboef5ff8422007-09-21 09:19:54 +02008#ifdef CONFIG_BLOCK
9
Linus Torvalds1da177e2005-04-16 15:20:36 -070010#include <linux/major.h>
11#include <linux/genhd.h>
12#include <linux/list.h>
Jens Axboe320ae512013-10-24 09:20:05 +010013#include <linux/llist.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070014#include <linux/timer.h>
15#include <linux/workqueue.h>
16#include <linux/pagemap.h>
Tejun Heo66114ca2015-05-22 17:13:32 -040017#include <linux/backing-dev-defs.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070018#include <linux/wait.h>
19#include <linux/mempool.h>
Dan Williams34c0fd52016-01-15 16:56:14 -080020#include <linux/pfn.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070021#include <linux/bio.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070022#include <linux/stringify.h>
Hugh Dickins3e6053d2008-09-11 10:57:55 +020023#include <linux/gfp.h>
FUJITA Tomonorid351af02007-07-09 12:40:35 +020024#include <linux/bsg.h>
Jens Axboec7c22e42008-09-13 20:26:01 +020025#include <linux/smp.h>
Tejun Heo548bc8e2013-01-09 08:05:13 -080026#include <linux/rcupdate.h>
Tejun Heoadd703f2014-07-01 10:34:38 -060027#include <linux/percpu-refcount.h>
Christoph Hellwig84be4562015-05-01 12:46:15 +020028#include <linux/scatterlist.h>
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +090029#include <linux/blkzoned.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070030
Paul Gortmakerde477252011-05-26 13:46:22 -040031struct module;
Christoph Hellwig21b2f0c2006-03-22 17:52:04 +010032struct scsi_ioctl_command;
33
Linus Torvalds1da177e2005-04-16 15:20:36 -070034struct request_queue;
Linus Torvalds1da177e2005-04-16 15:20:36 -070035struct elevator_queue;
Jens Axboe2056a782006-03-23 20:00:26 +010036struct blk_trace;
Jens Axboe3d6392c2007-07-09 12:38:05 +020037struct request;
38struct sg_io_hdr;
Mike Christieaa387cc2011-07-31 22:05:09 +020039struct bsg_job;
Tejun Heo3c798392012-04-16 13:57:25 -070040struct blkcg_gq;
Ming Lei7c94e1c2014-09-25 23:23:43 +080041struct blk_flush_queue;
Christoph Hellwigbbd3e062015-10-15 14:10:48 +020042struct pr_ops;
Josef Bacika7905042018-07-03 09:32:35 -060043struct rq_qos;
Omar Sandoval34dbad52017-03-21 08:56:08 -070044struct blk_queue_stats;
45struct blk_stat_callback;
Linus Torvalds1da177e2005-04-16 15:20:36 -070046
47#define BLKDEV_MIN_RQ 4
48#define BLKDEV_MAX_RQ 128 /* Default maximum */
49
Minwoo Im096392e2018-02-15 23:53:17 +090050/* Must be consistent with blk_mq_poll_stats_bkt() */
Stephen Bates02063192017-04-20 16:59:11 -060051#define BLK_MQ_POLL_STATS_BKTS 16
52
Tejun Heo8bd435b2012-04-13 13:11:28 -070053/*
54 * Maximum number of blkcg policies allowed to be registered concurrently.
55 * Defined here to simplify include dependency.
56 */
Jens Axboe01c5f852018-09-11 10:59:53 -060057#define BLKCG_MAX_POLS 5
Tejun Heo8bd435b2012-04-13 13:11:28 -070058
Christoph Hellwig2a842ac2017-06-03 09:38:04 +020059typedef void (rq_end_io_fn)(struct request *, blk_status_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070060
Jens Axboe4aff5e22006-08-10 08:44:47 +020061/*
Christoph Hellwige8064022016-10-20 15:12:13 +020062 * request flags */
63typedef __u32 __bitwise req_flags_t;
64
65/* elevator knows about this request */
66#define RQF_SORTED ((__force req_flags_t)(1 << 0))
67/* drive already may have started this one */
68#define RQF_STARTED ((__force req_flags_t)(1 << 1))
Christoph Hellwige8064022016-10-20 15:12:13 +020069/* may not be passed by ioscheduler */
70#define RQF_SOFTBARRIER ((__force req_flags_t)(1 << 3))
71/* request for flush sequence */
72#define RQF_FLUSH_SEQ ((__force req_flags_t)(1 << 4))
73/* merge of different types, fail separately */
74#define RQF_MIXED_MERGE ((__force req_flags_t)(1 << 5))
75/* track inflight for MQ */
76#define RQF_MQ_INFLIGHT ((__force req_flags_t)(1 << 6))
77/* don't call prep for this one */
78#define RQF_DONTPREP ((__force req_flags_t)(1 << 7))
79/* set for "ide_preempt" requests and also for requests for which the SCSI
80 "quiesce" state must be ignored. */
81#define RQF_PREEMPT ((__force req_flags_t)(1 << 8))
82/* contains copies of user pages */
83#define RQF_COPY_USER ((__force req_flags_t)(1 << 9))
84/* vaguely specified driver internal error. Ignored by the block layer */
85#define RQF_FAILED ((__force req_flags_t)(1 << 10))
86/* don't warn about errors */
87#define RQF_QUIET ((__force req_flags_t)(1 << 11))
88/* elevator private data attached */
89#define RQF_ELVPRIV ((__force req_flags_t)(1 << 12))
Konstantin Khlebnikov4822e902018-10-11 10:07:06 +030090/* account into disk and partition IO statistics */
Christoph Hellwige8064022016-10-20 15:12:13 +020091#define RQF_IO_STAT ((__force req_flags_t)(1 << 13))
92/* request came from our alloc pool */
93#define RQF_ALLOCED ((__force req_flags_t)(1 << 14))
94/* runtime pm request */
95#define RQF_PM ((__force req_flags_t)(1 << 15))
96/* on IO scheduler merge hash */
97#define RQF_HASHED ((__force req_flags_t)(1 << 16))
Konstantin Khlebnikov4822e902018-10-11 10:07:06 +030098/* track IO completion time */
Jens Axboecf43e6b2016-11-07 21:32:37 -070099#define RQF_STATS ((__force req_flags_t)(1 << 17))
Christoph Hellwigf9d03f92016-12-08 15:20:32 -0700100/* Look at ->special_vec for the actual data payload instead of the
101 bio chain. */
102#define RQF_SPECIAL_PAYLOAD ((__force req_flags_t)(1 << 18))
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900103/* The per-zone write lock is held for this request */
104#define RQF_ZONE_WRITE_LOCKED ((__force req_flags_t)(1 << 19))
Jens Axboe76a86f92018-01-10 11:30:56 -0700105/* already slept for hybrid poll */
Keith Busch12f5b932018-05-29 15:52:28 +0200106#define RQF_MQ_POLL_SLEPT ((__force req_flags_t)(1 << 20))
Christoph Hellwigda661262018-06-14 13:58:45 +0200107/* ->timeout has been called, don't expire again */
108#define RQF_TIMED_OUT ((__force req_flags_t)(1 << 21))
Christoph Hellwige8064022016-10-20 15:12:13 +0200109
110/* flags that prevent us from merging requests: */
111#define RQF_NOMERGE_FLAGS \
Christoph Hellwigf9d03f92016-12-08 15:20:32 -0700112 (RQF_STARTED | RQF_SOFTBARRIER | RQF_FLUSH_SEQ | RQF_SPECIAL_PAYLOAD)
Christoph Hellwige8064022016-10-20 15:12:13 +0200113
Linus Torvalds1da177e2005-04-16 15:20:36 -0700114/*
Keith Busch12f5b932018-05-29 15:52:28 +0200115 * Request state for blk-mq.
116 */
117enum mq_rq_state {
118 MQ_RQ_IDLE = 0,
119 MQ_RQ_IN_FLIGHT = 1,
120 MQ_RQ_COMPLETE = 2,
121};
122
123/*
Christoph Hellwigaf76e552014-05-06 12:12:45 +0200124 * Try to put the fields that are referenced together in the same cacheline.
125 *
126 * If you modify this structure, make sure to update blk_rq_init() and
127 * especially blk_mq_rq_ctx_init() to take care of the added fields.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700128 */
129struct request {
Jens Axboe165125e2007-07-24 09:28:11 +0200130 struct request_queue *q;
Jens Axboe320ae512013-10-24 09:20:05 +0100131 struct blk_mq_ctx *mq_ctx;
Jens Axboeea4f9952018-10-29 15:06:13 -0600132 struct blk_mq_hw_ctx *mq_hctx;
Jens Axboee6a1c872006-08-10 09:00:21 +0200133
Christoph Hellwigef295ec2016-10-28 08:48:16 -0600134 unsigned int cmd_flags; /* op and common flags */
Christoph Hellwige8064022016-10-20 15:12:13 +0200135 req_flags_t rq_flags;
Jens Axboed486f1f2017-01-31 12:34:41 -0700136
137 int internal_tag;
138
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900139 /* the following two fields are internal, NEVER access directly */
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900140 unsigned int __data_len; /* total data len */
Jens Axboebd166ef2017-01-17 06:03:22 -0700141 int tag;
Richard Kennedy181fdde2010-03-19 08:58:16 +0100142 sector_t __sector; /* sector cursor */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700143
144 struct bio *bio;
145 struct bio *biotail;
146
Jens Axboe7c3fb702018-01-10 11:46:39 -0700147 struct list_head queuelist;
148
Jens Axboe360f92c2014-04-09 20:27:01 -0600149 /*
150 * The hash is used inside the scheduler, and killed once the
151 * request reaches the dispatch list. The ipi_list is only used
152 * to queue the request for softirq completion, which is long
153 * after the request has been unhashed (and even removed from
154 * the dispatch list).
155 */
156 union {
157 struct hlist_node hash; /* merge hash */
158 struct list_head ipi_list;
159 };
160
Jens Axboee6a1c872006-08-10 09:00:21 +0200161 /*
162 * The rb_node is only used inside the io scheduler, requests
163 * are pruned when moved to the dispatch queue. So let the
Mike Snitzerc1867942011-02-11 11:08:00 +0100164 * completion_data share space with the rb_node.
Jens Axboee6a1c872006-08-10 09:00:21 +0200165 */
166 union {
167 struct rb_node rb_node; /* sort/lookup */
Christoph Hellwigf9d03f92016-12-08 15:20:32 -0700168 struct bio_vec special_vec;
Mike Snitzerc1867942011-02-11 11:08:00 +0100169 void *completion_data;
Christoph Hellwige26738e2017-04-20 16:03:11 +0200170 int error_count; /* for legacy drivers, don't use */
Jens Axboee6a1c872006-08-10 09:00:21 +0200171 };
Jens Axboe98170642006-07-28 09:23:08 +0200172
Jens Axboeff7d1452006-07-12 14:04:37 +0200173 /*
Vivek Goyal7f1dc8a2010-04-21 17:44:16 +0200174 * Three pointers are available for the IO schedulers, if they need
Mike Snitzerc1867942011-02-11 11:08:00 +0100175 * more they have to dynamically allocate it. Flush requests are
176 * never put on the IO scheduler. So let the flush fields share
Tejun Heoa612fdd2011-12-14 00:33:41 +0100177 * space with the elevator data.
Jens Axboeff7d1452006-07-12 14:04:37 +0200178 */
Mike Snitzerc1867942011-02-11 11:08:00 +0100179 union {
Tejun Heoa612fdd2011-12-14 00:33:41 +0100180 struct {
181 struct io_cq *icq;
182 void *priv[2];
183 } elv;
184
Mike Snitzerc1867942011-02-11 11:08:00 +0100185 struct {
186 unsigned int seq;
187 struct list_head list;
Jeff Moyer4853aba2011-08-15 21:37:25 +0200188 rq_end_io_fn *saved_end_io;
Mike Snitzerc1867942011-02-11 11:08:00 +0100189 } flush;
190 };
Jens Axboeff7d1452006-07-12 14:04:37 +0200191
Jens Axboe8f34ee72006-06-13 09:02:34 +0200192 struct gendisk *rq_disk;
Jerome Marchand09e099d2011-01-05 16:57:38 +0100193 struct hd_struct *part;
Omar Sandoval522a7772018-05-09 02:08:53 -0700194 /* Time that I/O was submitted to the kernel. */
195 u64 start_time_ns;
Omar Sandoval544ccc8d2018-05-09 02:08:50 -0700196 /* Time that I/O was submitted to the device. */
197 u64 io_start_time_ns;
198
199#ifdef CONFIG_BLK_WBT
200 unsigned short wbt_flags;
201#endif
202#ifdef CONFIG_BLK_DEV_THROTTLING_LOW
203 unsigned short throtl_size;
204#endif
205
206 /*
207 * Number of scatter-gather DMA addr+len pairs after
Linus Torvalds1da177e2005-04-16 15:20:36 -0700208 * physical address coalescing is performed.
209 */
210 unsigned short nr_phys_segments;
Jens Axboe7c3fb702018-01-10 11:46:39 -0700211
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200212#if defined(CONFIG_BLK_DEV_INTEGRITY)
213 unsigned short nr_integrity_segments;
214#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700215
Jens Axboe7c3fb702018-01-10 11:46:39 -0700216 unsigned short write_hint;
Jens Axboe8f34ee72006-06-13 09:02:34 +0200217 unsigned short ioprio;
218
Tejun Heo731ec492009-04-23 11:05:20 +0900219 void *special; /* opaque pointer available for LLD use */
Jens Axboecdd60262006-07-28 09:32:07 +0200220
FUJITA Tomonori7a85f882008-03-04 11:17:11 +0100221 unsigned int extra_len; /* length of alignment and padding */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700222
Keith Busch12f5b932018-05-29 15:52:28 +0200223 enum mq_rq_state state;
224 refcount_t ref;
Tejun Heo1d9bd512018-01-09 08:29:48 -0800225
Jens Axboe0b7576d2018-05-29 08:47:57 -0600226 unsigned int timeout;
Christoph Hellwig079076b2018-11-14 17:02:05 +0100227 unsigned long deadline;
Jens Axboe0a72e7f2018-01-09 14:23:42 -0700228
Jens Axboe7c3fb702018-01-10 11:46:39 -0700229 union {
Linus Torvalds0a4b6e22018-01-29 11:51:49 -0800230 struct __call_single_data csd;
Jens Axboe7c3fb702018-01-10 11:46:39 -0700231 u64 fifo_time;
232 };
233
Linus Torvalds1da177e2005-04-16 15:20:36 -0700234 /*
Jens Axboec00895a2006-09-30 20:29:12 +0200235 * completion callback.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700236 */
237 rq_end_io_fn *end_io;
238 void *end_io_data;
FUJITA Tomonoriabae1fd2007-07-16 08:52:14 +0200239
240 /* for bidi */
241 struct request *next_rq;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700242};
243
Ming Lei14cb0dc2017-12-18 15:40:43 +0800244static inline bool blk_op_is_scsi(unsigned int op)
245{
246 return op == REQ_OP_SCSI_IN || op == REQ_OP_SCSI_OUT;
247}
248
249static inline bool blk_op_is_private(unsigned int op)
250{
251 return op == REQ_OP_DRV_IN || op == REQ_OP_DRV_OUT;
252}
253
Christoph Hellwigaebf5262017-01-31 16:57:31 +0100254static inline bool blk_rq_is_scsi(struct request *rq)
255{
Ming Lei14cb0dc2017-12-18 15:40:43 +0800256 return blk_op_is_scsi(req_op(rq));
Christoph Hellwigaebf5262017-01-31 16:57:31 +0100257}
258
259static inline bool blk_rq_is_private(struct request *rq)
260{
Ming Lei14cb0dc2017-12-18 15:40:43 +0800261 return blk_op_is_private(req_op(rq));
Christoph Hellwigaebf5262017-01-31 16:57:31 +0100262}
263
Christoph Hellwig57292b52017-01-31 16:57:29 +0100264static inline bool blk_rq_is_passthrough(struct request *rq)
265{
Christoph Hellwigaebf5262017-01-31 16:57:31 +0100266 return blk_rq_is_scsi(rq) || blk_rq_is_private(rq);
Christoph Hellwig57292b52017-01-31 16:57:29 +0100267}
268
Ming Lei14cb0dc2017-12-18 15:40:43 +0800269static inline bool bio_is_passthrough(struct bio *bio)
270{
271 unsigned op = bio_op(bio);
272
273 return blk_op_is_scsi(op) || blk_op_is_private(op);
274}
275
Fernando Luis Vázquez Cao766ca442008-08-14 09:59:13 +0200276static inline unsigned short req_get_ioprio(struct request *req)
277{
278 return req->ioprio;
279}
280
Linus Torvalds1da177e2005-04-16 15:20:36 -0700281#include <linux/elevator.h>
282
Jens Axboe320ae512013-10-24 09:20:05 +0100283struct blk_queue_ctx;
284
Jens Axboedece1632015-11-05 10:41:16 -0700285typedef blk_qc_t (make_request_fn) (struct request_queue *q, struct bio *bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700286
287struct bio_vec;
Tejun Heo2fb98e82008-02-19 11:36:53 +0100288typedef int (dma_drain_needed_fn)(struct request *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700289
Jens Axboe242f9dc2008-09-14 05:55:09 -0700290enum blk_eh_timer_return {
Christoph Hellwig88b0cfa2018-05-29 15:52:38 +0200291 BLK_EH_DONE, /* drivers has completed the command */
292 BLK_EH_RESET_TIMER, /* reset timer and try again */
Jens Axboe242f9dc2008-09-14 05:55:09 -0700293};
294
Linus Torvalds1da177e2005-04-16 15:20:36 -0700295enum blk_queue_state {
296 Queue_down,
297 Queue_up,
298};
299
Shaohua Liee1b6f72015-01-15 17:32:25 -0800300#define BLK_TAG_ALLOC_FIFO 0 /* allocate starting from 0 */
301#define BLK_TAG_ALLOC_RR 1 /* allocate starting from last allocated tag */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700302
FUJITA Tomonoriabf54392008-08-16 14:10:05 +0900303#define BLK_SCSI_MAX_CMDS (256)
304#define BLK_SCSI_CMD_PER_LONG (BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
305
Damien Le Moal797476b2016-10-18 15:40:29 +0900306/*
307 * Zoned block device models (zoned limit).
308 */
309enum blk_zoned_model {
310 BLK_ZONED_NONE, /* Regular block device */
311 BLK_ZONED_HA, /* Host-aware zoned block device */
312 BLK_ZONED_HM, /* Host-managed zoned block device */
313};
314
Martin K. Petersen025146e2009-05-22 17:17:51 -0400315struct queue_limits {
316 unsigned long bounce_pfn;
317 unsigned long seg_boundary_mask;
Keith Busch03100aa2015-08-19 14:24:05 -0700318 unsigned long virt_boundary_mask;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400319
320 unsigned int max_hw_sectors;
Martin K. Petersenca369d52015-11-13 16:46:48 -0500321 unsigned int max_dev_sectors;
Jens Axboe762380a2014-06-05 13:38:39 -0600322 unsigned int chunk_sectors;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400323 unsigned int max_sectors;
324 unsigned int max_segment_size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400325 unsigned int physical_block_size;
326 unsigned int alignment_offset;
327 unsigned int io_min;
328 unsigned int io_opt;
Christoph Hellwig67efc922009-09-30 13:54:20 +0200329 unsigned int max_discard_sectors;
Jens Axboe0034af02015-07-16 09:14:26 -0600330 unsigned int max_hw_discard_sectors;
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400331 unsigned int max_write_same_sectors;
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800332 unsigned int max_write_zeroes_sectors;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100333 unsigned int discard_granularity;
334 unsigned int discard_alignment;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400335
336 unsigned short logical_block_size;
Martin K. Petersen8a783622010-02-26 00:20:39 -0500337 unsigned short max_segments;
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200338 unsigned short max_integrity_segments;
Christoph Hellwig1e739732017-02-08 14:46:49 +0100339 unsigned short max_discard_segments;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400340
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400341 unsigned char misaligned;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100342 unsigned char discard_misaligned;
Kent Overstreetc78afc62013-07-11 22:39:53 -0700343 unsigned char raid_partial_stripes_expensive;
Damien Le Moal797476b2016-10-18 15:40:29 +0900344 enum blk_zoned_model zoned;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400345};
346
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900347#ifdef CONFIG_BLK_DEV_ZONED
348
Damien Le Moala91e1382018-10-12 19:08:43 +0900349extern unsigned int blkdev_nr_zones(struct block_device *bdev);
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900350extern int blkdev_report_zones(struct block_device *bdev,
351 sector_t sector, struct blk_zone *zones,
352 unsigned int *nr_zones, gfp_t gfp_mask);
353extern int blkdev_reset_zones(struct block_device *bdev, sector_t sectors,
354 sector_t nr_sectors, gfp_t gfp_mask);
Damien Le Moalbf505452018-10-12 19:08:50 +0900355extern int blk_revalidate_disk_zones(struct gendisk *disk);
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900356
Shaun Tancheff3ed05a92016-10-18 15:40:35 +0900357extern int blkdev_report_zones_ioctl(struct block_device *bdev, fmode_t mode,
358 unsigned int cmd, unsigned long arg);
359extern int blkdev_reset_zones_ioctl(struct block_device *bdev, fmode_t mode,
360 unsigned int cmd, unsigned long arg);
361
362#else /* CONFIG_BLK_DEV_ZONED */
363
Damien Le Moala91e1382018-10-12 19:08:43 +0900364static inline unsigned int blkdev_nr_zones(struct block_device *bdev)
365{
366 return 0;
367}
Damien Le Moalbf505452018-10-12 19:08:50 +0900368
369static inline int blk_revalidate_disk_zones(struct gendisk *disk)
370{
371 return 0;
372}
373
Shaun Tancheff3ed05a92016-10-18 15:40:35 +0900374static inline int blkdev_report_zones_ioctl(struct block_device *bdev,
375 fmode_t mode, unsigned int cmd,
376 unsigned long arg)
377{
378 return -ENOTTY;
379}
380
381static inline int blkdev_reset_zones_ioctl(struct block_device *bdev,
382 fmode_t mode, unsigned int cmd,
383 unsigned long arg)
384{
385 return -ENOTTY;
386}
387
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900388#endif /* CONFIG_BLK_DEV_ZONED */
389
Richard Kennedyd7b76302011-07-13 21:17:23 +0200390struct request_queue {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700391 /*
392 * Together with queue_head for cacheline sharing
393 */
394 struct list_head queue_head;
395 struct request *last_merge;
Jens Axboeb374d182008-10-31 10:05:07 +0100396 struct elevator_queue *elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700397
Omar Sandoval34dbad52017-03-21 08:56:08 -0700398 struct blk_queue_stats *stats;
Josef Bacika7905042018-07-03 09:32:35 -0600399 struct rq_qos *rq_qos;
Jens Axboe87760e52016-11-09 12:38:14 -0700400
Linus Torvalds1da177e2005-04-16 15:20:36 -0700401 make_request_fn *make_request_fn;
Tejun Heo2fb98e82008-02-19 11:36:53 +0100402 dma_drain_needed_fn *dma_drain_needed;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700403
Jens Axboef8a5b122016-12-13 09:24:51 -0700404 const struct blk_mq_ops *mq_ops;
Jens Axboe320ae512013-10-24 09:20:05 +0100405
Jens Axboe320ae512013-10-24 09:20:05 +0100406 /* sw queues */
Ming Leie6cdb092014-06-03 11:24:06 +0800407 struct blk_mq_ctx __percpu *queue_ctx;
Jens Axboe320ae512013-10-24 09:20:05 +0100408 unsigned int nr_queues;
409
Jens Axboed278d4a2016-03-30 10:21:08 -0600410 unsigned int queue_depth;
411
Jens Axboe320ae512013-10-24 09:20:05 +0100412 /* hw dispatch queues */
413 struct blk_mq_hw_ctx **queue_hw_ctx;
414 unsigned int nr_hw_queues;
415
Jan Karadc3b17c2017-02-02 15:56:50 +0100416 struct backing_dev_info *backing_dev_info;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700417
418 /*
419 * The queue owner gets to use this for whatever they like.
420 * ll_rw_blk doesn't touch it.
421 */
422 void *queuedata;
423
Linus Torvalds1da177e2005-04-16 15:20:36 -0700424 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700425 * various queue flags, see QUEUE_* below
426 */
427 unsigned long queue_flags;
Bart Van Asschecd84a622018-09-26 14:01:04 -0700428 /*
429 * Number of contexts that have called blk_set_pm_only(). If this
430 * counter is above zero then only RQF_PM and RQF_PREEMPT requests are
431 * processed.
432 */
433 atomic_t pm_only;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700434
435 /*
Tejun Heoa73f7302011-12-14 00:33:37 +0100436 * ida allocated id for this queue. Used to index queues from
437 * ioctx.
438 */
439 int id;
440
441 /*
Richard Kennedyd7b76302011-07-13 21:17:23 +0200442 * queue needs bounce pages for pages above this limit
443 */
444 gfp_t bounce_gfp;
445
Christoph Hellwig0d945c12018-11-15 12:17:28 -0700446 spinlock_t queue_lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700447
448 /*
449 * queue kobject
450 */
451 struct kobject kobj;
452
Jens Axboe320ae512013-10-24 09:20:05 +0100453 /*
454 * mq queue kobject
455 */
Ming Lei1db49092018-11-20 09:44:35 +0800456 struct kobject *mq_kobj;
Jens Axboe320ae512013-10-24 09:20:05 +0100457
Dan Williamsac6fc482015-10-21 13:20:18 -0400458#ifdef CONFIG_BLK_DEV_INTEGRITY
459 struct blk_integrity integrity;
460#endif /* CONFIG_BLK_DEV_INTEGRITY */
461
Rafael J. Wysocki47fafbc2014-12-04 01:00:23 +0100462#ifdef CONFIG_PM
Lin Ming6c954662013-03-23 11:42:26 +0800463 struct device *dev;
464 int rpm_status;
465 unsigned int nr_pending;
466#endif
467
Linus Torvalds1da177e2005-04-16 15:20:36 -0700468 /*
469 * queue settings
470 */
471 unsigned long nr_requests; /* Max # of requests */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700472
James Bottomleyfa0ccd82008-01-10 11:30:36 -0600473 unsigned int dma_drain_size;
Richard Kennedyd7b76302011-07-13 21:17:23 +0200474 void *dma_drain_buffer;
Tejun Heoe3790c72008-03-04 11:18:17 +0100475 unsigned int dma_pad_mask;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700476 unsigned int dma_alignment;
477
Jens Axboe242f9dc2008-09-14 05:55:09 -0700478 unsigned int rq_timeout;
Jens Axboe64f1c212016-11-14 13:03:03 -0700479 int poll_nsec;
Omar Sandoval34dbad52017-03-21 08:56:08 -0700480
481 struct blk_stat_callback *poll_cb;
Stephen Bates02063192017-04-20 16:59:11 -0600482 struct blk_rq_stat poll_stat[BLK_MQ_POLL_STATS_BKTS];
Omar Sandoval34dbad52017-03-21 08:56:08 -0700483
Jens Axboe242f9dc2008-09-14 05:55:09 -0700484 struct timer_list timeout;
Christoph Hellwig287922e2015-10-30 20:57:30 +0800485 struct work_struct timeout_work;
Jens Axboe242f9dc2008-09-14 05:55:09 -0700486
Tejun Heoa612fdd2011-12-14 00:33:41 +0100487 struct list_head icq_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800488#ifdef CONFIG_BLK_CGROUP
Tejun Heoa2b16932012-04-13 13:11:33 -0700489 DECLARE_BITMAP (blkcg_pols, BLKCG_MAX_POLS);
Tejun Heo3c798392012-04-16 13:57:25 -0700490 struct blkcg_gq *root_blkg;
Tejun Heo03aa2642012-03-05 13:15:19 -0800491 struct list_head blkg_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800492#endif
Tejun Heoa612fdd2011-12-14 00:33:41 +0100493
Martin K. Petersen025146e2009-05-22 17:17:51 -0400494 struct queue_limits limits;
495
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700496#ifdef CONFIG_BLK_DEV_ZONED
Linus Torvalds1da177e2005-04-16 15:20:36 -0700497 /*
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900498 * Zoned block device information for request dispatch control.
499 * nr_zones is the total number of zones of the device. This is always
500 * 0 for regular block devices. seq_zones_bitmap is a bitmap of nr_zones
501 * bits which indicates if a zone is conventional (bit clear) or
502 * sequential (bit set). seq_zones_wlock is a bitmap of nr_zones
503 * bits which indicates if a zone is write locked, that is, if a write
504 * request targeting the zone was dispatched. All three fields are
505 * initialized by the low level device driver (e.g. scsi/sd.c).
506 * Stacking drivers (device mappers) may or may not initialize
507 * these fields.
Bart Van Asscheccce20f2018-04-16 18:04:41 -0700508 *
509 * Reads of this information must be protected with blk_queue_enter() /
510 * blk_queue_exit(). Modifying this information is only allowed while
511 * no requests are being processed. See also blk_mq_freeze_queue() and
512 * blk_mq_unfreeze_queue().
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900513 */
514 unsigned int nr_zones;
515 unsigned long *seq_zones_bitmap;
516 unsigned long *seq_zones_wlock;
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700517#endif /* CONFIG_BLK_DEV_ZONED */
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900518
519 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700520 * sg stuff
521 */
522 unsigned int sg_timeout;
523 unsigned int sg_reserved_size;
Christoph Lameter19460892005-06-23 00:08:19 -0700524 int node;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700525#ifdef CONFIG_BLK_DEV_IO_TRACE
Jens Axboe2056a782006-03-23 20:00:26 +0100526 struct blk_trace *blk_trace;
Waiman Long5acb3cc2017-09-20 13:12:20 -0600527 struct mutex blk_trace_mutex;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700528#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700529 /*
Tejun Heo4913efe2010-09-03 11:56:16 +0200530 * for flush operations
Linus Torvalds1da177e2005-04-16 15:20:36 -0700531 */
Ming Lei7c94e1c2014-09-25 23:23:43 +0800532 struct blk_flush_queue *fq;
Al Viro483f4af2006-03-18 18:34:37 -0500533
Christoph Hellwig6fca6a62014-05-28 08:08:02 -0600534 struct list_head requeue_list;
535 spinlock_t requeue_lock;
Mike Snitzer28494502016-09-14 13:28:30 -0400536 struct delayed_work requeue_work;
Christoph Hellwig6fca6a62014-05-28 08:08:02 -0600537
Al Viro483f4af2006-03-18 18:34:37 -0500538 struct mutex sysfs_lock;
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200539
Christoph Hellwig4ecd4fe2015-05-07 09:38:13 +0200540 atomic_t mq_freeze_depth;
Tejun Heod7325802012-03-05 13:14:58 -0800541
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200542#if defined(CONFIG_BLK_DEV_BSG)
543 struct bsg_class_device bsg_dev;
544#endif
Vivek Goyale43473b2010-09-15 17:06:35 -0400545
546#ifdef CONFIG_BLK_DEV_THROTTLING
547 /* Throttle data */
548 struct throtl_data *td;
549#endif
Tejun Heo548bc8e2013-01-09 08:05:13 -0800550 struct rcu_head rcu_head;
Jens Axboe320ae512013-10-24 09:20:05 +0100551 wait_queue_head_t mq_freeze_wq;
Dan Williams3ef28e82015-10-21 13:20:12 -0400552 struct percpu_ref q_usage_counter;
Jens Axboe320ae512013-10-24 09:20:05 +0100553 struct list_head all_q_node;
Jens Axboe0d2602c2014-05-13 15:10:52 -0600554
555 struct blk_mq_tag_set *tag_set;
556 struct list_head tag_set_list;
Kent Overstreet338aa962018-05-20 18:25:47 -0400557 struct bio_set bio_split;
Akinobu Mita4593fdb2015-09-27 02:09:20 +0900558
Omar Sandoval03796c12017-01-31 14:53:18 -0800559#ifdef CONFIG_BLK_DEBUG_FS
Omar Sandoval07e4fea2017-01-25 08:06:40 -0800560 struct dentry *debugfs_dir;
Omar Sandovald332ce02017-05-04 08:24:40 -0600561 struct dentry *sched_debugfs_dir;
Ming Leicc566942018-12-17 09:46:00 +0800562 struct dentry *rqos_debugfs_dir;
Omar Sandoval07e4fea2017-01-25 08:06:40 -0800563#endif
564
Akinobu Mita4593fdb2015-09-27 02:09:20 +0900565 bool mq_sysfs_init_done;
Christoph Hellwig6d247d72017-01-27 09:51:45 -0700566
567 size_t cmd_size;
Bart Van Asschedc9edc42017-06-14 13:27:50 -0600568
569 struct work_struct release_work;
Jens Axboef793dfd2017-06-26 08:15:27 -0600570
571#define BLK_MAX_WRITE_HINTS 5
572 u64 write_hints[BLK_MAX_WRITE_HINTS];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700573};
574
Jens Axboee743eb12017-08-10 08:25:38 -0600575#define QUEUE_FLAG_STOPPED 1 /* queue is stopped */
576#define QUEUE_FLAG_DYING 2 /* queue being torn down */
Jens Axboee743eb12017-08-10 08:25:38 -0600577#define QUEUE_FLAG_BIDI 4 /* queue supports bidi requests */
578#define QUEUE_FLAG_NOMERGES 5 /* disable merge attempts */
579#define QUEUE_FLAG_SAME_COMP 6 /* complete on same CPU-group */
580#define QUEUE_FLAG_FAIL_IO 7 /* fake timeout */
Jens Axboee743eb12017-08-10 08:25:38 -0600581#define QUEUE_FLAG_NONROT 9 /* non-rotational device (SSD) */
Fernando Luis Vázquez Cao88e740f2008-10-27 18:44:46 +0900582#define QUEUE_FLAG_VIRT QUEUE_FLAG_NONROT /* paravirt device */
Konstantin Khlebnikov4822e902018-10-11 10:07:06 +0300583#define QUEUE_FLAG_IO_STAT 10 /* do disk/partitions IO accounting */
Jens Axboee743eb12017-08-10 08:25:38 -0600584#define QUEUE_FLAG_DISCARD 11 /* supports DISCARD */
585#define QUEUE_FLAG_NOXMERGES 12 /* No extended merges */
586#define QUEUE_FLAG_ADD_RANDOM 13 /* Contributes to random pool */
587#define QUEUE_FLAG_SECERASE 14 /* supports secure erase */
588#define QUEUE_FLAG_SAME_FORCE 15 /* force complete on same CPU */
589#define QUEUE_FLAG_DEAD 16 /* queue tear-down finished */
590#define QUEUE_FLAG_INIT_DONE 17 /* queue is initialized */
591#define QUEUE_FLAG_NO_SG_MERGE 18 /* don't attempt to merge SG segments*/
592#define QUEUE_FLAG_POLL 19 /* IO polling enabled if set */
593#define QUEUE_FLAG_WC 20 /* Write back caching */
594#define QUEUE_FLAG_FUA 21 /* device supports FUA writes */
595#define QUEUE_FLAG_FLUSH_NQ 22 /* flush not queueuable */
596#define QUEUE_FLAG_DAX 23 /* device supports DAX */
Konstantin Khlebnikov4822e902018-10-11 10:07:06 +0300597#define QUEUE_FLAG_STATS 24 /* track IO start and completion times */
Jens Axboee743eb12017-08-10 08:25:38 -0600598#define QUEUE_FLAG_POLL_STATS 25 /* collecting stats for hybrid polling */
599#define QUEUE_FLAG_REGISTERED 26 /* queue has been registered to a disk */
600#define QUEUE_FLAG_SCSI_PASSTHROUGH 27 /* queue supports SCSI commands */
601#define QUEUE_FLAG_QUIESCED 28 /* queue has been quiesced */
Linus Torvaldsbd6bf7c2018-10-25 06:50:48 -0700602#define QUEUE_FLAG_PCI_P2PDMA 29 /* device supports PCI p2p requests */
Jens Axboebc58ba92009-01-23 10:54:44 +0100603
604#define QUEUE_FLAG_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
Jens Axboee2e1a142010-06-09 10:42:09 +0200605 (1 << QUEUE_FLAG_SAME_COMP) | \
606 (1 << QUEUE_FLAG_ADD_RANDOM))
Tejun Heo797e7db2006-01-06 09:51:03 +0100607
Jens Axboe94eddfb2013-11-19 09:25:07 -0700608#define QUEUE_FLAG_MQ_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
Jens Axboe6e0de612018-12-05 06:50:40 -0700609 (1 << QUEUE_FLAG_SAME_COMP))
Jens Axboe94eddfb2013-11-19 09:25:07 -0700610
Bart Van Assche8814ce82018-03-07 17:10:04 -0800611void blk_queue_flag_set(unsigned int flag, struct request_queue *q);
612void blk_queue_flag_clear(unsigned int flag, struct request_queue *q);
613bool blk_queue_flag_test_and_set(unsigned int flag, struct request_queue *q);
Bart Van Assche8814ce82018-03-07 17:10:04 -0800614
Linus Torvalds1da177e2005-04-16 15:20:36 -0700615#define blk_queue_stopped(q) test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100616#define blk_queue_dying(q) test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
Bart Van Asschec246e802012-12-06 14:32:01 +0100617#define blk_queue_dead(q) test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
Jens Axboe320ae512013-10-24 09:20:05 +0100618#define blk_queue_init_done(q) test_bit(QUEUE_FLAG_INIT_DONE, &(q)->queue_flags)
Alan D. Brunelleac9fafa2008-04-29 14:44:19 +0200619#define blk_queue_nomerges(q) test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
Alan D. Brunelle488991e2010-01-29 09:04:08 +0100620#define blk_queue_noxmerges(q) \
621 test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
Jens Axboea68bbddba2008-09-24 13:03:33 +0200622#define blk_queue_nonrot(q) test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
Jens Axboebc58ba92009-01-23 10:54:44 +0100623#define blk_queue_io_stat(q) test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
Jens Axboee2e1a142010-06-09 10:42:09 +0200624#define blk_queue_add_random(q) test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
Christoph Hellwigc15227d2009-09-30 13:52:12 +0200625#define blk_queue_discard(q) test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
Christoph Hellwig288dab82016-06-09 16:00:36 +0200626#define blk_queue_secure_erase(q) \
627 (test_bit(QUEUE_FLAG_SECERASE, &(q)->queue_flags))
Toshi Kani163d4ba2016-06-23 17:05:50 -0400628#define blk_queue_dax(q) test_bit(QUEUE_FLAG_DAX, &(q)->queue_flags)
Bart Van Assche9efc1602017-05-31 14:43:46 -0700629#define blk_queue_scsi_passthrough(q) \
630 test_bit(QUEUE_FLAG_SCSI_PASSTHROUGH, &(q)->queue_flags)
Logan Gunthorpe49d92c02018-10-04 15:27:41 -0600631#define blk_queue_pci_p2pdma(q) \
632 test_bit(QUEUE_FLAG_PCI_P2PDMA, &(q)->queue_flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700633
Christoph Hellwig33659eb2010-08-07 18:17:56 +0200634#define blk_noretry_request(rq) \
635 ((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
636 REQ_FAILFAST_DRIVER))
Ming Leif4560ff2017-06-18 14:24:27 -0600637#define blk_queue_quiesced(q) test_bit(QUEUE_FLAG_QUIESCED, &(q)->queue_flags)
Bart Van Asschecd84a622018-09-26 14:01:04 -0700638#define blk_queue_pm_only(q) atomic_read(&(q)->pm_only)
Dave Chinner0ce91442018-04-18 14:08:27 +1000639#define blk_queue_fua(q) test_bit(QUEUE_FLAG_FUA, &(q)->queue_flags)
Bart Van Asschec9254f22017-11-09 10:49:57 -0800640
Bart Van Asschecd84a622018-09-26 14:01:04 -0700641extern void blk_set_pm_only(struct request_queue *q);
642extern void blk_clear_pm_only(struct request_queue *q);
Jens Axboe4aff5e22006-08-10 08:44:47 +0200643
Christoph Hellwig57292b52017-01-31 16:57:29 +0100644static inline bool blk_account_rq(struct request *rq)
645{
646 return (rq->rq_flags & RQF_STARTED) && !blk_rq_is_passthrough(rq);
647}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700648
FUJITA Tomonoriabae1fd2007-07-16 08:52:14 +0200649#define blk_bidi_rq(rq) ((rq)->next_rq != NULL)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700650
651#define list_entry_rq(ptr) list_entry((ptr), struct request, queuelist)
652
Mike Christie4e1b2d522016-06-05 14:32:22 -0500653#define rq_data_dir(rq) (op_is_write(req_op(rq)) ? WRITE : READ)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700654
Jens Axboe344e9ff2018-11-15 12:22:51 -0700655static inline bool queue_is_mq(struct request_queue *q)
Jens Axboe49fd5242014-04-16 10:57:18 -0600656{
Jens Axboea1ce35f2018-10-29 10:23:51 -0600657 return q->mq_ops;
Jens Axboe49fd5242014-04-16 10:57:18 -0600658}
659
Damien Le Moal797476b2016-10-18 15:40:29 +0900660static inline enum blk_zoned_model
661blk_queue_zoned_model(struct request_queue *q)
662{
663 return q->limits.zoned;
664}
665
666static inline bool blk_queue_is_zoned(struct request_queue *q)
667{
668 switch (blk_queue_zoned_model(q)) {
669 case BLK_ZONED_HA:
670 case BLK_ZONED_HM:
671 return true;
672 default:
673 return false;
674 }
675}
676
Damien Le Moalf99e8642017-01-12 07:58:32 -0700677static inline unsigned int blk_queue_zone_sectors(struct request_queue *q)
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900678{
679 return blk_queue_is_zoned(q) ? q->limits.chunk_sectors : 0;
680}
681
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700682#ifdef CONFIG_BLK_DEV_ZONED
Damien Le Moal965b6522018-10-12 19:08:48 +0900683static inline unsigned int blk_queue_nr_zones(struct request_queue *q)
684{
685 return blk_queue_is_zoned(q) ? q->nr_zones : 0;
686}
687
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900688static inline unsigned int blk_queue_zone_no(struct request_queue *q,
689 sector_t sector)
690{
691 if (!blk_queue_is_zoned(q))
692 return 0;
693 return sector >> ilog2(q->limits.chunk_sectors);
694}
695
696static inline bool blk_queue_zone_is_seq(struct request_queue *q,
697 sector_t sector)
698{
699 if (!blk_queue_is_zoned(q) || !q->seq_zones_bitmap)
700 return false;
701 return test_bit(blk_queue_zone_no(q, sector), q->seq_zones_bitmap);
702}
Damien Le Moal965b6522018-10-12 19:08:48 +0900703#else /* CONFIG_BLK_DEV_ZONED */
704static inline unsigned int blk_queue_nr_zones(struct request_queue *q)
705{
706 return 0;
707}
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700708#endif /* CONFIG_BLK_DEV_ZONED */
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900709
Jens Axboe1faa16d2009-04-06 14:48:01 +0200710static inline bool rq_is_sync(struct request *rq)
711{
Christoph Hellwigef295ec2016-10-28 08:48:16 -0600712 return op_is_sync(rq->cmd_flags);
Jens Axboe1faa16d2009-04-06 14:48:01 +0200713}
714
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400715static inline bool rq_mergeable(struct request *rq)
716{
Christoph Hellwig57292b52017-01-31 16:57:29 +0100717 if (blk_rq_is_passthrough(rq))
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400718 return false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700719
Mike Christie3a5e02c2016-06-05 14:32:23 -0500720 if (req_op(rq) == REQ_OP_FLUSH)
721 return false;
722
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800723 if (req_op(rq) == REQ_OP_WRITE_ZEROES)
724 return false;
725
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400726 if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
727 return false;
Christoph Hellwige8064022016-10-20 15:12:13 +0200728 if (rq->rq_flags & RQF_NOMERGE_FLAGS)
729 return false;
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400730
731 return true;
732}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700733
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400734static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
735{
Christoph Hellwigefbeccd2017-06-19 09:24:41 +0200736 if (bio_page(a) == bio_page(b) &&
737 bio_offset(a) == bio_offset(b))
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400738 return true;
739
740 return false;
741}
742
Jens Axboed278d4a2016-03-30 10:21:08 -0600743static inline unsigned int blk_queue_depth(struct request_queue *q)
744{
745 if (q->queue_depth)
746 return q->queue_depth;
747
748 return q->nr_requests;
749}
750
Linus Torvalds1da177e2005-04-16 15:20:36 -0700751extern unsigned long blk_max_low_pfn, blk_max_pfn;
752
753/*
754 * standard bounce addresses:
755 *
756 * BLK_BOUNCE_HIGH : bounce all highmem pages
757 * BLK_BOUNCE_ANY : don't bounce anything
758 * BLK_BOUNCE_ISA : bounce pages above ISA DMA boundary
759 */
Andi Kleen24728922008-04-21 09:51:05 +0200760
761#if BITS_PER_LONG == 32
Linus Torvalds1da177e2005-04-16 15:20:36 -0700762#define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
Andi Kleen24728922008-04-21 09:51:05 +0200763#else
764#define BLK_BOUNCE_HIGH -1ULL
765#endif
766#define BLK_BOUNCE_ANY (-1ULL)
FUJITA Tomonoribfe17232010-05-31 15:59:03 +0900767#define BLK_BOUNCE_ISA (DMA_BIT_MASK(24))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700768
Jens Axboe3d6392c2007-07-09 12:38:05 +0200769/*
770 * default timeout for SG_IO if none specified
771 */
772#define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
Linus Torvaldsf2f1fa72008-12-05 14:49:18 -0800773#define BLK_MIN_SG_TIMEOUT (7 * HZ)
Jens Axboe3d6392c2007-07-09 12:38:05 +0200774
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900775struct rq_map_data {
776 struct page **pages;
777 int page_order;
778 int nr_entries;
FUJITA Tomonori56c451f2008-12-18 14:49:37 +0900779 unsigned long offset;
FUJITA Tomonori97ae77a2008-12-18 14:49:38 +0900780 int null_mapped;
FUJITA Tomonoriecb554a2009-07-09 14:46:53 +0200781 int from_user;
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900782};
783
NeilBrown5705f702007-09-25 12:35:59 +0200784struct req_iterator {
Kent Overstreet79886132013-11-23 17:19:00 -0800785 struct bvec_iter iter;
NeilBrown5705f702007-09-25 12:35:59 +0200786 struct bio *bio;
787};
788
789/* This should not be used directly - use rq_for_each_segment */
Jens Axboe1e428072009-02-23 09:03:10 +0100790#define for_each_bio(_bio) \
791 for (; _bio; _bio = _bio->bi_next)
NeilBrown5705f702007-09-25 12:35:59 +0200792#define __rq_for_each_bio(_bio, rq) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700793 if ((rq->bio)) \
794 for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
795
NeilBrown5705f702007-09-25 12:35:59 +0200796#define rq_for_each_segment(bvl, _rq, _iter) \
797 __rq_for_each_bio(_iter.bio, _rq) \
Kent Overstreet79886132013-11-23 17:19:00 -0800798 bio_for_each_segment(bvl, _iter.bio, _iter.iter)
NeilBrown5705f702007-09-25 12:35:59 +0200799
Kent Overstreet4550dd62013-08-07 14:26:21 -0700800#define rq_iter_last(bvec, _iter) \
Kent Overstreet79886132013-11-23 17:19:00 -0800801 (_iter.bio->bi_next == NULL && \
Kent Overstreet4550dd62013-08-07 14:26:21 -0700802 bio_iter_last(bvec, _iter.iter))
NeilBrown5705f702007-09-25 12:35:59 +0200803
Ilya Loginov2d4dc892009-11-26 09:16:19 +0100804#ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
805# error "You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
806#endif
807#if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
808extern void rq_flush_dcache_pages(struct request *rq);
809#else
810static inline void rq_flush_dcache_pages(struct request *rq)
811{
812}
813#endif
814
Linus Torvalds1da177e2005-04-16 15:20:36 -0700815extern int blk_register_queue(struct gendisk *disk);
816extern void blk_unregister_queue(struct gendisk *disk);
Jens Axboedece1632015-11-05 10:41:16 -0700817extern blk_qc_t generic_make_request(struct bio *bio);
Christoph Hellwigf421e1d2017-11-02 21:29:50 +0300818extern blk_qc_t direct_make_request(struct bio *bio);
FUJITA Tomonori2a4aa302008-04-29 09:54:36 +0200819extern void blk_rq_init(struct request_queue *q, struct request *rq);
Bart Van Asscheda8d7f02017-04-19 14:01:24 -0700820extern void blk_init_request_from_bio(struct request *req, struct bio *bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700821extern void blk_put_request(struct request *);
Bart Van Asschecd6ce142017-06-20 11:15:39 -0700822extern struct request *blk_get_request(struct request_queue *, unsigned int op,
Christoph Hellwigff005a02018-05-09 09:54:05 +0200823 blk_mq_req_flags_t flags);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200824extern int blk_lld_busy(struct request_queue *q);
Mike Snitzer78d8e582015-06-26 10:01:13 -0400825extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
826 struct bio_set *bs, gfp_t gfp_mask,
827 int (*bio_ctr)(struct bio *, struct bio *, void *),
828 void *data);
829extern void blk_rq_unprep_clone(struct request *rq);
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200830extern blk_status_t blk_insert_cloned_request(struct request_queue *q,
Kiyoshi Ueda82124d62008-09-18 10:45:38 -0400831 struct request *rq);
Jens Axboe0abc2a12017-12-18 15:40:44 +0800832extern int blk_rq_append_bio(struct request *rq, struct bio **bio);
NeilBrownaf67c312017-06-18 14:38:57 +1000833extern void blk_queue_split(struct request_queue *, struct bio **);
Jens Axboe165125e2007-07-24 09:28:11 +0200834extern void blk_recount_segments(struct request_queue *, struct bio *);
Paolo Bonzini0bfc96c2012-01-12 16:01:28 +0100835extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
Paolo Bonzini577ebb32012-01-12 16:01:27 +0100836extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
837 unsigned int, void __user *);
Al Viro74f3c8a2007-08-27 15:38:10 -0400838extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
839 unsigned int, void __user *);
Al Viroe915e872008-09-02 17:16:41 -0400840extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
841 struct scsi_ioctl_command __user *);
Andrew Morton3fcfab12006-10-19 23:28:16 -0700842
Bart Van Assche9a95e4e2017-11-09 10:49:59 -0800843extern int blk_queue_enter(struct request_queue *q, blk_mq_req_flags_t flags);
Dan Williams2e6edc952015-11-19 13:29:28 -0800844extern void blk_queue_exit(struct request_queue *q);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700845extern void blk_sync_queue(struct request_queue *q);
FUJITA Tomonoria3bce902008-08-28 16:17:05 +0900846extern int blk_rq_map_user(struct request_queue *, struct request *,
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900847 struct rq_map_data *, void __user *, unsigned long,
848 gfp_t);
Jens Axboe8e5cfc42006-12-19 11:12:46 +0100849extern int blk_rq_unmap_user(struct bio *);
Jens Axboe165125e2007-07-24 09:28:11 +0200850extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
851extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
Kent Overstreet26e49cf2015-01-18 16:16:31 +0100852 struct rq_map_data *, const struct iov_iter *,
853 gfp_t);
Christoph Hellwigb7819b92017-04-20 16:02:55 +0200854extern void blk_execute_rq(struct request_queue *, struct gendisk *,
James Bottomley 994ca9a2005-06-20 14:11:09 +0200855 struct request *, int);
Jens Axboe165125e2007-07-24 09:28:11 +0200856extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
Jens Axboe15fc8582006-01-06 10:00:50 +0100857 struct request *, int, rq_end_io_fn *);
Mike Christie6e39b692005-11-11 05:30:24 -0600858
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200859int blk_status_to_errno(blk_status_t status);
860blk_status_t errno_to_blk_status(int errno);
861
Jens Axboe0a1b8b82018-11-26 08:24:43 -0700862int blk_poll(struct request_queue *q, blk_qc_t cookie, bool spin);
Jens Axboe05229beed2015-11-05 10:44:55 -0700863
Jens Axboe165125e2007-07-24 09:28:11 +0200864static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700865{
Tejun Heoff9ea322014-09-08 08:03:56 +0900866 return bdev->bd_disk->queue; /* this is never NULL */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700867}
868
Linus Torvalds1da177e2005-04-16 15:20:36 -0700869/*
Bart Van Assche233bde22018-03-14 15:48:06 -0700870 * The basic unit of block I/O is a sector. It is used in a number of contexts
871 * in Linux (blk, bio, genhd). The size of one sector is 512 = 2**9
872 * bytes. Variables of type sector_t represent an offset or size that is a
873 * multiple of 512 bytes. Hence these two constants.
874 */
875#ifndef SECTOR_SHIFT
876#define SECTOR_SHIFT 9
877#endif
878#ifndef SECTOR_SIZE
879#define SECTOR_SIZE (1 << SECTOR_SHIFT)
880#endif
881
882/*
Tejun Heo80a761f2009-07-03 17:48:17 +0900883 * blk_rq_pos() : the current sector
884 * blk_rq_bytes() : bytes left in the entire request
885 * blk_rq_cur_bytes() : bytes left in the current segment
886 * blk_rq_err_bytes() : bytes left till the next error boundary
887 * blk_rq_sectors() : sectors left in the entire request
888 * blk_rq_cur_sectors() : sectors left in the current segment
Tejun Heo5efccd12009-04-23 11:05:18 +0900889 */
Tejun Heo5b936292009-05-07 22:24:38 +0900890static inline sector_t blk_rq_pos(const struct request *rq)
891{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900892 return rq->__sector;
Tejun Heo5b936292009-05-07 22:24:38 +0900893}
894
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900895static inline unsigned int blk_rq_bytes(const struct request *rq)
896{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900897 return rq->__data_len;
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900898}
899
900static inline int blk_rq_cur_bytes(const struct request *rq)
901{
902 return rq->bio ? bio_cur_bytes(rq->bio) : 0;
903}
Tejun Heo5efccd12009-04-23 11:05:18 +0900904
Tejun Heo80a761f2009-07-03 17:48:17 +0900905extern unsigned int blk_rq_err_bytes(const struct request *rq);
906
Tejun Heo5b936292009-05-07 22:24:38 +0900907static inline unsigned int blk_rq_sectors(const struct request *rq)
908{
Bart Van Assche233bde22018-03-14 15:48:06 -0700909 return blk_rq_bytes(rq) >> SECTOR_SHIFT;
Tejun Heo5b936292009-05-07 22:24:38 +0900910}
911
912static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
913{
Bart Van Assche233bde22018-03-14 15:48:06 -0700914 return blk_rq_cur_bytes(rq) >> SECTOR_SHIFT;
Tejun Heo5b936292009-05-07 22:24:38 +0900915}
916
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700917#ifdef CONFIG_BLK_DEV_ZONED
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900918static inline unsigned int blk_rq_zone_no(struct request *rq)
919{
920 return blk_queue_zone_no(rq->q, blk_rq_pos(rq));
921}
922
923static inline unsigned int blk_rq_zone_is_seq(struct request *rq)
924{
925 return blk_queue_zone_is_seq(rq->q, blk_rq_pos(rq));
926}
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700927#endif /* CONFIG_BLK_DEV_ZONED */
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900928
Christoph Hellwig2e3258e2017-01-13 12:29:10 +0100929/*
930 * Some commands like WRITE SAME have a payload or data transfer size which
931 * is different from the size of the request. Any driver that supports such
932 * commands using the RQF_SPECIAL_PAYLOAD flag needs to use this helper to
933 * calculate the data transfer size.
934 */
935static inline unsigned int blk_rq_payload_bytes(struct request *rq)
936{
937 if (rq->rq_flags & RQF_SPECIAL_PAYLOAD)
938 return rq->special_vec.bv_len;
939 return blk_rq_bytes(rq);
940}
941
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400942static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
Mike Christie8fe0d472016-06-05 14:32:15 -0500943 int op)
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400944{
Adrian Hunter7afafc82016-08-16 10:59:35 +0300945 if (unlikely(op == REQ_OP_DISCARD || op == REQ_OP_SECURE_ERASE))
Bart Van Assche233bde22018-03-14 15:48:06 -0700946 return min(q->limits.max_discard_sectors,
947 UINT_MAX >> SECTOR_SHIFT);
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400948
Mike Christie8fe0d472016-06-05 14:32:15 -0500949 if (unlikely(op == REQ_OP_WRITE_SAME))
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400950 return q->limits.max_write_same_sectors;
951
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800952 if (unlikely(op == REQ_OP_WRITE_ZEROES))
953 return q->limits.max_write_zeroes_sectors;
954
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400955 return q->limits.max_sectors;
956}
957
Jens Axboe762380a2014-06-05 13:38:39 -0600958/*
959 * Return maximum size of a request at given offset. Only valid for
960 * file system requests.
961 */
962static inline unsigned int blk_max_size_offset(struct request_queue *q,
963 sector_t offset)
964{
965 if (!q->limits.chunk_sectors)
Jens Axboe736ed4d2014-06-17 22:09:29 -0700966 return q->limits.max_sectors;
Jens Axboe762380a2014-06-05 13:38:39 -0600967
Keith Busch15bfd212018-06-26 09:14:58 -0600968 return min(q->limits.max_sectors, (unsigned int)(q->limits.chunk_sectors -
969 (offset & (q->limits.chunk_sectors - 1))));
Jens Axboe762380a2014-06-05 13:38:39 -0600970}
971
Damien Le Moal17007f32016-07-20 21:40:47 -0600972static inline unsigned int blk_rq_get_max_sectors(struct request *rq,
973 sector_t offset)
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400974{
975 struct request_queue *q = rq->q;
976
Christoph Hellwig57292b52017-01-31 16:57:29 +0100977 if (blk_rq_is_passthrough(rq))
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400978 return q->limits.max_hw_sectors;
979
Adrian Hunter7afafc82016-08-16 10:59:35 +0300980 if (!q->limits.chunk_sectors ||
981 req_op(rq) == REQ_OP_DISCARD ||
982 req_op(rq) == REQ_OP_SECURE_ERASE)
Mike Christie8fe0d472016-06-05 14:32:15 -0500983 return blk_queue_get_max_sectors(q, req_op(rq));
Jens Axboe762380a2014-06-05 13:38:39 -0600984
Damien Le Moal17007f32016-07-20 21:40:47 -0600985 return min(blk_max_size_offset(q, offset),
Mike Christie8fe0d472016-06-05 14:32:15 -0500986 blk_queue_get_max_sectors(q, req_op(rq)));
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400987}
988
Jun'ichi Nomura75afb352013-09-21 13:57:47 -0600989static inline unsigned int blk_rq_count_bios(struct request *rq)
990{
991 unsigned int nr_bios = 0;
992 struct bio *bio;
993
994 __rq_for_each_bio(bio, rq)
995 nr_bios++;
996
997 return nr_bios;
998}
999
Christoph Hellwigef71de82017-11-02 21:29:51 +03001000void blk_steal_bios(struct bio_list *list, struct request *rq);
1001
Tejun Heo9934c8c2009-05-08 11:54:16 +09001002/*
Tejun Heo2e60e022009-04-23 11:05:18 +09001003 * Request completion related functions.
1004 *
1005 * blk_update_request() completes given number of bytes and updates
1006 * the request without completing it.
1007 *
Tejun Heof06d9a22009-04-23 11:05:19 +09001008 * blk_end_request() and friends. __blk_end_request() must be called
1009 * with the request queue spinlock acquired.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001010 *
1011 * Several drivers define their own end_request and call
Kiyoshi Ueda3bcddea2007-12-11 17:52:28 -05001012 * blk_end_request() for parts of the original function.
1013 * This prevents code duplication in drivers.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001014 */
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001015extern bool blk_update_request(struct request *rq, blk_status_t error,
Tejun Heo2e60e022009-04-23 11:05:18 +09001016 unsigned int nr_bytes);
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001017extern void blk_end_request_all(struct request *rq, blk_status_t error);
1018extern bool __blk_end_request(struct request *rq, blk_status_t error,
FUJITA Tomonorib1f74492009-05-11 17:56:09 +09001019 unsigned int nr_bytes);
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001020extern void __blk_end_request_all(struct request *rq, blk_status_t error);
1021extern bool __blk_end_request_cur(struct request *rq, blk_status_t error);
Tejun Heo2e60e022009-04-23 11:05:18 +09001022
Jens Axboe242f9dc2008-09-14 05:55:09 -07001023extern void __blk_complete_request(struct request *);
1024extern void blk_abort_request(struct request *);
Jens Axboeff856ba2006-01-09 16:02:34 +01001025
Linus Torvalds1da177e2005-04-16 15:20:36 -07001026/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07001027 * Access functions for manipulating queue properties
1028 */
Jens Axboe165125e2007-07-24 09:28:11 +02001029extern void blk_cleanup_queue(struct request_queue *);
1030extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
1031extern void blk_queue_bounce_limit(struct request_queue *, u64);
Martin K. Petersen086fa5f2010-02-26 00:20:38 -05001032extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
Jens Axboe762380a2014-06-05 13:38:39 -06001033extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
Martin K. Petersen8a783622010-02-26 00:20:39 -05001034extern void blk_queue_max_segments(struct request_queue *, unsigned short);
Christoph Hellwig1e739732017-02-08 14:46:49 +01001035extern void blk_queue_max_discard_segments(struct request_queue *,
1036 unsigned short);
Jens Axboe165125e2007-07-24 09:28:11 +02001037extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
Christoph Hellwig67efc922009-09-30 13:54:20 +02001038extern void blk_queue_max_discard_sectors(struct request_queue *q,
1039 unsigned int max_discard_sectors);
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001040extern void blk_queue_max_write_same_sectors(struct request_queue *q,
1041 unsigned int max_write_same_sectors);
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -08001042extern void blk_queue_max_write_zeroes_sectors(struct request_queue *q,
1043 unsigned int max_write_same_sectors);
Martin K. Petersene1defc42009-05-22 17:17:49 -04001044extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001045extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001046extern void blk_queue_alignment_offset(struct request_queue *q,
1047 unsigned int alignment);
Martin K. Petersen7c958e32009-07-31 11:49:11 -04001048extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001049extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
Martin K. Petersen3c5820c2009-09-11 21:54:52 +02001050extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001051extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
Jens Axboed278d4a2016-03-30 10:21:08 -06001052extern void blk_set_queue_depth(struct request_queue *q, unsigned int depth);
Martin K. Petersene475bba2009-06-16 08:23:52 +02001053extern void blk_set_default_limits(struct queue_limits *lim);
Martin K. Petersenb1bd0552012-01-11 16:27:11 +01001054extern void blk_set_stacking_limits(struct queue_limits *lim);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001055extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
1056 sector_t offset);
Martin K. Petersen17be8c22010-01-11 03:21:49 -05001057extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
1058 sector_t offset);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001059extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
1060 sector_t offset);
Jens Axboe165125e2007-07-24 09:28:11 +02001061extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
Tejun Heoe3790c72008-03-04 11:18:17 +01001062extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
FUJITA Tomonori27f82212008-07-04 09:30:03 +02001063extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
Tejun Heo2fb98e82008-02-19 11:36:53 +01001064extern int blk_queue_dma_drain(struct request_queue *q,
1065 dma_drain_needed_fn *dma_drain_needed,
1066 void *buf, unsigned int size);
Jens Axboe165125e2007-07-24 09:28:11 +02001067extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
Keith Busch03100aa2015-08-19 14:24:05 -07001068extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
Jens Axboe165125e2007-07-24 09:28:11 +02001069extern void blk_queue_dma_alignment(struct request_queue *, int);
James Bottomley11c3e682007-12-31 16:37:00 -06001070extern void blk_queue_update_dma_alignment(struct request_queue *, int);
Jens Axboe242f9dc2008-09-14 05:55:09 -07001071extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001072extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
Jens Axboe93e9d8e2016-04-12 12:32:46 -06001073extern void blk_queue_write_cache(struct request_queue *q, bool enabled, bool fua);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001074
Christoph Hellwig1e739732017-02-08 14:46:49 +01001075/*
1076 * Number of physical segments as sent to the device.
1077 *
1078 * Normally this is the number of discontiguous data segments sent by the
1079 * submitter. But for data-less command like discard we might have no
1080 * actual data segments submitted, but the driver might have to add it's
1081 * own special payload. In that case we still return 1 here so that this
1082 * special payload will be mapped.
1083 */
Christoph Hellwigf9d03f92016-12-08 15:20:32 -07001084static inline unsigned short blk_rq_nr_phys_segments(struct request *rq)
1085{
1086 if (rq->rq_flags & RQF_SPECIAL_PAYLOAD)
1087 return 1;
1088 return rq->nr_phys_segments;
1089}
1090
Christoph Hellwig1e739732017-02-08 14:46:49 +01001091/*
1092 * Number of discard segments (or ranges) the driver needs to fill in.
1093 * Each discard bio merged into a request is counted as one segment.
1094 */
1095static inline unsigned short blk_rq_nr_discard_segments(struct request *rq)
1096{
1097 return max_t(unsigned short, rq->nr_phys_segments, 1);
1098}
1099
Jens Axboe165125e2007-07-24 09:28:11 +02001100extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001101extern void blk_dump_rq_flags(struct request *, char *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001102extern long nr_blockdev_pages(void);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001103
Tejun Heo09ac46c2011-12-14 00:33:38 +01001104bool __must_check blk_get_queue(struct request_queue *);
Jens Axboe165125e2007-07-24 09:28:11 +02001105struct request_queue *blk_alloc_queue(gfp_t);
Christoph Hellwig6d469642018-11-14 17:02:18 +01001106struct request_queue *blk_alloc_queue_node(gfp_t gfp_mask, int node_id);
Jens Axboe165125e2007-07-24 09:28:11 +02001107extern void blk_put_queue(struct request_queue *);
Jens Axboe3f21c262015-06-05 10:57:37 -06001108extern void blk_set_queue_dying(struct request_queue *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001109
Shaohua Li316cc672011-07-08 08:19:21 +02001110/*
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001111 * blk_plug permits building a queue of related requests by holding the I/O
1112 * fragments for a short period. This allows merging of sequential requests
1113 * into single larger request. As the requests are moved from a per-task list to
1114 * the device's request_queue in a batch, this results in improved scalability
1115 * as the lock contention for request_queue lock is reduced.
1116 *
1117 * It is ok not to disable preemption when adding the request to the plug list
1118 * or when attempting a merge, because blk_schedule_flush_list() will only flush
1119 * the plug list when the task sleeps by itself. For details, please see
1120 * schedule() where blk_schedule_flush_plug() is called.
Shaohua Li316cc672011-07-08 08:19:21 +02001121 */
Jens Axboe73c10102011-03-08 13:19:51 +01001122struct blk_plug {
Jens Axboe320ae512013-10-24 09:20:05 +01001123 struct list_head mq_list; /* blk-mq requests */
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001124 struct list_head cb_list; /* md requires an unplug callback */
Jens Axboe5f0ed772018-11-23 22:04:33 -07001125 unsigned short rq_count;
Jens Axboece5b0092018-11-27 17:13:56 -07001126 bool multiple_queues;
Jens Axboe73c10102011-03-08 13:19:51 +01001127};
Shaohua Li55c022b2011-07-08 08:19:20 +02001128#define BLK_MAX_REQUEST_COUNT 16
Shaohua Li50d24c32016-11-03 17:03:53 -07001129#define BLK_PLUG_FLUSH_SIZE (128 * 1024)
Shaohua Li55c022b2011-07-08 08:19:20 +02001130
NeilBrown9cbb1752012-07-31 09:08:14 +02001131struct blk_plug_cb;
NeilBrown74018dc2012-07-31 09:08:15 +02001132typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
NeilBrown048c9372011-04-18 09:52:22 +02001133struct blk_plug_cb {
1134 struct list_head list;
NeilBrown9cbb1752012-07-31 09:08:14 +02001135 blk_plug_cb_fn callback;
1136 void *data;
NeilBrown048c9372011-04-18 09:52:22 +02001137};
NeilBrown9cbb1752012-07-31 09:08:14 +02001138extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
1139 void *data, int size);
Jens Axboe73c10102011-03-08 13:19:51 +01001140extern void blk_start_plug(struct blk_plug *);
1141extern void blk_finish_plug(struct blk_plug *);
Jens Axboef6603782011-04-15 15:49:07 +02001142extern void blk_flush_plug_list(struct blk_plug *, bool);
Jens Axboe73c10102011-03-08 13:19:51 +01001143
1144static inline void blk_flush_plug(struct task_struct *tsk)
1145{
1146 struct blk_plug *plug = tsk->plug;
1147
Christoph Hellwig88b996c2011-04-15 15:20:10 +02001148 if (plug)
Jens Axboea237c1c2011-04-16 13:27:55 +02001149 blk_flush_plug_list(plug, false);
1150}
1151
1152static inline void blk_schedule_flush_plug(struct task_struct *tsk)
1153{
1154 struct blk_plug *plug = tsk->plug;
1155
1156 if (plug)
Jens Axboef6603782011-04-15 15:49:07 +02001157 blk_flush_plug_list(plug, true);
Jens Axboe73c10102011-03-08 13:19:51 +01001158}
1159
1160static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1161{
1162 struct blk_plug *plug = tsk->plug;
1163
Jens Axboe320ae512013-10-24 09:20:05 +01001164 return plug &&
Jens Axboea1ce35f2018-10-29 10:23:51 -06001165 (!list_empty(&plug->mq_list) ||
Jens Axboe320ae512013-10-24 09:20:05 +01001166 !list_empty(&plug->cb_list));
Jens Axboe73c10102011-03-08 13:19:51 +01001167}
1168
Christoph Hellwigee472d82017-04-05 19:21:08 +02001169extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
1170extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
1171 sector_t nr_sects, gfp_t gfp_mask, struct page *page);
Christoph Hellwige950fdf2016-07-19 11:23:33 +02001172
1173#define BLKDEV_DISCARD_SECURE (1 << 0) /* issue a secure erase */
Christoph Hellwigdd3932e2010-09-16 20:51:46 +02001174
Dmitry Monakhovfbd9b092010-04-28 17:55:06 +04001175extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1176 sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
Christoph Hellwig38f25252016-04-16 14:55:28 -04001177extern int __blkdev_issue_discard(struct block_device *bdev, sector_t sector,
Christoph Hellwig288dab82016-06-09 16:00:36 +02001178 sector_t nr_sects, gfp_t gfp_mask, int flags,
Mike Christie469e3212016-06-05 14:31:49 -05001179 struct bio **biop);
Christoph Hellwigee472d82017-04-05 19:21:08 +02001180
1181#define BLKDEV_ZERO_NOUNMAP (1 << 0) /* do not free blocks */
Christoph Hellwigcb365b92017-04-05 19:21:10 +02001182#define BLKDEV_ZERO_NOFALLBACK (1 << 1) /* don't write explicit zeroes */
Christoph Hellwigee472d82017-04-05 19:21:08 +02001183
Chaitanya Kulkarnie73c23f2016-11-30 12:28:58 -08001184extern int __blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
1185 sector_t nr_sects, gfp_t gfp_mask, struct bio **biop,
Christoph Hellwigee472d82017-04-05 19:21:08 +02001186 unsigned flags);
Dmitry Monakhov3f14d792010-04-28 17:55:09 +04001187extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
Christoph Hellwigee472d82017-04-05 19:21:08 +02001188 sector_t nr_sects, gfp_t gfp_mask, unsigned flags);
1189
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001190static inline int sb_issue_discard(struct super_block *sb, sector_t block,
1191 sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
David Woodhousefb2dce82008-08-05 18:01:53 +01001192{
Bart Van Assche233bde22018-03-14 15:48:06 -07001193 return blkdev_issue_discard(sb->s_bdev,
1194 block << (sb->s_blocksize_bits -
1195 SECTOR_SHIFT),
1196 nr_blocks << (sb->s_blocksize_bits -
1197 SECTOR_SHIFT),
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001198 gfp_mask, flags);
David Woodhousefb2dce82008-08-05 18:01:53 +01001199}
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001200static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
Theodore Ts'oa107e5a2010-10-27 23:44:47 -04001201 sector_t nr_blocks, gfp_t gfp_mask)
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001202{
1203 return blkdev_issue_zeroout(sb->s_bdev,
Bart Van Assche233bde22018-03-14 15:48:06 -07001204 block << (sb->s_blocksize_bits -
1205 SECTOR_SHIFT),
1206 nr_blocks << (sb->s_blocksize_bits -
1207 SECTOR_SHIFT),
Christoph Hellwigee472d82017-04-05 19:21:08 +02001208 gfp_mask, 0);
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001209}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001210
Christoph Hellwigf00c4d82017-11-05 10:36:31 +03001211extern int blk_verify_command(unsigned char *cmd, fmode_t mode);
Adel Gadllah0b07de82008-06-26 13:48:27 +02001212
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001213enum blk_default_limits {
1214 BLK_MAX_SEGMENTS = 128,
1215 BLK_SAFE_MAX_SECTORS = 255,
Jeff Moyerd2be5372015-08-13 14:57:57 -04001216 BLK_DEF_MAX_SECTORS = 2560,
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001217 BLK_MAX_SEGMENT_SIZE = 65536,
1218 BLK_SEG_BOUNDARY_MASK = 0xFFFFFFFFUL,
1219};
Milan Broz0e435ac2008-12-03 12:55:08 +01001220
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001221static inline unsigned long queue_segment_boundary(struct request_queue *q)
1222{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001223 return q->limits.seg_boundary_mask;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001224}
1225
Keith Busch03100aa2015-08-19 14:24:05 -07001226static inline unsigned long queue_virt_boundary(struct request_queue *q)
1227{
1228 return q->limits.virt_boundary_mask;
1229}
1230
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001231static inline unsigned int queue_max_sectors(struct request_queue *q)
1232{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001233 return q->limits.max_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001234}
1235
1236static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1237{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001238 return q->limits.max_hw_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001239}
1240
Martin K. Petersen8a783622010-02-26 00:20:39 -05001241static inline unsigned short queue_max_segments(struct request_queue *q)
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001242{
Martin K. Petersen8a783622010-02-26 00:20:39 -05001243 return q->limits.max_segments;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001244}
1245
Christoph Hellwig1e739732017-02-08 14:46:49 +01001246static inline unsigned short queue_max_discard_segments(struct request_queue *q)
1247{
1248 return q->limits.max_discard_segments;
1249}
1250
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001251static inline unsigned int queue_max_segment_size(struct request_queue *q)
1252{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001253 return q->limits.max_segment_size;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001254}
1255
Martin K. Petersene1defc42009-05-22 17:17:49 -04001256static inline unsigned short queue_logical_block_size(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001257{
1258 int retval = 512;
1259
Martin K. Petersen025146e2009-05-22 17:17:51 -04001260 if (q && q->limits.logical_block_size)
1261 retval = q->limits.logical_block_size;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001262
1263 return retval;
1264}
1265
Martin K. Petersene1defc42009-05-22 17:17:49 -04001266static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001267{
Martin K. Petersene1defc42009-05-22 17:17:49 -04001268 return queue_logical_block_size(bdev_get_queue(bdev));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001269}
1270
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001271static inline unsigned int queue_physical_block_size(struct request_queue *q)
1272{
1273 return q->limits.physical_block_size;
1274}
1275
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001276static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
Martin K. Petersenac481c22009-10-03 20:52:01 +02001277{
1278 return queue_physical_block_size(bdev_get_queue(bdev));
1279}
1280
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001281static inline unsigned int queue_io_min(struct request_queue *q)
1282{
1283 return q->limits.io_min;
1284}
1285
Martin K. Petersenac481c22009-10-03 20:52:01 +02001286static inline int bdev_io_min(struct block_device *bdev)
1287{
1288 return queue_io_min(bdev_get_queue(bdev));
1289}
1290
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001291static inline unsigned int queue_io_opt(struct request_queue *q)
1292{
1293 return q->limits.io_opt;
1294}
1295
Martin K. Petersenac481c22009-10-03 20:52:01 +02001296static inline int bdev_io_opt(struct block_device *bdev)
1297{
1298 return queue_io_opt(bdev_get_queue(bdev));
1299}
1300
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001301static inline int queue_alignment_offset(struct request_queue *q)
1302{
Martin K. Petersenac481c22009-10-03 20:52:01 +02001303 if (q->limits.misaligned)
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001304 return -1;
1305
Martin K. Petersenac481c22009-10-03 20:52:01 +02001306 return q->limits.alignment_offset;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001307}
1308
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001309static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001310{
1311 unsigned int granularity = max(lim->physical_block_size, lim->io_min);
Bart Van Assche233bde22018-03-14 15:48:06 -07001312 unsigned int alignment = sector_div(sector, granularity >> SECTOR_SHIFT)
1313 << SECTOR_SHIFT;
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001314
Mike Snitzerb8839b82014-10-08 18:26:13 -04001315 return (granularity + lim->alignment_offset - alignment) % granularity;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001316}
1317
Martin K. Petersenac481c22009-10-03 20:52:01 +02001318static inline int bdev_alignment_offset(struct block_device *bdev)
1319{
1320 struct request_queue *q = bdev_get_queue(bdev);
1321
1322 if (q->limits.misaligned)
1323 return -1;
1324
1325 if (bdev != bdev->bd_contains)
1326 return bdev->bd_part->alignment_offset;
1327
1328 return q->limits.alignment_offset;
1329}
1330
Martin K. Petersen86b37282009-11-10 11:50:21 +01001331static inline int queue_discard_alignment(struct request_queue *q)
1332{
1333 if (q->limits.discard_misaligned)
1334 return -1;
1335
1336 return q->limits.discard_alignment;
1337}
1338
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001339static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
Martin K. Petersen86b37282009-11-10 11:50:21 +01001340{
Linus Torvalds59771072012-12-19 07:18:35 -08001341 unsigned int alignment, granularity, offset;
Martin K. Petersendd3d1452010-01-11 03:21:48 -05001342
Martin K. Petersena934a002011-05-18 10:37:35 +02001343 if (!lim->max_discard_sectors)
1344 return 0;
1345
Linus Torvalds59771072012-12-19 07:18:35 -08001346 /* Why are these in bytes, not sectors? */
Bart Van Assche233bde22018-03-14 15:48:06 -07001347 alignment = lim->discard_alignment >> SECTOR_SHIFT;
1348 granularity = lim->discard_granularity >> SECTOR_SHIFT;
Linus Torvalds59771072012-12-19 07:18:35 -08001349 if (!granularity)
1350 return 0;
1351
1352 /* Offset of the partition start in 'granularity' sectors */
1353 offset = sector_div(sector, granularity);
1354
1355 /* And why do we do this modulus *again* in blkdev_issue_discard()? */
1356 offset = (granularity + alignment - offset) % granularity;
1357
1358 /* Turn it back into bytes, gaah */
Bart Van Assche233bde22018-03-14 15:48:06 -07001359 return offset << SECTOR_SHIFT;
Martin K. Petersen86b37282009-11-10 11:50:21 +01001360}
1361
Paolo Bonzinic6e66632012-08-02 09:48:50 +02001362static inline int bdev_discard_alignment(struct block_device *bdev)
1363{
1364 struct request_queue *q = bdev_get_queue(bdev);
1365
1366 if (bdev != bdev->bd_contains)
1367 return bdev->bd_part->discard_alignment;
1368
1369 return q->limits.discard_alignment;
1370}
1371
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001372static inline unsigned int bdev_write_same(struct block_device *bdev)
1373{
1374 struct request_queue *q = bdev_get_queue(bdev);
1375
1376 if (q)
1377 return q->limits.max_write_same_sectors;
1378
1379 return 0;
1380}
1381
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -08001382static inline unsigned int bdev_write_zeroes_sectors(struct block_device *bdev)
1383{
1384 struct request_queue *q = bdev_get_queue(bdev);
1385
1386 if (q)
1387 return q->limits.max_write_zeroes_sectors;
1388
1389 return 0;
1390}
1391
Damien Le Moal797476b2016-10-18 15:40:29 +09001392static inline enum blk_zoned_model bdev_zoned_model(struct block_device *bdev)
1393{
1394 struct request_queue *q = bdev_get_queue(bdev);
1395
1396 if (q)
1397 return blk_queue_zoned_model(q);
1398
1399 return BLK_ZONED_NONE;
1400}
1401
1402static inline bool bdev_is_zoned(struct block_device *bdev)
1403{
1404 struct request_queue *q = bdev_get_queue(bdev);
1405
1406 if (q)
1407 return blk_queue_is_zoned(q);
1408
1409 return false;
1410}
1411
Damien Le Moalf99e8642017-01-12 07:58:32 -07001412static inline unsigned int bdev_zone_sectors(struct block_device *bdev)
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +09001413{
1414 struct request_queue *q = bdev_get_queue(bdev);
1415
1416 if (q)
Damien Le Moalf99e8642017-01-12 07:58:32 -07001417 return blk_queue_zone_sectors(q);
Christoph Hellwig6cc77e92017-12-21 15:43:38 +09001418 return 0;
1419}
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +09001420
Jens Axboe165125e2007-07-24 09:28:11 +02001421static inline int queue_dma_alignment(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001422{
Pete Wyckoff482eb682008-01-01 10:23:02 -05001423 return q ? q->dma_alignment : 511;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001424}
1425
Namhyung Kim14417792010-09-15 13:08:27 +02001426static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
FUJITA Tomonori87904072008-08-28 15:05:58 +09001427 unsigned int len)
1428{
1429 unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
Namhyung Kim14417792010-09-15 13:08:27 +02001430 return !(addr & alignment) && !(len & alignment);
FUJITA Tomonori87904072008-08-28 15:05:58 +09001431}
1432
Linus Torvalds1da177e2005-04-16 15:20:36 -07001433/* assumes size > 256 */
1434static inline unsigned int blksize_bits(unsigned int size)
1435{
1436 unsigned int bits = 8;
1437 do {
1438 bits++;
1439 size >>= 1;
1440 } while (size > 256);
1441 return bits;
1442}
1443
Adrian Bunk2befb9e2005-09-10 00:27:17 -07001444static inline unsigned int block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001445{
1446 return bdev->bd_block_size;
1447}
1448
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001449static inline bool queue_flush_queueable(struct request_queue *q)
1450{
Jens Axboec888a8f2016-04-13 13:33:19 -06001451 return !test_bit(QUEUE_FLAG_FLUSH_NQ, &q->queue_flags);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001452}
1453
Linus Torvalds1da177e2005-04-16 15:20:36 -07001454typedef struct {struct page *v;} Sector;
1455
1456unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
1457
1458static inline void put_dev_sector(Sector p)
1459{
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001460 put_page(p.v);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001461}
1462
Jens Axboe59c3d452014-04-08 09:15:35 -06001463int kblockd_schedule_work(struct work_struct *work);
Jens Axboeee63cfa2016-08-24 15:52:48 -06001464int kblockd_schedule_work_on(int cpu, struct work_struct *work);
Jens Axboe818cd1c2017-04-10 09:54:55 -06001465int kblockd_mod_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001466
Linus Torvalds1da177e2005-04-16 15:20:36 -07001467#define MODULE_ALIAS_BLOCKDEV(major,minor) \
1468 MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
1469#define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
1470 MODULE_ALIAS("block-major-" __stringify(major) "-*")
1471
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001472#if defined(CONFIG_BLK_DEV_INTEGRITY)
1473
Martin K. Petersen8288f492014-09-26 19:20:02 -04001474enum blk_integrity_flags {
1475 BLK_INTEGRITY_VERIFY = 1 << 0,
1476 BLK_INTEGRITY_GENERATE = 1 << 1,
Martin K. Petersen3aec2f42014-09-26 19:20:03 -04001477 BLK_INTEGRITY_DEVICE_CAPABLE = 1 << 2,
Martin K. Petersenaae7df52014-09-26 19:20:05 -04001478 BLK_INTEGRITY_IP_CHECKSUM = 1 << 3,
Martin K. Petersen8288f492014-09-26 19:20:02 -04001479};
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001480
Martin K. Petersen18593082014-09-26 19:20:01 -04001481struct blk_integrity_iter {
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001482 void *prot_buf;
1483 void *data_buf;
Martin K. Petersen3be91c42014-09-26 19:19:59 -04001484 sector_t seed;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001485 unsigned int data_size;
Martin K. Petersen3be91c42014-09-26 19:19:59 -04001486 unsigned short interval;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001487 const char *disk_name;
1488};
1489
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +02001490typedef blk_status_t (integrity_processing_fn) (struct blk_integrity_iter *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001491
Martin K. Petersen0f8087e2015-10-21 13:19:33 -04001492struct blk_integrity_profile {
1493 integrity_processing_fn *generate_fn;
1494 integrity_processing_fn *verify_fn;
1495 const char *name;
1496};
1497
Martin K. Petersen25520d52015-10-21 13:19:49 -04001498extern void blk_integrity_register(struct gendisk *, struct blk_integrity *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001499extern void blk_integrity_unregister(struct gendisk *);
Martin K. Petersenad7fce92008-10-01 03:38:39 -04001500extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001501extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
1502 struct scatterlist *);
1503extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001504extern bool blk_integrity_merge_rq(struct request_queue *, struct request *,
1505 struct request *);
1506extern bool blk_integrity_merge_bio(struct request_queue *, struct request *,
1507 struct bio *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001508
Martin K. Petersen25520d52015-10-21 13:19:49 -04001509static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1510{
Dan Williamsac6fc482015-10-21 13:20:18 -04001511 struct blk_integrity *bi = &disk->queue->integrity;
Martin K. Petersen25520d52015-10-21 13:19:49 -04001512
1513 if (!bi->profile)
1514 return NULL;
1515
1516 return bi;
1517}
1518
Jens Axboeb04accc2008-10-02 12:53:22 +02001519static inline
1520struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1521{
Martin K. Petersen25520d52015-10-21 13:19:49 -04001522 return blk_get_integrity(bdev->bd_disk);
Martin K. Petersenb02739b2008-10-02 18:47:49 +02001523}
1524
Martin K. Petersen180b2f92014-09-26 19:19:56 -04001525static inline bool blk_integrity_rq(struct request *rq)
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001526{
Martin K. Petersen180b2f92014-09-26 19:19:56 -04001527 return rq->cmd_flags & REQ_INTEGRITY;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001528}
1529
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001530static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1531 unsigned int segs)
1532{
1533 q->limits.max_integrity_segments = segs;
1534}
1535
1536static inline unsigned short
1537queue_max_integrity_segments(struct request_queue *q)
1538{
1539 return q->limits.max_integrity_segments;
1540}
1541
Greg Edwards359f6422018-07-25 10:22:58 -04001542/**
1543 * bio_integrity_intervals - Return number of integrity intervals for a bio
1544 * @bi: blk_integrity profile for device
1545 * @sectors: Size of the bio in 512-byte sectors
1546 *
1547 * Description: The block layer calculates everything in 512 byte
1548 * sectors but integrity metadata is done in terms of the data integrity
1549 * interval size of the storage device. Convert the block layer sectors
1550 * to the appropriate number of integrity intervals.
1551 */
1552static inline unsigned int bio_integrity_intervals(struct blk_integrity *bi,
1553 unsigned int sectors)
1554{
1555 return sectors >> (bi->interval_exp - 9);
1556}
1557
1558static inline unsigned int bio_integrity_bytes(struct blk_integrity *bi,
1559 unsigned int sectors)
1560{
1561 return bio_integrity_intervals(bi, sectors) * bi->tuple_size;
1562}
1563
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001564#else /* CONFIG_BLK_DEV_INTEGRITY */
1565
Stephen Rothwellfd832402012-01-12 09:17:30 +01001566struct bio;
1567struct block_device;
1568struct gendisk;
1569struct blk_integrity;
1570
1571static inline int blk_integrity_rq(struct request *rq)
1572{
1573 return 0;
1574}
1575static inline int blk_rq_count_integrity_sg(struct request_queue *q,
1576 struct bio *b)
1577{
1578 return 0;
1579}
1580static inline int blk_rq_map_integrity_sg(struct request_queue *q,
1581 struct bio *b,
1582 struct scatterlist *s)
1583{
1584 return 0;
1585}
1586static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
1587{
Michele Curti61a04e52014-10-09 15:30:17 -07001588 return NULL;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001589}
1590static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1591{
1592 return NULL;
1593}
1594static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
1595{
1596 return 0;
1597}
Martin K. Petersen25520d52015-10-21 13:19:49 -04001598static inline void blk_integrity_register(struct gendisk *d,
Stephen Rothwellfd832402012-01-12 09:17:30 +01001599 struct blk_integrity *b)
1600{
Stephen Rothwellfd832402012-01-12 09:17:30 +01001601}
1602static inline void blk_integrity_unregister(struct gendisk *d)
1603{
1604}
1605static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1606 unsigned int segs)
1607{
1608}
1609static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
1610{
1611 return 0;
1612}
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001613static inline bool blk_integrity_merge_rq(struct request_queue *rq,
1614 struct request *r1,
1615 struct request *r2)
Stephen Rothwellfd832402012-01-12 09:17:30 +01001616{
Martin K. Petersencb1a5ab2014-10-28 20:27:43 -06001617 return true;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001618}
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001619static inline bool blk_integrity_merge_bio(struct request_queue *rq,
1620 struct request *r,
1621 struct bio *b)
Stephen Rothwellfd832402012-01-12 09:17:30 +01001622{
Martin K. Petersencb1a5ab2014-10-28 20:27:43 -06001623 return true;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001624}
Martin K. Petersen25520d52015-10-21 13:19:49 -04001625
Greg Edwards359f6422018-07-25 10:22:58 -04001626static inline unsigned int bio_integrity_intervals(struct blk_integrity *bi,
1627 unsigned int sectors)
1628{
1629 return 0;
1630}
1631
1632static inline unsigned int bio_integrity_bytes(struct blk_integrity *bi,
1633 unsigned int sectors)
1634{
1635 return 0;
1636}
1637
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001638#endif /* CONFIG_BLK_DEV_INTEGRITY */
1639
Al Viro08f85852007-10-08 13:26:20 -04001640struct block_device_operations {
Al Virod4430d62008-03-02 09:09:22 -05001641 int (*open) (struct block_device *, fmode_t);
Al Virodb2a1442013-05-05 21:52:57 -04001642 void (*release) (struct gendisk *, fmode_t);
Tejun Heo3f289dc2018-07-18 04:47:36 -07001643 int (*rw_page)(struct block_device *, sector_t, struct page *, unsigned int);
Al Virod4430d62008-03-02 09:09:22 -05001644 int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1645 int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
Tejun Heo77ea8872010-12-08 20:57:37 +01001646 unsigned int (*check_events) (struct gendisk *disk,
1647 unsigned int clearing);
1648 /* ->media_changed() is DEPRECATED, use ->check_events() instead */
Al Viro08f85852007-10-08 13:26:20 -04001649 int (*media_changed) (struct gendisk *);
Tejun Heoc3e33e02010-05-15 20:09:29 +02001650 void (*unlock_native_capacity) (struct gendisk *);
Al Viro08f85852007-10-08 13:26:20 -04001651 int (*revalidate_disk) (struct gendisk *);
1652 int (*getgeo)(struct block_device *, struct hd_geometry *);
Nitin Guptab3a27d02010-05-17 11:02:43 +05301653 /* this callback is with swap_lock and sometimes page table lock held */
1654 void (*swap_slot_free_notify) (struct block_device *, unsigned long);
Christoph Hellwige76239a2018-10-12 19:08:49 +09001655 int (*report_zones)(struct gendisk *, sector_t sector,
1656 struct blk_zone *zones, unsigned int *nr_zones,
1657 gfp_t gfp_mask);
Al Viro08f85852007-10-08 13:26:20 -04001658 struct module *owner;
Christoph Hellwigbbd3e062015-10-15 14:10:48 +02001659 const struct pr_ops *pr_ops;
Al Viro08f85852007-10-08 13:26:20 -04001660};
1661
Al Viro633a08b2007-08-29 20:34:12 -04001662extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1663 unsigned long);
Matthew Wilcox47a191f2014-06-04 16:07:46 -07001664extern int bdev_read_page(struct block_device *, sector_t, struct page *);
1665extern int bdev_write_page(struct block_device *, sector_t, struct page *,
1666 struct writeback_control *);
Christoph Hellwig6cc77e92017-12-21 15:43:38 +09001667
1668#ifdef CONFIG_BLK_DEV_ZONED
1669bool blk_req_needs_zone_write_lock(struct request *rq);
1670void __blk_req_zone_write_lock(struct request *rq);
1671void __blk_req_zone_write_unlock(struct request *rq);
1672
1673static inline void blk_req_zone_write_lock(struct request *rq)
1674{
1675 if (blk_req_needs_zone_write_lock(rq))
1676 __blk_req_zone_write_lock(rq);
1677}
1678
1679static inline void blk_req_zone_write_unlock(struct request *rq)
1680{
1681 if (rq->rq_flags & RQF_ZONE_WRITE_LOCKED)
1682 __blk_req_zone_write_unlock(rq);
1683}
1684
1685static inline bool blk_req_zone_is_write_locked(struct request *rq)
1686{
1687 return rq->q->seq_zones_wlock &&
1688 test_bit(blk_rq_zone_no(rq), rq->q->seq_zones_wlock);
1689}
1690
1691static inline bool blk_req_can_dispatch_to_zone(struct request *rq)
1692{
1693 if (!blk_req_needs_zone_write_lock(rq))
1694 return true;
1695 return !blk_req_zone_is_write_locked(rq);
1696}
1697#else
1698static inline bool blk_req_needs_zone_write_lock(struct request *rq)
1699{
1700 return false;
1701}
1702
1703static inline void blk_req_zone_write_lock(struct request *rq)
1704{
1705}
1706
1707static inline void blk_req_zone_write_unlock(struct request *rq)
1708{
1709}
1710static inline bool blk_req_zone_is_write_locked(struct request *rq)
1711{
1712 return false;
1713}
1714
1715static inline bool blk_req_can_dispatch_to_zone(struct request *rq)
1716{
1717 return true;
1718}
1719#endif /* CONFIG_BLK_DEV_ZONED */
1720
David Howells93614012006-09-30 20:45:40 +02001721#else /* CONFIG_BLOCK */
Fabian Frederickac13a822014-06-04 16:06:27 -07001722
1723struct block_device;
1724
David Howells93614012006-09-30 20:45:40 +02001725/*
1726 * stubs for when the block layer is configured out
1727 */
1728#define buffer_heads_over_limit 0
1729
David Howells93614012006-09-30 20:45:40 +02001730static inline long nr_blockdev_pages(void)
1731{
1732 return 0;
1733}
1734
Jens Axboe1f940bd2011-03-11 20:17:08 +01001735struct blk_plug {
1736};
1737
1738static inline void blk_start_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001739{
1740}
1741
Jens Axboe1f940bd2011-03-11 20:17:08 +01001742static inline void blk_finish_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001743{
1744}
1745
Jens Axboe1f940bd2011-03-11 20:17:08 +01001746static inline void blk_flush_plug(struct task_struct *task)
Jens Axboe73c10102011-03-08 13:19:51 +01001747{
1748}
1749
Jens Axboea237c1c2011-04-16 13:27:55 +02001750static inline void blk_schedule_flush_plug(struct task_struct *task)
1751{
1752}
1753
1754
Jens Axboe73c10102011-03-08 13:19:51 +01001755static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1756{
1757 return false;
1758}
1759
Fabian Frederickac13a822014-06-04 16:06:27 -07001760static inline int blkdev_issue_flush(struct block_device *bdev, gfp_t gfp_mask,
1761 sector_t *error_sector)
1762{
1763 return 0;
1764}
1765
David Howells93614012006-09-30 20:45:40 +02001766#endif /* CONFIG_BLOCK */
1767
Jens Axboe06193172018-11-13 21:16:54 -07001768static inline void blk_wake_io_task(struct task_struct *waiter)
1769{
1770 /*
1771 * If we're polling, the task itself is doing the completions. For
1772 * that case, we don't need to signal a wakeup, it's enough to just
1773 * mark us as RUNNING.
1774 */
1775 if (waiter == current)
1776 __set_current_state(TASK_RUNNING);
1777 else
1778 wake_up_process(waiter);
1779}
1780
Linus Torvalds1da177e2005-04-16 15:20:36 -07001781#endif