blob: 81f1b105946bc2a0a737c16620546677b3c80938 [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;
Martin K. Petersene692cb62010-12-01 19:41:49 +0100343 unsigned char cluster;
Kent Overstreetc78afc62013-07-11 22:39:53 -0700344 unsigned char raid_partial_stripes_expensive;
Damien Le Moal797476b2016-10-18 15:40:29 +0900345 enum blk_zoned_model zoned;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400346};
347
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900348#ifdef CONFIG_BLK_DEV_ZONED
349
Damien Le Moala91e1382018-10-12 19:08:43 +0900350extern unsigned int blkdev_nr_zones(struct block_device *bdev);
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900351extern int blkdev_report_zones(struct block_device *bdev,
352 sector_t sector, struct blk_zone *zones,
353 unsigned int *nr_zones, gfp_t gfp_mask);
354extern int blkdev_reset_zones(struct block_device *bdev, sector_t sectors,
355 sector_t nr_sectors, gfp_t gfp_mask);
Damien Le Moalbf505452018-10-12 19:08:50 +0900356extern int blk_revalidate_disk_zones(struct gendisk *disk);
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900357
Shaun Tancheff3ed05a92016-10-18 15:40:35 +0900358extern int blkdev_report_zones_ioctl(struct block_device *bdev, fmode_t mode,
359 unsigned int cmd, unsigned long arg);
360extern int blkdev_reset_zones_ioctl(struct block_device *bdev, fmode_t mode,
361 unsigned int cmd, unsigned long arg);
362
363#else /* CONFIG_BLK_DEV_ZONED */
364
Damien Le Moala91e1382018-10-12 19:08:43 +0900365static inline unsigned int blkdev_nr_zones(struct block_device *bdev)
366{
367 return 0;
368}
Damien Le Moalbf505452018-10-12 19:08:50 +0900369
370static inline int blk_revalidate_disk_zones(struct gendisk *disk)
371{
372 return 0;
373}
374
Shaun Tancheff3ed05a92016-10-18 15:40:35 +0900375static inline int blkdev_report_zones_ioctl(struct block_device *bdev,
376 fmode_t mode, unsigned int cmd,
377 unsigned long arg)
378{
379 return -ENOTTY;
380}
381
382static inline int blkdev_reset_zones_ioctl(struct block_device *bdev,
383 fmode_t mode, unsigned int cmd,
384 unsigned long arg)
385{
386 return -ENOTTY;
387}
388
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900389#endif /* CONFIG_BLK_DEV_ZONED */
390
Richard Kennedyd7b76302011-07-13 21:17:23 +0200391struct request_queue {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700392 /*
393 * Together with queue_head for cacheline sharing
394 */
395 struct list_head queue_head;
396 struct request *last_merge;
Jens Axboeb374d182008-10-31 10:05:07 +0100397 struct elevator_queue *elevator;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700398
Omar Sandoval34dbad52017-03-21 08:56:08 -0700399 struct blk_queue_stats *stats;
Josef Bacika7905042018-07-03 09:32:35 -0600400 struct rq_qos *rq_qos;
Jens Axboe87760e52016-11-09 12:38:14 -0700401
Linus Torvalds1da177e2005-04-16 15:20:36 -0700402 make_request_fn *make_request_fn;
Tejun Heo2fb98e82008-02-19 11:36:53 +0100403 dma_drain_needed_fn *dma_drain_needed;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700404
Jens Axboef8a5b122016-12-13 09:24:51 -0700405 const struct blk_mq_ops *mq_ops;
Jens Axboe320ae512013-10-24 09:20:05 +0100406
Jens Axboe320ae512013-10-24 09:20:05 +0100407 /* sw queues */
Ming Leie6cdb092014-06-03 11:24:06 +0800408 struct blk_mq_ctx __percpu *queue_ctx;
Jens Axboe320ae512013-10-24 09:20:05 +0100409 unsigned int nr_queues;
410
Jens Axboed278d4a2016-03-30 10:21:08 -0600411 unsigned int queue_depth;
412
Jens Axboe320ae512013-10-24 09:20:05 +0100413 /* hw dispatch queues */
414 struct blk_mq_hw_ctx **queue_hw_ctx;
415 unsigned int nr_hw_queues;
416
Jan Karadc3b17c2017-02-02 15:56:50 +0100417 struct backing_dev_info *backing_dev_info;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700418
419 /*
420 * The queue owner gets to use this for whatever they like.
421 * ll_rw_blk doesn't touch it.
422 */
423 void *queuedata;
424
Linus Torvalds1da177e2005-04-16 15:20:36 -0700425 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700426 * various queue flags, see QUEUE_* below
427 */
428 unsigned long queue_flags;
Bart Van Asschecd84a622018-09-26 14:01:04 -0700429 /*
430 * Number of contexts that have called blk_set_pm_only(). If this
431 * counter is above zero then only RQF_PM and RQF_PREEMPT requests are
432 * processed.
433 */
434 atomic_t pm_only;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700435
436 /*
Tejun Heoa73f7302011-12-14 00:33:37 +0100437 * ida allocated id for this queue. Used to index queues from
438 * ioctx.
439 */
440 int id;
441
442 /*
Richard Kennedyd7b76302011-07-13 21:17:23 +0200443 * queue needs bounce pages for pages above this limit
444 */
445 gfp_t bounce_gfp;
446
Christoph Hellwig0d945c12018-11-15 12:17:28 -0700447 spinlock_t queue_lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700448
449 /*
450 * queue kobject
451 */
452 struct kobject kobj;
453
Jens Axboe320ae512013-10-24 09:20:05 +0100454 /*
455 * mq queue kobject
456 */
Ming Lei1db49092018-11-20 09:44:35 +0800457 struct kobject *mq_kobj;
Jens Axboe320ae512013-10-24 09:20:05 +0100458
Dan Williamsac6fc482015-10-21 13:20:18 -0400459#ifdef CONFIG_BLK_DEV_INTEGRITY
460 struct blk_integrity integrity;
461#endif /* CONFIG_BLK_DEV_INTEGRITY */
462
Rafael J. Wysocki47fafbc2014-12-04 01:00:23 +0100463#ifdef CONFIG_PM
Lin Ming6c954662013-03-23 11:42:26 +0800464 struct device *dev;
465 int rpm_status;
466 unsigned int nr_pending;
467#endif
468
Linus Torvalds1da177e2005-04-16 15:20:36 -0700469 /*
470 * queue settings
471 */
472 unsigned long nr_requests; /* Max # of requests */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700473
James Bottomleyfa0ccd82008-01-10 11:30:36 -0600474 unsigned int dma_drain_size;
Richard Kennedyd7b76302011-07-13 21:17:23 +0200475 void *dma_drain_buffer;
Tejun Heoe3790c72008-03-04 11:18:17 +0100476 unsigned int dma_pad_mask;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700477 unsigned int dma_alignment;
478
Jens Axboe242f9dc2008-09-14 05:55:09 -0700479 unsigned int rq_timeout;
Jens Axboe64f1c212016-11-14 13:03:03 -0700480 int poll_nsec;
Omar Sandoval34dbad52017-03-21 08:56:08 -0700481
482 struct blk_stat_callback *poll_cb;
Stephen Bates02063192017-04-20 16:59:11 -0600483 struct blk_rq_stat poll_stat[BLK_MQ_POLL_STATS_BKTS];
Omar Sandoval34dbad52017-03-21 08:56:08 -0700484
Jens Axboe242f9dc2008-09-14 05:55:09 -0700485 struct timer_list timeout;
Christoph Hellwig287922e2015-10-30 20:57:30 +0800486 struct work_struct timeout_work;
Jens Axboe242f9dc2008-09-14 05:55:09 -0700487
Tejun Heoa612fdd2011-12-14 00:33:41 +0100488 struct list_head icq_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800489#ifdef CONFIG_BLK_CGROUP
Tejun Heoa2b16932012-04-13 13:11:33 -0700490 DECLARE_BITMAP (blkcg_pols, BLKCG_MAX_POLS);
Tejun Heo3c798392012-04-16 13:57:25 -0700491 struct blkcg_gq *root_blkg;
Tejun Heo03aa2642012-03-05 13:15:19 -0800492 struct list_head blkg_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800493#endif
Tejun Heoa612fdd2011-12-14 00:33:41 +0100494
Martin K. Petersen025146e2009-05-22 17:17:51 -0400495 struct queue_limits limits;
496
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700497#ifdef CONFIG_BLK_DEV_ZONED
Linus Torvalds1da177e2005-04-16 15:20:36 -0700498 /*
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900499 * Zoned block device information for request dispatch control.
500 * nr_zones is the total number of zones of the device. This is always
501 * 0 for regular block devices. seq_zones_bitmap is a bitmap of nr_zones
502 * bits which indicates if a zone is conventional (bit clear) or
503 * sequential (bit set). seq_zones_wlock is a bitmap of nr_zones
504 * bits which indicates if a zone is write locked, that is, if a write
505 * request targeting the zone was dispatched. All three fields are
506 * initialized by the low level device driver (e.g. scsi/sd.c).
507 * Stacking drivers (device mappers) may or may not initialize
508 * these fields.
Bart Van Asscheccce20f2018-04-16 18:04:41 -0700509 *
510 * Reads of this information must be protected with blk_queue_enter() /
511 * blk_queue_exit(). Modifying this information is only allowed while
512 * no requests are being processed. See also blk_mq_freeze_queue() and
513 * blk_mq_unfreeze_queue().
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900514 */
515 unsigned int nr_zones;
516 unsigned long *seq_zones_bitmap;
517 unsigned long *seq_zones_wlock;
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700518#endif /* CONFIG_BLK_DEV_ZONED */
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900519
520 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700521 * sg stuff
522 */
523 unsigned int sg_timeout;
524 unsigned int sg_reserved_size;
Christoph Lameter19460892005-06-23 00:08:19 -0700525 int node;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700526#ifdef CONFIG_BLK_DEV_IO_TRACE
Jens Axboe2056a782006-03-23 20:00:26 +0100527 struct blk_trace *blk_trace;
Waiman Long5acb3cc2017-09-20 13:12:20 -0600528 struct mutex blk_trace_mutex;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700529#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700530 /*
Tejun Heo4913efe2010-09-03 11:56:16 +0200531 * for flush operations
Linus Torvalds1da177e2005-04-16 15:20:36 -0700532 */
Ming Lei7c94e1c2014-09-25 23:23:43 +0800533 struct blk_flush_queue *fq;
Al Viro483f4af2006-03-18 18:34:37 -0500534
Christoph Hellwig6fca6a62014-05-28 08:08:02 -0600535 struct list_head requeue_list;
536 spinlock_t requeue_lock;
Mike Snitzer28494502016-09-14 13:28:30 -0400537 struct delayed_work requeue_work;
Christoph Hellwig6fca6a62014-05-28 08:08:02 -0600538
Al Viro483f4af2006-03-18 18:34:37 -0500539 struct mutex sysfs_lock;
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200540
Christoph Hellwig4ecd4fe2015-05-07 09:38:13 +0200541 atomic_t mq_freeze_depth;
Tejun Heod7325802012-03-05 13:14:58 -0800542
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200543#if defined(CONFIG_BLK_DEV_BSG)
544 struct bsg_class_device bsg_dev;
545#endif
Vivek Goyale43473b2010-09-15 17:06:35 -0400546
547#ifdef CONFIG_BLK_DEV_THROTTLING
548 /* Throttle data */
549 struct throtl_data *td;
550#endif
Tejun Heo548bc8e2013-01-09 08:05:13 -0800551 struct rcu_head rcu_head;
Jens Axboe320ae512013-10-24 09:20:05 +0100552 wait_queue_head_t mq_freeze_wq;
Dan Williams3ef28e82015-10-21 13:20:12 -0400553 struct percpu_ref q_usage_counter;
Jens Axboe320ae512013-10-24 09:20:05 +0100554 struct list_head all_q_node;
Jens Axboe0d2602c2014-05-13 15:10:52 -0600555
556 struct blk_mq_tag_set *tag_set;
557 struct list_head tag_set_list;
Kent Overstreet338aa962018-05-20 18:25:47 -0400558 struct bio_set bio_split;
Akinobu Mita4593fdb2015-09-27 02:09:20 +0900559
Omar Sandoval03796c12017-01-31 14:53:18 -0800560#ifdef CONFIG_BLK_DEBUG_FS
Omar Sandoval07e4fea2017-01-25 08:06:40 -0800561 struct dentry *debugfs_dir;
Omar Sandovald332ce02017-05-04 08:24:40 -0600562 struct dentry *sched_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
Martin K. Petersene692cb62010-12-01 19:41:49 +0100660static inline unsigned int blk_queue_cluster(struct request_queue *q)
661{
662 return q->limits.cluster;
663}
664
Damien Le Moal797476b2016-10-18 15:40:29 +0900665static inline enum blk_zoned_model
666blk_queue_zoned_model(struct request_queue *q)
667{
668 return q->limits.zoned;
669}
670
671static inline bool blk_queue_is_zoned(struct request_queue *q)
672{
673 switch (blk_queue_zoned_model(q)) {
674 case BLK_ZONED_HA:
675 case BLK_ZONED_HM:
676 return true;
677 default:
678 return false;
679 }
680}
681
Damien Le Moalf99e8642017-01-12 07:58:32 -0700682static inline unsigned int blk_queue_zone_sectors(struct request_queue *q)
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +0900683{
684 return blk_queue_is_zoned(q) ? q->limits.chunk_sectors : 0;
685}
686
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700687#ifdef CONFIG_BLK_DEV_ZONED
Damien Le Moal965b6522018-10-12 19:08:48 +0900688static inline unsigned int blk_queue_nr_zones(struct request_queue *q)
689{
690 return blk_queue_is_zoned(q) ? q->nr_zones : 0;
691}
692
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900693static inline unsigned int blk_queue_zone_no(struct request_queue *q,
694 sector_t sector)
695{
696 if (!blk_queue_is_zoned(q))
697 return 0;
698 return sector >> ilog2(q->limits.chunk_sectors);
699}
700
701static inline bool blk_queue_zone_is_seq(struct request_queue *q,
702 sector_t sector)
703{
704 if (!blk_queue_is_zoned(q) || !q->seq_zones_bitmap)
705 return false;
706 return test_bit(blk_queue_zone_no(q, sector), q->seq_zones_bitmap);
707}
Damien Le Moal965b6522018-10-12 19:08:48 +0900708#else /* CONFIG_BLK_DEV_ZONED */
709static inline unsigned int blk_queue_nr_zones(struct request_queue *q)
710{
711 return 0;
712}
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700713#endif /* CONFIG_BLK_DEV_ZONED */
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900714
Jens Axboe1faa16d2009-04-06 14:48:01 +0200715static inline bool rq_is_sync(struct request *rq)
716{
Christoph Hellwigef295ec2016-10-28 08:48:16 -0600717 return op_is_sync(rq->cmd_flags);
Jens Axboe1faa16d2009-04-06 14:48:01 +0200718}
719
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400720static inline bool rq_mergeable(struct request *rq)
721{
Christoph Hellwig57292b52017-01-31 16:57:29 +0100722 if (blk_rq_is_passthrough(rq))
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400723 return false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700724
Mike Christie3a5e02c2016-06-05 14:32:23 -0500725 if (req_op(rq) == REQ_OP_FLUSH)
726 return false;
727
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800728 if (req_op(rq) == REQ_OP_WRITE_ZEROES)
729 return false;
730
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400731 if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
732 return false;
Christoph Hellwige8064022016-10-20 15:12:13 +0200733 if (rq->rq_flags & RQF_NOMERGE_FLAGS)
734 return false;
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400735
736 return true;
737}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700738
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400739static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
740{
Christoph Hellwigefbeccd2017-06-19 09:24:41 +0200741 if (bio_page(a) == bio_page(b) &&
742 bio_offset(a) == bio_offset(b))
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400743 return true;
744
745 return false;
746}
747
Jens Axboed278d4a2016-03-30 10:21:08 -0600748static inline unsigned int blk_queue_depth(struct request_queue *q)
749{
750 if (q->queue_depth)
751 return q->queue_depth;
752
753 return q->nr_requests;
754}
755
Linus Torvalds1da177e2005-04-16 15:20:36 -0700756extern unsigned long blk_max_low_pfn, blk_max_pfn;
757
758/*
759 * standard bounce addresses:
760 *
761 * BLK_BOUNCE_HIGH : bounce all highmem pages
762 * BLK_BOUNCE_ANY : don't bounce anything
763 * BLK_BOUNCE_ISA : bounce pages above ISA DMA boundary
764 */
Andi Kleen24728922008-04-21 09:51:05 +0200765
766#if BITS_PER_LONG == 32
Linus Torvalds1da177e2005-04-16 15:20:36 -0700767#define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
Andi Kleen24728922008-04-21 09:51:05 +0200768#else
769#define BLK_BOUNCE_HIGH -1ULL
770#endif
771#define BLK_BOUNCE_ANY (-1ULL)
FUJITA Tomonoribfe17232010-05-31 15:59:03 +0900772#define BLK_BOUNCE_ISA (DMA_BIT_MASK(24))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700773
Jens Axboe3d6392c2007-07-09 12:38:05 +0200774/*
775 * default timeout for SG_IO if none specified
776 */
777#define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
Linus Torvaldsf2f1fa72008-12-05 14:49:18 -0800778#define BLK_MIN_SG_TIMEOUT (7 * HZ)
Jens Axboe3d6392c2007-07-09 12:38:05 +0200779
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900780struct rq_map_data {
781 struct page **pages;
782 int page_order;
783 int nr_entries;
FUJITA Tomonori56c451f2008-12-18 14:49:37 +0900784 unsigned long offset;
FUJITA Tomonori97ae77a2008-12-18 14:49:38 +0900785 int null_mapped;
FUJITA Tomonoriecb554a2009-07-09 14:46:53 +0200786 int from_user;
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900787};
788
NeilBrown5705f702007-09-25 12:35:59 +0200789struct req_iterator {
Kent Overstreet79886132013-11-23 17:19:00 -0800790 struct bvec_iter iter;
NeilBrown5705f702007-09-25 12:35:59 +0200791 struct bio *bio;
792};
793
794/* This should not be used directly - use rq_for_each_segment */
Jens Axboe1e428072009-02-23 09:03:10 +0100795#define for_each_bio(_bio) \
796 for (; _bio; _bio = _bio->bi_next)
NeilBrown5705f702007-09-25 12:35:59 +0200797#define __rq_for_each_bio(_bio, rq) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700798 if ((rq->bio)) \
799 for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
800
NeilBrown5705f702007-09-25 12:35:59 +0200801#define rq_for_each_segment(bvl, _rq, _iter) \
802 __rq_for_each_bio(_iter.bio, _rq) \
Kent Overstreet79886132013-11-23 17:19:00 -0800803 bio_for_each_segment(bvl, _iter.bio, _iter.iter)
NeilBrown5705f702007-09-25 12:35:59 +0200804
Kent Overstreet4550dd62013-08-07 14:26:21 -0700805#define rq_iter_last(bvec, _iter) \
Kent Overstreet79886132013-11-23 17:19:00 -0800806 (_iter.bio->bi_next == NULL && \
Kent Overstreet4550dd62013-08-07 14:26:21 -0700807 bio_iter_last(bvec, _iter.iter))
NeilBrown5705f702007-09-25 12:35:59 +0200808
Ilya Loginov2d4dc892009-11-26 09:16:19 +0100809#ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
810# error "You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
811#endif
812#if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
813extern void rq_flush_dcache_pages(struct request *rq);
814#else
815static inline void rq_flush_dcache_pages(struct request *rq)
816{
817}
818#endif
819
Linus Torvalds1da177e2005-04-16 15:20:36 -0700820extern int blk_register_queue(struct gendisk *disk);
821extern void blk_unregister_queue(struct gendisk *disk);
Jens Axboedece1632015-11-05 10:41:16 -0700822extern blk_qc_t generic_make_request(struct bio *bio);
Christoph Hellwigf421e1d2017-11-02 21:29:50 +0300823extern blk_qc_t direct_make_request(struct bio *bio);
FUJITA Tomonori2a4aa302008-04-29 09:54:36 +0200824extern void blk_rq_init(struct request_queue *q, struct request *rq);
Bart Van Asscheda8d7f02017-04-19 14:01:24 -0700825extern void blk_init_request_from_bio(struct request *req, struct bio *bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700826extern void blk_put_request(struct request *);
Bart Van Asschecd6ce142017-06-20 11:15:39 -0700827extern struct request *blk_get_request(struct request_queue *, unsigned int op,
Christoph Hellwigff005a02018-05-09 09:54:05 +0200828 blk_mq_req_flags_t flags);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200829extern int blk_lld_busy(struct request_queue *q);
Mike Snitzer78d8e582015-06-26 10:01:13 -0400830extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
831 struct bio_set *bs, gfp_t gfp_mask,
832 int (*bio_ctr)(struct bio *, struct bio *, void *),
833 void *data);
834extern void blk_rq_unprep_clone(struct request *rq);
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200835extern blk_status_t blk_insert_cloned_request(struct request_queue *q,
Kiyoshi Ueda82124d62008-09-18 10:45:38 -0400836 struct request *rq);
Jens Axboe0abc2a12017-12-18 15:40:44 +0800837extern int blk_rq_append_bio(struct request *rq, struct bio **bio);
NeilBrownaf67c312017-06-18 14:38:57 +1000838extern void blk_queue_split(struct request_queue *, struct bio **);
Jens Axboe165125e2007-07-24 09:28:11 +0200839extern void blk_recount_segments(struct request_queue *, struct bio *);
Paolo Bonzini0bfc96c2012-01-12 16:01:28 +0100840extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
Paolo Bonzini577ebb32012-01-12 16:01:27 +0100841extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
842 unsigned int, void __user *);
Al Viro74f3c8a2007-08-27 15:38:10 -0400843extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
844 unsigned int, void __user *);
Al Viroe915e872008-09-02 17:16:41 -0400845extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
846 struct scsi_ioctl_command __user *);
Andrew Morton3fcfab12006-10-19 23:28:16 -0700847
Bart Van Assche9a95e4e2017-11-09 10:49:59 -0800848extern int blk_queue_enter(struct request_queue *q, blk_mq_req_flags_t flags);
Dan Williams2e6edc952015-11-19 13:29:28 -0800849extern void blk_queue_exit(struct request_queue *q);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700850extern void blk_sync_queue(struct request_queue *q);
FUJITA Tomonoria3bce902008-08-28 16:17:05 +0900851extern int blk_rq_map_user(struct request_queue *, struct request *,
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900852 struct rq_map_data *, void __user *, unsigned long,
853 gfp_t);
Jens Axboe8e5cfc42006-12-19 11:12:46 +0100854extern int blk_rq_unmap_user(struct bio *);
Jens Axboe165125e2007-07-24 09:28:11 +0200855extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
856extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
Kent Overstreet26e49cf2015-01-18 16:16:31 +0100857 struct rq_map_data *, const struct iov_iter *,
858 gfp_t);
Christoph Hellwigb7819b92017-04-20 16:02:55 +0200859extern void blk_execute_rq(struct request_queue *, struct gendisk *,
James Bottomley 994ca9a2005-06-20 14:11:09 +0200860 struct request *, int);
Jens Axboe165125e2007-07-24 09:28:11 +0200861extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
Jens Axboe15fc8582006-01-06 10:00:50 +0100862 struct request *, int, rq_end_io_fn *);
Mike Christie6e39b692005-11-11 05:30:24 -0600863
Christoph Hellwig2a842ac2017-06-03 09:38:04 +0200864int blk_status_to_errno(blk_status_t status);
865blk_status_t errno_to_blk_status(int errno);
866
Jens Axboe0a1b8b82018-11-26 08:24:43 -0700867int blk_poll(struct request_queue *q, blk_qc_t cookie, bool spin);
Jens Axboe05229beed2015-11-05 10:44:55 -0700868
Jens Axboe165125e2007-07-24 09:28:11 +0200869static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700870{
Tejun Heoff9ea322014-09-08 08:03:56 +0900871 return bdev->bd_disk->queue; /* this is never NULL */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700872}
873
Linus Torvalds1da177e2005-04-16 15:20:36 -0700874/*
Bart Van Assche233bde22018-03-14 15:48:06 -0700875 * The basic unit of block I/O is a sector. It is used in a number of contexts
876 * in Linux (blk, bio, genhd). The size of one sector is 512 = 2**9
877 * bytes. Variables of type sector_t represent an offset or size that is a
878 * multiple of 512 bytes. Hence these two constants.
879 */
880#ifndef SECTOR_SHIFT
881#define SECTOR_SHIFT 9
882#endif
883#ifndef SECTOR_SIZE
884#define SECTOR_SIZE (1 << SECTOR_SHIFT)
885#endif
886
887/*
Tejun Heo80a761f2009-07-03 17:48:17 +0900888 * blk_rq_pos() : the current sector
889 * blk_rq_bytes() : bytes left in the entire request
890 * blk_rq_cur_bytes() : bytes left in the current segment
891 * blk_rq_err_bytes() : bytes left till the next error boundary
892 * blk_rq_sectors() : sectors left in the entire request
893 * blk_rq_cur_sectors() : sectors left in the current segment
Tejun Heo5efccd12009-04-23 11:05:18 +0900894 */
Tejun Heo5b936292009-05-07 22:24:38 +0900895static inline sector_t blk_rq_pos(const struct request *rq)
896{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900897 return rq->__sector;
Tejun Heo5b936292009-05-07 22:24:38 +0900898}
899
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900900static inline unsigned int blk_rq_bytes(const struct request *rq)
901{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900902 return rq->__data_len;
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900903}
904
905static inline int blk_rq_cur_bytes(const struct request *rq)
906{
907 return rq->bio ? bio_cur_bytes(rq->bio) : 0;
908}
Tejun Heo5efccd12009-04-23 11:05:18 +0900909
Tejun Heo80a761f2009-07-03 17:48:17 +0900910extern unsigned int blk_rq_err_bytes(const struct request *rq);
911
Tejun Heo5b936292009-05-07 22:24:38 +0900912static inline unsigned int blk_rq_sectors(const struct request *rq)
913{
Bart Van Assche233bde22018-03-14 15:48:06 -0700914 return blk_rq_bytes(rq) >> SECTOR_SHIFT;
Tejun Heo5b936292009-05-07 22:24:38 +0900915}
916
917static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
918{
Bart Van Assche233bde22018-03-14 15:48:06 -0700919 return blk_rq_cur_bytes(rq) >> SECTOR_SHIFT;
Tejun Heo5b936292009-05-07 22:24:38 +0900920}
921
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700922#ifdef CONFIG_BLK_DEV_ZONED
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900923static inline unsigned int blk_rq_zone_no(struct request *rq)
924{
925 return blk_queue_zone_no(rq->q, blk_rq_pos(rq));
926}
927
928static inline unsigned int blk_rq_zone_is_seq(struct request *rq)
929{
930 return blk_queue_zone_is_seq(rq->q, blk_rq_pos(rq));
931}
Bart Van Assche6a5ac982018-06-15 14:55:21 -0700932#endif /* CONFIG_BLK_DEV_ZONED */
Christoph Hellwig6cc77e92017-12-21 15:43:38 +0900933
Christoph Hellwig2e3258e2017-01-13 12:29:10 +0100934/*
935 * Some commands like WRITE SAME have a payload or data transfer size which
936 * is different from the size of the request. Any driver that supports such
937 * commands using the RQF_SPECIAL_PAYLOAD flag needs to use this helper to
938 * calculate the data transfer size.
939 */
940static inline unsigned int blk_rq_payload_bytes(struct request *rq)
941{
942 if (rq->rq_flags & RQF_SPECIAL_PAYLOAD)
943 return rq->special_vec.bv_len;
944 return blk_rq_bytes(rq);
945}
946
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400947static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
Mike Christie8fe0d472016-06-05 14:32:15 -0500948 int op)
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400949{
Adrian Hunter7afafc82016-08-16 10:59:35 +0300950 if (unlikely(op == REQ_OP_DISCARD || op == REQ_OP_SECURE_ERASE))
Bart Van Assche233bde22018-03-14 15:48:06 -0700951 return min(q->limits.max_discard_sectors,
952 UINT_MAX >> SECTOR_SHIFT);
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400953
Mike Christie8fe0d472016-06-05 14:32:15 -0500954 if (unlikely(op == REQ_OP_WRITE_SAME))
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400955 return q->limits.max_write_same_sectors;
956
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -0800957 if (unlikely(op == REQ_OP_WRITE_ZEROES))
958 return q->limits.max_write_zeroes_sectors;
959
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400960 return q->limits.max_sectors;
961}
962
Jens Axboe762380a2014-06-05 13:38:39 -0600963/*
964 * Return maximum size of a request at given offset. Only valid for
965 * file system requests.
966 */
967static inline unsigned int blk_max_size_offset(struct request_queue *q,
968 sector_t offset)
969{
970 if (!q->limits.chunk_sectors)
Jens Axboe736ed4d2014-06-17 22:09:29 -0700971 return q->limits.max_sectors;
Jens Axboe762380a2014-06-05 13:38:39 -0600972
Keith Busch15bfd212018-06-26 09:14:58 -0600973 return min(q->limits.max_sectors, (unsigned int)(q->limits.chunk_sectors -
974 (offset & (q->limits.chunk_sectors - 1))));
Jens Axboe762380a2014-06-05 13:38:39 -0600975}
976
Damien Le Moal17007f32016-07-20 21:40:47 -0600977static inline unsigned int blk_rq_get_max_sectors(struct request *rq,
978 sector_t offset)
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400979{
980 struct request_queue *q = rq->q;
981
Christoph Hellwig57292b52017-01-31 16:57:29 +0100982 if (blk_rq_is_passthrough(rq))
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400983 return q->limits.max_hw_sectors;
984
Adrian Hunter7afafc82016-08-16 10:59:35 +0300985 if (!q->limits.chunk_sectors ||
986 req_op(rq) == REQ_OP_DISCARD ||
987 req_op(rq) == REQ_OP_SECURE_ERASE)
Mike Christie8fe0d472016-06-05 14:32:15 -0500988 return blk_queue_get_max_sectors(q, req_op(rq));
Jens Axboe762380a2014-06-05 13:38:39 -0600989
Damien Le Moal17007f32016-07-20 21:40:47 -0600990 return min(blk_max_size_offset(q, offset),
Mike Christie8fe0d472016-06-05 14:32:15 -0500991 blk_queue_get_max_sectors(q, req_op(rq)));
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400992}
993
Jun'ichi Nomura75afb352013-09-21 13:57:47 -0600994static inline unsigned int blk_rq_count_bios(struct request *rq)
995{
996 unsigned int nr_bios = 0;
997 struct bio *bio;
998
999 __rq_for_each_bio(bio, rq)
1000 nr_bios++;
1001
1002 return nr_bios;
1003}
1004
Christoph Hellwigef71de82017-11-02 21:29:51 +03001005void blk_steal_bios(struct bio_list *list, struct request *rq);
1006
Tejun Heo9934c8c2009-05-08 11:54:16 +09001007/*
Tejun Heo2e60e022009-04-23 11:05:18 +09001008 * Request completion related functions.
1009 *
1010 * blk_update_request() completes given number of bytes and updates
1011 * the request without completing it.
1012 *
Tejun Heof06d9a22009-04-23 11:05:19 +09001013 * blk_end_request() and friends. __blk_end_request() must be called
1014 * with the request queue spinlock acquired.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001015 *
1016 * Several drivers define their own end_request and call
Kiyoshi Ueda3bcddea2007-12-11 17:52:28 -05001017 * blk_end_request() for parts of the original function.
1018 * This prevents code duplication in drivers.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001019 */
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001020extern bool blk_update_request(struct request *rq, blk_status_t error,
Tejun Heo2e60e022009-04-23 11:05:18 +09001021 unsigned int nr_bytes);
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001022extern void blk_end_request_all(struct request *rq, blk_status_t error);
1023extern bool __blk_end_request(struct request *rq, blk_status_t error,
FUJITA Tomonorib1f74492009-05-11 17:56:09 +09001024 unsigned int nr_bytes);
Christoph Hellwig2a842ac2017-06-03 09:38:04 +02001025extern void __blk_end_request_all(struct request *rq, blk_status_t error);
1026extern bool __blk_end_request_cur(struct request *rq, blk_status_t error);
Tejun Heo2e60e022009-04-23 11:05:18 +09001027
Jens Axboe242f9dc2008-09-14 05:55:09 -07001028extern void __blk_complete_request(struct request *);
1029extern void blk_abort_request(struct request *);
Jens Axboeff856ba2006-01-09 16:02:34 +01001030
Linus Torvalds1da177e2005-04-16 15:20:36 -07001031/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07001032 * Access functions for manipulating queue properties
1033 */
Jens Axboe165125e2007-07-24 09:28:11 +02001034extern void blk_cleanup_queue(struct request_queue *);
1035extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
1036extern void blk_queue_bounce_limit(struct request_queue *, u64);
Martin K. Petersen086fa5f2010-02-26 00:20:38 -05001037extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
Jens Axboe762380a2014-06-05 13:38:39 -06001038extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
Martin K. Petersen8a783622010-02-26 00:20:39 -05001039extern void blk_queue_max_segments(struct request_queue *, unsigned short);
Christoph Hellwig1e739732017-02-08 14:46:49 +01001040extern void blk_queue_max_discard_segments(struct request_queue *,
1041 unsigned short);
Jens Axboe165125e2007-07-24 09:28:11 +02001042extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
Christoph Hellwig67efc922009-09-30 13:54:20 +02001043extern void blk_queue_max_discard_sectors(struct request_queue *q,
1044 unsigned int max_discard_sectors);
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001045extern void blk_queue_max_write_same_sectors(struct request_queue *q,
1046 unsigned int max_write_same_sectors);
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -08001047extern void blk_queue_max_write_zeroes_sectors(struct request_queue *q,
1048 unsigned int max_write_same_sectors);
Martin K. Petersene1defc42009-05-22 17:17:49 -04001049extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001050extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001051extern void blk_queue_alignment_offset(struct request_queue *q,
1052 unsigned int alignment);
Martin K. Petersen7c958e32009-07-31 11:49:11 -04001053extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001054extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
Martin K. Petersen3c5820c2009-09-11 21:54:52 +02001055extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001056extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
Jens Axboed278d4a2016-03-30 10:21:08 -06001057extern void blk_set_queue_depth(struct request_queue *q, unsigned int depth);
Martin K. Petersene475bba2009-06-16 08:23:52 +02001058extern void blk_set_default_limits(struct queue_limits *lim);
Martin K. Petersenb1bd0552012-01-11 16:27:11 +01001059extern void blk_set_stacking_limits(struct queue_limits *lim);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001060extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
1061 sector_t offset);
Martin K. Petersen17be8c22010-01-11 03:21:49 -05001062extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
1063 sector_t offset);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001064extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
1065 sector_t offset);
Jens Axboe165125e2007-07-24 09:28:11 +02001066extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
Tejun Heoe3790c72008-03-04 11:18:17 +01001067extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
FUJITA Tomonori27f82212008-07-04 09:30:03 +02001068extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
Tejun Heo2fb98e82008-02-19 11:36:53 +01001069extern int blk_queue_dma_drain(struct request_queue *q,
1070 dma_drain_needed_fn *dma_drain_needed,
1071 void *buf, unsigned int size);
Jens Axboe165125e2007-07-24 09:28:11 +02001072extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
Keith Busch03100aa2015-08-19 14:24:05 -07001073extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
Jens Axboe165125e2007-07-24 09:28:11 +02001074extern void blk_queue_dma_alignment(struct request_queue *, int);
James Bottomley11c3e682007-12-31 16:37:00 -06001075extern void blk_queue_update_dma_alignment(struct request_queue *, int);
Jens Axboe242f9dc2008-09-14 05:55:09 -07001076extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001077extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
Jens Axboe93e9d8e2016-04-12 12:32:46 -06001078extern void blk_queue_write_cache(struct request_queue *q, bool enabled, bool fua);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001079
Christoph Hellwig1e739732017-02-08 14:46:49 +01001080/*
1081 * Number of physical segments as sent to the device.
1082 *
1083 * Normally this is the number of discontiguous data segments sent by the
1084 * submitter. But for data-less command like discard we might have no
1085 * actual data segments submitted, but the driver might have to add it's
1086 * own special payload. In that case we still return 1 here so that this
1087 * special payload will be mapped.
1088 */
Christoph Hellwigf9d03f92016-12-08 15:20:32 -07001089static inline unsigned short blk_rq_nr_phys_segments(struct request *rq)
1090{
1091 if (rq->rq_flags & RQF_SPECIAL_PAYLOAD)
1092 return 1;
1093 return rq->nr_phys_segments;
1094}
1095
Christoph Hellwig1e739732017-02-08 14:46:49 +01001096/*
1097 * Number of discard segments (or ranges) the driver needs to fill in.
1098 * Each discard bio merged into a request is counted as one segment.
1099 */
1100static inline unsigned short blk_rq_nr_discard_segments(struct request *rq)
1101{
1102 return max_t(unsigned short, rq->nr_phys_segments, 1);
1103}
1104
Jens Axboe165125e2007-07-24 09:28:11 +02001105extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001106extern void blk_dump_rq_flags(struct request *, char *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001107extern long nr_blockdev_pages(void);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001108
Tejun Heo09ac46c2011-12-14 00:33:38 +01001109bool __must_check blk_get_queue(struct request_queue *);
Jens Axboe165125e2007-07-24 09:28:11 +02001110struct request_queue *blk_alloc_queue(gfp_t);
Christoph Hellwig6d469642018-11-14 17:02:18 +01001111struct request_queue *blk_alloc_queue_node(gfp_t gfp_mask, int node_id);
Jens Axboe165125e2007-07-24 09:28:11 +02001112extern void blk_put_queue(struct request_queue *);
Jens Axboe3f21c262015-06-05 10:57:37 -06001113extern void blk_set_queue_dying(struct request_queue *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001114
Shaohua Li316cc672011-07-08 08:19:21 +02001115/*
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001116 * blk_plug permits building a queue of related requests by holding the I/O
1117 * fragments for a short period. This allows merging of sequential requests
1118 * into single larger request. As the requests are moved from a per-task list to
1119 * the device's request_queue in a batch, this results in improved scalability
1120 * as the lock contention for request_queue lock is reduced.
1121 *
1122 * It is ok not to disable preemption when adding the request to the plug list
1123 * or when attempting a merge, because blk_schedule_flush_list() will only flush
1124 * the plug list when the task sleeps by itself. For details, please see
1125 * schedule() where blk_schedule_flush_plug() is called.
Shaohua Li316cc672011-07-08 08:19:21 +02001126 */
Jens Axboe73c10102011-03-08 13:19:51 +01001127struct blk_plug {
Jens Axboe320ae512013-10-24 09:20:05 +01001128 struct list_head mq_list; /* blk-mq requests */
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001129 struct list_head cb_list; /* md requires an unplug callback */
Jens Axboe5f0ed772018-11-23 22:04:33 -07001130 unsigned short rq_count;
Jens Axboece5b0092018-11-27 17:13:56 -07001131 bool multiple_queues;
Jens Axboe73c10102011-03-08 13:19:51 +01001132};
Shaohua Li55c022b2011-07-08 08:19:20 +02001133#define BLK_MAX_REQUEST_COUNT 16
Shaohua Li50d24c32016-11-03 17:03:53 -07001134#define BLK_PLUG_FLUSH_SIZE (128 * 1024)
Shaohua Li55c022b2011-07-08 08:19:20 +02001135
NeilBrown9cbb1752012-07-31 09:08:14 +02001136struct blk_plug_cb;
NeilBrown74018dc2012-07-31 09:08:15 +02001137typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
NeilBrown048c9372011-04-18 09:52:22 +02001138struct blk_plug_cb {
1139 struct list_head list;
NeilBrown9cbb1752012-07-31 09:08:14 +02001140 blk_plug_cb_fn callback;
1141 void *data;
NeilBrown048c9372011-04-18 09:52:22 +02001142};
NeilBrown9cbb1752012-07-31 09:08:14 +02001143extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
1144 void *data, int size);
Jens Axboe73c10102011-03-08 13:19:51 +01001145extern void blk_start_plug(struct blk_plug *);
1146extern void blk_finish_plug(struct blk_plug *);
Jens Axboef6603782011-04-15 15:49:07 +02001147extern void blk_flush_plug_list(struct blk_plug *, bool);
Jens Axboe73c10102011-03-08 13:19:51 +01001148
1149static inline void blk_flush_plug(struct task_struct *tsk)
1150{
1151 struct blk_plug *plug = tsk->plug;
1152
Christoph Hellwig88b996c2011-04-15 15:20:10 +02001153 if (plug)
Jens Axboea237c1c2011-04-16 13:27:55 +02001154 blk_flush_plug_list(plug, false);
1155}
1156
1157static inline void blk_schedule_flush_plug(struct task_struct *tsk)
1158{
1159 struct blk_plug *plug = tsk->plug;
1160
1161 if (plug)
Jens Axboef6603782011-04-15 15:49:07 +02001162 blk_flush_plug_list(plug, true);
Jens Axboe73c10102011-03-08 13:19:51 +01001163}
1164
1165static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1166{
1167 struct blk_plug *plug = tsk->plug;
1168
Jens Axboe320ae512013-10-24 09:20:05 +01001169 return plug &&
Jens Axboea1ce35f2018-10-29 10:23:51 -06001170 (!list_empty(&plug->mq_list) ||
Jens Axboe320ae512013-10-24 09:20:05 +01001171 !list_empty(&plug->cb_list));
Jens Axboe73c10102011-03-08 13:19:51 +01001172}
1173
Christoph Hellwigee472d82017-04-05 19:21:08 +02001174extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
1175extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
1176 sector_t nr_sects, gfp_t gfp_mask, struct page *page);
Christoph Hellwige950fdf2016-07-19 11:23:33 +02001177
1178#define BLKDEV_DISCARD_SECURE (1 << 0) /* issue a secure erase */
Christoph Hellwigdd3932e2010-09-16 20:51:46 +02001179
Dmitry Monakhovfbd9b092010-04-28 17:55:06 +04001180extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1181 sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
Christoph Hellwig38f25252016-04-16 14:55:28 -04001182extern int __blkdev_issue_discard(struct block_device *bdev, sector_t sector,
Christoph Hellwig288dab82016-06-09 16:00:36 +02001183 sector_t nr_sects, gfp_t gfp_mask, int flags,
Mike Christie469e3212016-06-05 14:31:49 -05001184 struct bio **biop);
Christoph Hellwigee472d82017-04-05 19:21:08 +02001185
1186#define BLKDEV_ZERO_NOUNMAP (1 << 0) /* do not free blocks */
Christoph Hellwigcb365b92017-04-05 19:21:10 +02001187#define BLKDEV_ZERO_NOFALLBACK (1 << 1) /* don't write explicit zeroes */
Christoph Hellwigee472d82017-04-05 19:21:08 +02001188
Chaitanya Kulkarnie73c23f2016-11-30 12:28:58 -08001189extern int __blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
1190 sector_t nr_sects, gfp_t gfp_mask, struct bio **biop,
Christoph Hellwigee472d82017-04-05 19:21:08 +02001191 unsigned flags);
Dmitry Monakhov3f14d792010-04-28 17:55:09 +04001192extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
Christoph Hellwigee472d82017-04-05 19:21:08 +02001193 sector_t nr_sects, gfp_t gfp_mask, unsigned flags);
1194
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001195static inline int sb_issue_discard(struct super_block *sb, sector_t block,
1196 sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
David Woodhousefb2dce82008-08-05 18:01:53 +01001197{
Bart Van Assche233bde22018-03-14 15:48:06 -07001198 return blkdev_issue_discard(sb->s_bdev,
1199 block << (sb->s_blocksize_bits -
1200 SECTOR_SHIFT),
1201 nr_blocks << (sb->s_blocksize_bits -
1202 SECTOR_SHIFT),
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001203 gfp_mask, flags);
David Woodhousefb2dce82008-08-05 18:01:53 +01001204}
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001205static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
Theodore Ts'oa107e5a2010-10-27 23:44:47 -04001206 sector_t nr_blocks, gfp_t gfp_mask)
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001207{
1208 return blkdev_issue_zeroout(sb->s_bdev,
Bart Van Assche233bde22018-03-14 15:48:06 -07001209 block << (sb->s_blocksize_bits -
1210 SECTOR_SHIFT),
1211 nr_blocks << (sb->s_blocksize_bits -
1212 SECTOR_SHIFT),
Christoph Hellwigee472d82017-04-05 19:21:08 +02001213 gfp_mask, 0);
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001214}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001215
Christoph Hellwigf00c4d82017-11-05 10:36:31 +03001216extern int blk_verify_command(unsigned char *cmd, fmode_t mode);
Adel Gadllah0b07de82008-06-26 13:48:27 +02001217
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001218enum blk_default_limits {
1219 BLK_MAX_SEGMENTS = 128,
1220 BLK_SAFE_MAX_SECTORS = 255,
Jeff Moyerd2be5372015-08-13 14:57:57 -04001221 BLK_DEF_MAX_SECTORS = 2560,
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001222 BLK_MAX_SEGMENT_SIZE = 65536,
1223 BLK_SEG_BOUNDARY_MASK = 0xFFFFFFFFUL,
1224};
Milan Broz0e435ac2008-12-03 12:55:08 +01001225
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001226static inline unsigned long queue_segment_boundary(struct request_queue *q)
1227{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001228 return q->limits.seg_boundary_mask;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001229}
1230
Keith Busch03100aa2015-08-19 14:24:05 -07001231static inline unsigned long queue_virt_boundary(struct request_queue *q)
1232{
1233 return q->limits.virt_boundary_mask;
1234}
1235
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001236static inline unsigned int queue_max_sectors(struct request_queue *q)
1237{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001238 return q->limits.max_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001239}
1240
1241static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1242{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001243 return q->limits.max_hw_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001244}
1245
Martin K. Petersen8a783622010-02-26 00:20:39 -05001246static inline unsigned short queue_max_segments(struct request_queue *q)
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001247{
Martin K. Petersen8a783622010-02-26 00:20:39 -05001248 return q->limits.max_segments;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001249}
1250
Christoph Hellwig1e739732017-02-08 14:46:49 +01001251static inline unsigned short queue_max_discard_segments(struct request_queue *q)
1252{
1253 return q->limits.max_discard_segments;
1254}
1255
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001256static inline unsigned int queue_max_segment_size(struct request_queue *q)
1257{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001258 return q->limits.max_segment_size;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001259}
1260
Martin K. Petersene1defc42009-05-22 17:17:49 -04001261static inline unsigned short queue_logical_block_size(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001262{
1263 int retval = 512;
1264
Martin K. Petersen025146e2009-05-22 17:17:51 -04001265 if (q && q->limits.logical_block_size)
1266 retval = q->limits.logical_block_size;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001267
1268 return retval;
1269}
1270
Martin K. Petersene1defc42009-05-22 17:17:49 -04001271static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001272{
Martin K. Petersene1defc42009-05-22 17:17:49 -04001273 return queue_logical_block_size(bdev_get_queue(bdev));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001274}
1275
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001276static inline unsigned int queue_physical_block_size(struct request_queue *q)
1277{
1278 return q->limits.physical_block_size;
1279}
1280
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001281static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
Martin K. Petersenac481c22009-10-03 20:52:01 +02001282{
1283 return queue_physical_block_size(bdev_get_queue(bdev));
1284}
1285
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001286static inline unsigned int queue_io_min(struct request_queue *q)
1287{
1288 return q->limits.io_min;
1289}
1290
Martin K. Petersenac481c22009-10-03 20:52:01 +02001291static inline int bdev_io_min(struct block_device *bdev)
1292{
1293 return queue_io_min(bdev_get_queue(bdev));
1294}
1295
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001296static inline unsigned int queue_io_opt(struct request_queue *q)
1297{
1298 return q->limits.io_opt;
1299}
1300
Martin K. Petersenac481c22009-10-03 20:52:01 +02001301static inline int bdev_io_opt(struct block_device *bdev)
1302{
1303 return queue_io_opt(bdev_get_queue(bdev));
1304}
1305
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001306static inline int queue_alignment_offset(struct request_queue *q)
1307{
Martin K. Petersenac481c22009-10-03 20:52:01 +02001308 if (q->limits.misaligned)
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001309 return -1;
1310
Martin K. Petersenac481c22009-10-03 20:52:01 +02001311 return q->limits.alignment_offset;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001312}
1313
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001314static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001315{
1316 unsigned int granularity = max(lim->physical_block_size, lim->io_min);
Bart Van Assche233bde22018-03-14 15:48:06 -07001317 unsigned int alignment = sector_div(sector, granularity >> SECTOR_SHIFT)
1318 << SECTOR_SHIFT;
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001319
Mike Snitzerb8839b82014-10-08 18:26:13 -04001320 return (granularity + lim->alignment_offset - alignment) % granularity;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001321}
1322
Martin K. Petersenac481c22009-10-03 20:52:01 +02001323static inline int bdev_alignment_offset(struct block_device *bdev)
1324{
1325 struct request_queue *q = bdev_get_queue(bdev);
1326
1327 if (q->limits.misaligned)
1328 return -1;
1329
1330 if (bdev != bdev->bd_contains)
1331 return bdev->bd_part->alignment_offset;
1332
1333 return q->limits.alignment_offset;
1334}
1335
Martin K. Petersen86b37282009-11-10 11:50:21 +01001336static inline int queue_discard_alignment(struct request_queue *q)
1337{
1338 if (q->limits.discard_misaligned)
1339 return -1;
1340
1341 return q->limits.discard_alignment;
1342}
1343
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001344static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
Martin K. Petersen86b37282009-11-10 11:50:21 +01001345{
Linus Torvalds59771072012-12-19 07:18:35 -08001346 unsigned int alignment, granularity, offset;
Martin K. Petersendd3d1452010-01-11 03:21:48 -05001347
Martin K. Petersena934a002011-05-18 10:37:35 +02001348 if (!lim->max_discard_sectors)
1349 return 0;
1350
Linus Torvalds59771072012-12-19 07:18:35 -08001351 /* Why are these in bytes, not sectors? */
Bart Van Assche233bde22018-03-14 15:48:06 -07001352 alignment = lim->discard_alignment >> SECTOR_SHIFT;
1353 granularity = lim->discard_granularity >> SECTOR_SHIFT;
Linus Torvalds59771072012-12-19 07:18:35 -08001354 if (!granularity)
1355 return 0;
1356
1357 /* Offset of the partition start in 'granularity' sectors */
1358 offset = sector_div(sector, granularity);
1359
1360 /* And why do we do this modulus *again* in blkdev_issue_discard()? */
1361 offset = (granularity + alignment - offset) % granularity;
1362
1363 /* Turn it back into bytes, gaah */
Bart Van Assche233bde22018-03-14 15:48:06 -07001364 return offset << SECTOR_SHIFT;
Martin K. Petersen86b37282009-11-10 11:50:21 +01001365}
1366
Paolo Bonzinic6e66632012-08-02 09:48:50 +02001367static inline int bdev_discard_alignment(struct block_device *bdev)
1368{
1369 struct request_queue *q = bdev_get_queue(bdev);
1370
1371 if (bdev != bdev->bd_contains)
1372 return bdev->bd_part->discard_alignment;
1373
1374 return q->limits.discard_alignment;
1375}
1376
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001377static inline unsigned int bdev_write_same(struct block_device *bdev)
1378{
1379 struct request_queue *q = bdev_get_queue(bdev);
1380
1381 if (q)
1382 return q->limits.max_write_same_sectors;
1383
1384 return 0;
1385}
1386
Chaitanya Kulkarnia6f07882016-11-30 12:28:59 -08001387static inline unsigned int bdev_write_zeroes_sectors(struct block_device *bdev)
1388{
1389 struct request_queue *q = bdev_get_queue(bdev);
1390
1391 if (q)
1392 return q->limits.max_write_zeroes_sectors;
1393
1394 return 0;
1395}
1396
Damien Le Moal797476b2016-10-18 15:40:29 +09001397static inline enum blk_zoned_model bdev_zoned_model(struct block_device *bdev)
1398{
1399 struct request_queue *q = bdev_get_queue(bdev);
1400
1401 if (q)
1402 return blk_queue_zoned_model(q);
1403
1404 return BLK_ZONED_NONE;
1405}
1406
1407static inline bool bdev_is_zoned(struct block_device *bdev)
1408{
1409 struct request_queue *q = bdev_get_queue(bdev);
1410
1411 if (q)
1412 return blk_queue_is_zoned(q);
1413
1414 return false;
1415}
1416
Damien Le Moalf99e8642017-01-12 07:58:32 -07001417static inline unsigned int bdev_zone_sectors(struct block_device *bdev)
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +09001418{
1419 struct request_queue *q = bdev_get_queue(bdev);
1420
1421 if (q)
Damien Le Moalf99e8642017-01-12 07:58:32 -07001422 return blk_queue_zone_sectors(q);
Christoph Hellwig6cc77e92017-12-21 15:43:38 +09001423 return 0;
1424}
Hannes Reinecke6a0cb1b2016-10-18 15:40:33 +09001425
Jens Axboe165125e2007-07-24 09:28:11 +02001426static inline int queue_dma_alignment(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001427{
Pete Wyckoff482eb682008-01-01 10:23:02 -05001428 return q ? q->dma_alignment : 511;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001429}
1430
Namhyung Kim14417792010-09-15 13:08:27 +02001431static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
FUJITA Tomonori87904072008-08-28 15:05:58 +09001432 unsigned int len)
1433{
1434 unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
Namhyung Kim14417792010-09-15 13:08:27 +02001435 return !(addr & alignment) && !(len & alignment);
FUJITA Tomonori87904072008-08-28 15:05:58 +09001436}
1437
Linus Torvalds1da177e2005-04-16 15:20:36 -07001438/* assumes size > 256 */
1439static inline unsigned int blksize_bits(unsigned int size)
1440{
1441 unsigned int bits = 8;
1442 do {
1443 bits++;
1444 size >>= 1;
1445 } while (size > 256);
1446 return bits;
1447}
1448
Adrian Bunk2befb9e2005-09-10 00:27:17 -07001449static inline unsigned int block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001450{
1451 return bdev->bd_block_size;
1452}
1453
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001454static inline bool queue_flush_queueable(struct request_queue *q)
1455{
Jens Axboec888a8f2016-04-13 13:33:19 -06001456 return !test_bit(QUEUE_FLAG_FLUSH_NQ, &q->queue_flags);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001457}
1458
Linus Torvalds1da177e2005-04-16 15:20:36 -07001459typedef struct {struct page *v;} Sector;
1460
1461unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
1462
1463static inline void put_dev_sector(Sector p)
1464{
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001465 put_page(p.v);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001466}
1467
Jens Axboe59c3d452014-04-08 09:15:35 -06001468int kblockd_schedule_work(struct work_struct *work);
Jens Axboeee63cfa2016-08-24 15:52:48 -06001469int kblockd_schedule_work_on(int cpu, struct work_struct *work);
Jens Axboe818cd1c2017-04-10 09:54:55 -06001470int kblockd_mod_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001471
Linus Torvalds1da177e2005-04-16 15:20:36 -07001472#define MODULE_ALIAS_BLOCKDEV(major,minor) \
1473 MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
1474#define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
1475 MODULE_ALIAS("block-major-" __stringify(major) "-*")
1476
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001477#if defined(CONFIG_BLK_DEV_INTEGRITY)
1478
Martin K. Petersen8288f492014-09-26 19:20:02 -04001479enum blk_integrity_flags {
1480 BLK_INTEGRITY_VERIFY = 1 << 0,
1481 BLK_INTEGRITY_GENERATE = 1 << 1,
Martin K. Petersen3aec2f42014-09-26 19:20:03 -04001482 BLK_INTEGRITY_DEVICE_CAPABLE = 1 << 2,
Martin K. Petersenaae7df52014-09-26 19:20:05 -04001483 BLK_INTEGRITY_IP_CHECKSUM = 1 << 3,
Martin K. Petersen8288f492014-09-26 19:20:02 -04001484};
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001485
Martin K. Petersen18593082014-09-26 19:20:01 -04001486struct blk_integrity_iter {
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001487 void *prot_buf;
1488 void *data_buf;
Martin K. Petersen3be91c42014-09-26 19:19:59 -04001489 sector_t seed;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001490 unsigned int data_size;
Martin K. Petersen3be91c42014-09-26 19:19:59 -04001491 unsigned short interval;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001492 const char *disk_name;
1493};
1494
Christoph Hellwig4e4cbee2017-06-03 09:38:06 +02001495typedef blk_status_t (integrity_processing_fn) (struct blk_integrity_iter *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001496
Martin K. Petersen0f8087e2015-10-21 13:19:33 -04001497struct blk_integrity_profile {
1498 integrity_processing_fn *generate_fn;
1499 integrity_processing_fn *verify_fn;
1500 const char *name;
1501};
1502
Martin K. Petersen25520d52015-10-21 13:19:49 -04001503extern void blk_integrity_register(struct gendisk *, struct blk_integrity *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001504extern void blk_integrity_unregister(struct gendisk *);
Martin K. Petersenad7fce92008-10-01 03:38:39 -04001505extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001506extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
1507 struct scatterlist *);
1508extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001509extern bool blk_integrity_merge_rq(struct request_queue *, struct request *,
1510 struct request *);
1511extern bool blk_integrity_merge_bio(struct request_queue *, struct request *,
1512 struct bio *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001513
Martin K. Petersen25520d52015-10-21 13:19:49 -04001514static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1515{
Dan Williamsac6fc482015-10-21 13:20:18 -04001516 struct blk_integrity *bi = &disk->queue->integrity;
Martin K. Petersen25520d52015-10-21 13:19:49 -04001517
1518 if (!bi->profile)
1519 return NULL;
1520
1521 return bi;
1522}
1523
Jens Axboeb04accc2008-10-02 12:53:22 +02001524static inline
1525struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1526{
Martin K. Petersen25520d52015-10-21 13:19:49 -04001527 return blk_get_integrity(bdev->bd_disk);
Martin K. Petersenb02739b2008-10-02 18:47:49 +02001528}
1529
Martin K. Petersen180b2f92014-09-26 19:19:56 -04001530static inline bool blk_integrity_rq(struct request *rq)
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001531{
Martin K. Petersen180b2f92014-09-26 19:19:56 -04001532 return rq->cmd_flags & REQ_INTEGRITY;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001533}
1534
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001535static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1536 unsigned int segs)
1537{
1538 q->limits.max_integrity_segments = segs;
1539}
1540
1541static inline unsigned short
1542queue_max_integrity_segments(struct request_queue *q)
1543{
1544 return q->limits.max_integrity_segments;
1545}
1546
Greg Edwards359f6422018-07-25 10:22:58 -04001547/**
1548 * bio_integrity_intervals - Return number of integrity intervals for a bio
1549 * @bi: blk_integrity profile for device
1550 * @sectors: Size of the bio in 512-byte sectors
1551 *
1552 * Description: The block layer calculates everything in 512 byte
1553 * sectors but integrity metadata is done in terms of the data integrity
1554 * interval size of the storage device. Convert the block layer sectors
1555 * to the appropriate number of integrity intervals.
1556 */
1557static inline unsigned int bio_integrity_intervals(struct blk_integrity *bi,
1558 unsigned int sectors)
1559{
1560 return sectors >> (bi->interval_exp - 9);
1561}
1562
1563static inline unsigned int bio_integrity_bytes(struct blk_integrity *bi,
1564 unsigned int sectors)
1565{
1566 return bio_integrity_intervals(bi, sectors) * bi->tuple_size;
1567}
1568
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001569#else /* CONFIG_BLK_DEV_INTEGRITY */
1570
Stephen Rothwellfd832402012-01-12 09:17:30 +01001571struct bio;
1572struct block_device;
1573struct gendisk;
1574struct blk_integrity;
1575
1576static inline int blk_integrity_rq(struct request *rq)
1577{
1578 return 0;
1579}
1580static inline int blk_rq_count_integrity_sg(struct request_queue *q,
1581 struct bio *b)
1582{
1583 return 0;
1584}
1585static inline int blk_rq_map_integrity_sg(struct request_queue *q,
1586 struct bio *b,
1587 struct scatterlist *s)
1588{
1589 return 0;
1590}
1591static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
1592{
Michele Curti61a04e52014-10-09 15:30:17 -07001593 return NULL;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001594}
1595static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1596{
1597 return NULL;
1598}
1599static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
1600{
1601 return 0;
1602}
Martin K. Petersen25520d52015-10-21 13:19:49 -04001603static inline void blk_integrity_register(struct gendisk *d,
Stephen Rothwellfd832402012-01-12 09:17:30 +01001604 struct blk_integrity *b)
1605{
Stephen Rothwellfd832402012-01-12 09:17:30 +01001606}
1607static inline void blk_integrity_unregister(struct gendisk *d)
1608{
1609}
1610static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1611 unsigned int segs)
1612{
1613}
1614static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
1615{
1616 return 0;
1617}
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001618static inline bool blk_integrity_merge_rq(struct request_queue *rq,
1619 struct request *r1,
1620 struct request *r2)
Stephen Rothwellfd832402012-01-12 09:17:30 +01001621{
Martin K. Petersencb1a5ab2014-10-28 20:27:43 -06001622 return true;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001623}
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001624static inline bool blk_integrity_merge_bio(struct request_queue *rq,
1625 struct request *r,
1626 struct bio *b)
Stephen Rothwellfd832402012-01-12 09:17:30 +01001627{
Martin K. Petersencb1a5ab2014-10-28 20:27:43 -06001628 return true;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001629}
Martin K. Petersen25520d52015-10-21 13:19:49 -04001630
Greg Edwards359f6422018-07-25 10:22:58 -04001631static inline unsigned int bio_integrity_intervals(struct blk_integrity *bi,
1632 unsigned int sectors)
1633{
1634 return 0;
1635}
1636
1637static inline unsigned int bio_integrity_bytes(struct blk_integrity *bi,
1638 unsigned int sectors)
1639{
1640 return 0;
1641}
1642
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001643#endif /* CONFIG_BLK_DEV_INTEGRITY */
1644
Al Viro08f85852007-10-08 13:26:20 -04001645struct block_device_operations {
Al Virod4430d62008-03-02 09:09:22 -05001646 int (*open) (struct block_device *, fmode_t);
Al Virodb2a1442013-05-05 21:52:57 -04001647 void (*release) (struct gendisk *, fmode_t);
Tejun Heo3f289dc2018-07-18 04:47:36 -07001648 int (*rw_page)(struct block_device *, sector_t, struct page *, unsigned int);
Al Virod4430d62008-03-02 09:09:22 -05001649 int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1650 int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
Tejun Heo77ea8872010-12-08 20:57:37 +01001651 unsigned int (*check_events) (struct gendisk *disk,
1652 unsigned int clearing);
1653 /* ->media_changed() is DEPRECATED, use ->check_events() instead */
Al Viro08f85852007-10-08 13:26:20 -04001654 int (*media_changed) (struct gendisk *);
Tejun Heoc3e33e02010-05-15 20:09:29 +02001655 void (*unlock_native_capacity) (struct gendisk *);
Al Viro08f85852007-10-08 13:26:20 -04001656 int (*revalidate_disk) (struct gendisk *);
1657 int (*getgeo)(struct block_device *, struct hd_geometry *);
Nitin Guptab3a27d02010-05-17 11:02:43 +05301658 /* this callback is with swap_lock and sometimes page table lock held */
1659 void (*swap_slot_free_notify) (struct block_device *, unsigned long);
Christoph Hellwige76239a2018-10-12 19:08:49 +09001660 int (*report_zones)(struct gendisk *, sector_t sector,
1661 struct blk_zone *zones, unsigned int *nr_zones,
1662 gfp_t gfp_mask);
Al Viro08f85852007-10-08 13:26:20 -04001663 struct module *owner;
Christoph Hellwigbbd3e062015-10-15 14:10:48 +02001664 const struct pr_ops *pr_ops;
Al Viro08f85852007-10-08 13:26:20 -04001665};
1666
Al Viro633a08b2007-08-29 20:34:12 -04001667extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1668 unsigned long);
Matthew Wilcox47a191f2014-06-04 16:07:46 -07001669extern int bdev_read_page(struct block_device *, sector_t, struct page *);
1670extern int bdev_write_page(struct block_device *, sector_t, struct page *,
1671 struct writeback_control *);
Christoph Hellwig6cc77e92017-12-21 15:43:38 +09001672
1673#ifdef CONFIG_BLK_DEV_ZONED
1674bool blk_req_needs_zone_write_lock(struct request *rq);
1675void __blk_req_zone_write_lock(struct request *rq);
1676void __blk_req_zone_write_unlock(struct request *rq);
1677
1678static inline void blk_req_zone_write_lock(struct request *rq)
1679{
1680 if (blk_req_needs_zone_write_lock(rq))
1681 __blk_req_zone_write_lock(rq);
1682}
1683
1684static inline void blk_req_zone_write_unlock(struct request *rq)
1685{
1686 if (rq->rq_flags & RQF_ZONE_WRITE_LOCKED)
1687 __blk_req_zone_write_unlock(rq);
1688}
1689
1690static inline bool blk_req_zone_is_write_locked(struct request *rq)
1691{
1692 return rq->q->seq_zones_wlock &&
1693 test_bit(blk_rq_zone_no(rq), rq->q->seq_zones_wlock);
1694}
1695
1696static inline bool blk_req_can_dispatch_to_zone(struct request *rq)
1697{
1698 if (!blk_req_needs_zone_write_lock(rq))
1699 return true;
1700 return !blk_req_zone_is_write_locked(rq);
1701}
1702#else
1703static inline bool blk_req_needs_zone_write_lock(struct request *rq)
1704{
1705 return false;
1706}
1707
1708static inline void blk_req_zone_write_lock(struct request *rq)
1709{
1710}
1711
1712static inline void blk_req_zone_write_unlock(struct request *rq)
1713{
1714}
1715static inline bool blk_req_zone_is_write_locked(struct request *rq)
1716{
1717 return false;
1718}
1719
1720static inline bool blk_req_can_dispatch_to_zone(struct request *rq)
1721{
1722 return true;
1723}
1724#endif /* CONFIG_BLK_DEV_ZONED */
1725
David Howells93614012006-09-30 20:45:40 +02001726#else /* CONFIG_BLOCK */
Fabian Frederickac13a822014-06-04 16:06:27 -07001727
1728struct block_device;
1729
David Howells93614012006-09-30 20:45:40 +02001730/*
1731 * stubs for when the block layer is configured out
1732 */
1733#define buffer_heads_over_limit 0
1734
David Howells93614012006-09-30 20:45:40 +02001735static inline long nr_blockdev_pages(void)
1736{
1737 return 0;
1738}
1739
Jens Axboe1f940bd2011-03-11 20:17:08 +01001740struct blk_plug {
1741};
1742
1743static inline void blk_start_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001744{
1745}
1746
Jens Axboe1f940bd2011-03-11 20:17:08 +01001747static inline void blk_finish_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001748{
1749}
1750
Jens Axboe1f940bd2011-03-11 20:17:08 +01001751static inline void blk_flush_plug(struct task_struct *task)
Jens Axboe73c10102011-03-08 13:19:51 +01001752{
1753}
1754
Jens Axboea237c1c2011-04-16 13:27:55 +02001755static inline void blk_schedule_flush_plug(struct task_struct *task)
1756{
1757}
1758
1759
Jens Axboe73c10102011-03-08 13:19:51 +01001760static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1761{
1762 return false;
1763}
1764
Fabian Frederickac13a822014-06-04 16:06:27 -07001765static inline int blkdev_issue_flush(struct block_device *bdev, gfp_t gfp_mask,
1766 sector_t *error_sector)
1767{
1768 return 0;
1769}
1770
David Howells93614012006-09-30 20:45:40 +02001771#endif /* CONFIG_BLOCK */
1772
Jens Axboe06193172018-11-13 21:16:54 -07001773static inline void blk_wake_io_task(struct task_struct *waiter)
1774{
1775 /*
1776 * If we're polling, the task itself is doing the completions. For
1777 * that case, we don't need to signal a wakeup, it's enough to just
1778 * mark us as RUNNING.
1779 */
1780 if (waiter == current)
1781 __set_current_state(TASK_RUNNING);
1782 else
1783 wake_up_process(waiter);
1784}
1785
Linus Torvalds1da177e2005-04-16 15:20:36 -07001786#endif