blob: 848aab6c698239a1f432cd8dc0bceec79394c203 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _LINUX_BLKDEV_H
2#define _LINUX_BLKDEV_H
3
Russell King85fd0bc2012-05-14 08:29:23 +02004#include <linux/sched.h>
5
Jens Axboef5ff8422007-09-21 09:19:54 +02006#ifdef CONFIG_BLOCK
7
Linus Torvalds1da177e2005-04-16 15:20:36 -07008#include <linux/major.h>
9#include <linux/genhd.h>
10#include <linux/list.h>
Jens Axboe320ae512013-10-24 09:20:05 +010011#include <linux/llist.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070012#include <linux/timer.h>
13#include <linux/workqueue.h>
14#include <linux/pagemap.h>
Tejun Heo66114ca2015-05-22 17:13:32 -040015#include <linux/backing-dev-defs.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070016#include <linux/wait.h>
17#include <linux/mempool.h>
Dan Williams34c0fd52016-01-15 16:56:14 -080018#include <linux/pfn.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070019#include <linux/bio.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070020#include <linux/stringify.h>
Hugh Dickins3e6053d2008-09-11 10:57:55 +020021#include <linux/gfp.h>
FUJITA Tomonorid351af02007-07-09 12:40:35 +020022#include <linux/bsg.h>
Jens Axboec7c22e42008-09-13 20:26:01 +020023#include <linux/smp.h>
Tejun Heo548bc8e2013-01-09 08:05:13 -080024#include <linux/rcupdate.h>
Tejun Heoadd703f2014-07-01 10:34:38 -060025#include <linux/percpu-refcount.h>
Christoph Hellwig84be4562015-05-01 12:46:15 +020026#include <linux/scatterlist.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070027
Paul Gortmakerde477252011-05-26 13:46:22 -040028struct module;
Christoph Hellwig21b2f0c2006-03-22 17:52:04 +010029struct scsi_ioctl_command;
30
Linus Torvalds1da177e2005-04-16 15:20:36 -070031struct request_queue;
Linus Torvalds1da177e2005-04-16 15:20:36 -070032struct elevator_queue;
Jens Axboe2056a782006-03-23 20:00:26 +010033struct blk_trace;
Jens Axboe3d6392c2007-07-09 12:38:05 +020034struct request;
35struct sg_io_hdr;
Mike Christieaa387cc2011-07-31 22:05:09 +020036struct bsg_job;
Tejun Heo3c798392012-04-16 13:57:25 -070037struct blkcg_gq;
Ming Lei7c94e1c2014-09-25 23:23:43 +080038struct blk_flush_queue;
Christoph Hellwigbbd3e062015-10-15 14:10:48 +020039struct pr_ops;
Linus Torvalds1da177e2005-04-16 15:20:36 -070040
41#define BLKDEV_MIN_RQ 4
42#define BLKDEV_MAX_RQ 128 /* Default maximum */
43
Tejun Heo8bd435b2012-04-13 13:11:28 -070044/*
45 * Maximum number of blkcg policies allowed to be registered concurrently.
46 * Defined here to simplify include dependency.
47 */
48#define BLKCG_MAX_POLS 2
49
Tejun Heo8ffdc652006-01-06 09:49:03 +010050typedef void (rq_end_io_fn)(struct request *, int);
Linus Torvalds1da177e2005-04-16 15:20:36 -070051
Tejun Heo5b788ce2012-06-04 20:40:59 -070052#define BLK_RL_SYNCFULL (1U << 0)
53#define BLK_RL_ASYNCFULL (1U << 1)
54
Linus Torvalds1da177e2005-04-16 15:20:36 -070055struct request_list {
Tejun Heo5b788ce2012-06-04 20:40:59 -070056 struct request_queue *q; /* the queue this rl belongs to */
Tejun Heoa0516612012-06-26 15:05:44 -070057#ifdef CONFIG_BLK_CGROUP
58 struct blkcg_gq *blkg; /* blkg this request pool belongs to */
59#endif
Jens Axboe1faa16d2009-04-06 14:48:01 +020060 /*
61 * count[], starved[], and wait[] are indexed by
62 * BLK_RW_SYNC/BLK_RW_ASYNC
63 */
Tejun Heo8a5ecdd2012-06-04 20:40:58 -070064 int count[2];
65 int starved[2];
66 mempool_t *rq_pool;
67 wait_queue_head_t wait[2];
Tejun Heo5b788ce2012-06-04 20:40:59 -070068 unsigned int flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -070069};
70
Jens Axboe4aff5e22006-08-10 08:44:47 +020071/*
72 * request command types
73 */
74enum rq_cmd_type_bits {
75 REQ_TYPE_FS = 1, /* fs request */
76 REQ_TYPE_BLOCK_PC, /* scsi command */
Christoph Hellwigb42171e2015-04-17 22:37:17 +020077 REQ_TYPE_DRV_PRIV, /* driver defined types from here */
Jens Axboe4aff5e22006-08-10 08:44:47 +020078};
79
Linus Torvalds1da177e2005-04-16 15:20:36 -070080#define BLK_MAX_CDB 16
81
82/*
Christoph Hellwigaf76e552014-05-06 12:12:45 +020083 * Try to put the fields that are referenced together in the same cacheline.
84 *
85 * If you modify this structure, make sure to update blk_rq_init() and
86 * especially blk_mq_rq_ctx_init() to take care of the added fields.
Linus Torvalds1da177e2005-04-16 15:20:36 -070087 */
88struct request {
Christoph Hellwig6897fc22014-01-30 15:45:47 -080089 struct list_head queuelist;
Jens Axboe320ae512013-10-24 09:20:05 +010090 union {
91 struct call_single_data csd;
Jan Kara9828c2c2016-06-28 09:03:59 +020092 u64 fifo_time;
Jens Axboe320ae512013-10-24 09:20:05 +010093 };
Jens Axboeff856ba2006-01-09 16:02:34 +010094
Jens Axboe165125e2007-07-24 09:28:11 +020095 struct request_queue *q;
Jens Axboe320ae512013-10-24 09:20:05 +010096 struct blk_mq_ctx *mq_ctx;
Jens Axboee6a1c872006-08-10 09:00:21 +020097
Richard Kennedy181fdde2010-03-19 08:58:16 +010098 int cpu;
Christoph Hellwigca93e452016-06-09 16:00:35 +020099 unsigned cmd_type;
100 u64 cmd_flags;
101 unsigned long atomic_flags;
Richard Kennedy181fdde2010-03-19 08:58:16 +0100102
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900103 /* the following two fields are internal, NEVER access directly */
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900104 unsigned int __data_len; /* total data len */
Richard Kennedy181fdde2010-03-19 08:58:16 +0100105 sector_t __sector; /* sector cursor */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106
107 struct bio *bio;
108 struct bio *biotail;
109
Jens Axboe360f92c2014-04-09 20:27:01 -0600110 /*
111 * The hash is used inside the scheduler, and killed once the
112 * request reaches the dispatch list. The ipi_list is only used
113 * to queue the request for softirq completion, which is long
114 * after the request has been unhashed (and even removed from
115 * the dispatch list).
116 */
117 union {
118 struct hlist_node hash; /* merge hash */
119 struct list_head ipi_list;
120 };
121
Jens Axboee6a1c872006-08-10 09:00:21 +0200122 /*
123 * The rb_node is only used inside the io scheduler, requests
124 * are pruned when moved to the dispatch queue. So let the
Mike Snitzerc1867942011-02-11 11:08:00 +0100125 * completion_data share space with the rb_node.
Jens Axboee6a1c872006-08-10 09:00:21 +0200126 */
127 union {
128 struct rb_node rb_node; /* sort/lookup */
Mike Snitzerc1867942011-02-11 11:08:00 +0100129 void *completion_data;
Jens Axboee6a1c872006-08-10 09:00:21 +0200130 };
Jens Axboe98170642006-07-28 09:23:08 +0200131
Jens Axboeff7d1452006-07-12 14:04:37 +0200132 /*
Vivek Goyal7f1dc8a2010-04-21 17:44:16 +0200133 * Three pointers are available for the IO schedulers, if they need
Mike Snitzerc1867942011-02-11 11:08:00 +0100134 * more they have to dynamically allocate it. Flush requests are
135 * never put on the IO scheduler. So let the flush fields share
Tejun Heoa612fdd2011-12-14 00:33:41 +0100136 * space with the elevator data.
Jens Axboeff7d1452006-07-12 14:04:37 +0200137 */
Mike Snitzerc1867942011-02-11 11:08:00 +0100138 union {
Tejun Heoa612fdd2011-12-14 00:33:41 +0100139 struct {
140 struct io_cq *icq;
141 void *priv[2];
142 } elv;
143
Mike Snitzerc1867942011-02-11 11:08:00 +0100144 struct {
145 unsigned int seq;
146 struct list_head list;
Jeff Moyer4853aba2011-08-15 21:37:25 +0200147 rq_end_io_fn *saved_end_io;
Mike Snitzerc1867942011-02-11 11:08:00 +0100148 } flush;
149 };
Jens Axboeff7d1452006-07-12 14:04:37 +0200150
Jens Axboe8f34ee72006-06-13 09:02:34 +0200151 struct gendisk *rq_disk;
Jerome Marchand09e099d2011-01-05 16:57:38 +0100152 struct hd_struct *part;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700153 unsigned long start_time;
Divyesh Shah91952912010-04-01 15:01:41 -0700154#ifdef CONFIG_BLK_CGROUP
Tejun Heoa0516612012-06-26 15:05:44 -0700155 struct request_list *rl; /* rl this rq is alloced from */
Divyesh Shah91952912010-04-01 15:01:41 -0700156 unsigned long long start_time_ns;
157 unsigned long long io_start_time_ns; /* when passed to hardware */
158#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700159 /* Number of scatter-gather DMA addr+len pairs after
160 * physical address coalescing is performed.
161 */
162 unsigned short nr_phys_segments;
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200163#if defined(CONFIG_BLK_DEV_INTEGRITY)
164 unsigned short nr_integrity_segments;
165#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166
Jens Axboe8f34ee72006-06-13 09:02:34 +0200167 unsigned short ioprio;
168
Tejun Heo731ec492009-04-23 11:05:20 +0900169 void *special; /* opaque pointer available for LLD use */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700170
Jens Axboecdd60262006-07-28 09:32:07 +0200171 int tag;
172 int errors;
173
Linus Torvalds1da177e2005-04-16 15:20:36 -0700174 /*
175 * when request is used as a packet command carrier
176 */
FUJITA Tomonorid7e3c322008-04-29 09:54:39 +0200177 unsigned char __cmd[BLK_MAX_CDB];
178 unsigned char *cmd;
Richard Kennedy181fdde2010-03-19 08:58:16 +0100179 unsigned short cmd_len;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700180
FUJITA Tomonori7a85f882008-03-04 11:17:11 +0100181 unsigned int extra_len; /* length of alignment and padding */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700182 unsigned int sense_len;
Tejun Heoc3a4d782009-05-07 22:24:37 +0900183 unsigned int resid_len; /* residual count */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700184 void *sense;
185
Jens Axboe242f9dc2008-09-14 05:55:09 -0700186 unsigned long deadline;
187 struct list_head timeout_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700188 unsigned int timeout;
Mike Christie17e01f22005-11-11 05:31:37 -0600189 int retries;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190
191 /*
Jens Axboec00895a2006-09-30 20:29:12 +0200192 * completion callback.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700193 */
194 rq_end_io_fn *end_io;
195 void *end_io_data;
FUJITA Tomonoriabae1fd2007-07-16 08:52:14 +0200196
197 /* for bidi */
198 struct request *next_rq;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700199};
200
Mike Christie4e1b2d522016-06-05 14:32:22 -0500201#define REQ_OP_SHIFT (8 * sizeof(u64) - REQ_OP_BITS)
202#define req_op(req) ((req)->cmd_flags >> REQ_OP_SHIFT)
203
204#define req_set_op(req, op) do { \
205 WARN_ON(op >= (1 << REQ_OP_BITS)); \
206 (req)->cmd_flags &= ((1ULL << REQ_OP_SHIFT) - 1); \
207 (req)->cmd_flags |= ((u64) (op) << REQ_OP_SHIFT); \
208} while (0)
209
Mike Christief2150822016-06-05 14:31:42 -0500210#define req_set_op_attrs(req, op, flags) do { \
211 req_set_op(req, op); \
212 (req)->cmd_flags |= flags; \
213} while (0)
214
Christoph Hellwigf3216242017-01-31 16:57:29 +0100215static inline bool blk_rq_is_passthrough(struct request *rq)
216{
217 return rq->cmd_type != REQ_TYPE_FS;
218}
219
Fernando Luis Vázquez Cao766ca442008-08-14 09:59:13 +0200220static inline unsigned short req_get_ioprio(struct request *req)
221{
222 return req->ioprio;
223}
224
Linus Torvalds1da177e2005-04-16 15:20:36 -0700225#include <linux/elevator.h>
226
Jens Axboe320ae512013-10-24 09:20:05 +0100227struct blk_queue_ctx;
228
Jens Axboe165125e2007-07-24 09:28:11 +0200229typedef void (request_fn_proc) (struct request_queue *q);
Jens Axboedece1632015-11-05 10:41:16 -0700230typedef blk_qc_t (make_request_fn) (struct request_queue *q, struct bio *bio);
Jens Axboe165125e2007-07-24 09:28:11 +0200231typedef int (prep_rq_fn) (struct request_queue *, struct request *);
James Bottomley28018c22010-07-01 19:49:17 +0900232typedef void (unprep_rq_fn) (struct request_queue *, struct request *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700233
234struct bio_vec;
Jens Axboeff856ba2006-01-09 16:02:34 +0100235typedef void (softirq_done_fn)(struct request *);
Tejun Heo2fb98e82008-02-19 11:36:53 +0100236typedef int (dma_drain_needed_fn)(struct request *);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200237typedef int (lld_busy_fn) (struct request_queue *q);
Mike Christieaa387cc2011-07-31 22:05:09 +0200238typedef int (bsg_job_fn) (struct bsg_job *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700239
Jens Axboe242f9dc2008-09-14 05:55:09 -0700240enum blk_eh_timer_return {
241 BLK_EH_NOT_HANDLED,
242 BLK_EH_HANDLED,
243 BLK_EH_RESET_TIMER,
244};
245
246typedef enum blk_eh_timer_return (rq_timed_out_fn)(struct request *);
247
Linus Torvalds1da177e2005-04-16 15:20:36 -0700248enum blk_queue_state {
249 Queue_down,
250 Queue_up,
251};
252
Linus Torvalds1da177e2005-04-16 15:20:36 -0700253struct blk_queue_tag {
254 struct request **tag_index; /* map of busy tags */
255 unsigned long *tag_map; /* bit map of free/busy tags */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700256 int busy; /* current depth */
257 int max_depth; /* what we will send to device */
Tejun Heoba025082005-08-05 13:28:11 -0700258 int real_max_depth; /* what the array can hold */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700259 atomic_t refcnt; /* map can be shared */
Shaohua Liee1b6f72015-01-15 17:32:25 -0800260 int alloc_policy; /* tag allocation policy */
261 int next_tag; /* next tag */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700262};
Shaohua Liee1b6f72015-01-15 17:32:25 -0800263#define BLK_TAG_ALLOC_FIFO 0 /* allocate starting from 0 */
264#define BLK_TAG_ALLOC_RR 1 /* allocate starting from last allocated tag */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700265
FUJITA Tomonoriabf54392008-08-16 14:10:05 +0900266#define BLK_SCSI_MAX_CMDS (256)
267#define BLK_SCSI_CMD_PER_LONG (BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
268
Martin K. Petersen025146e2009-05-22 17:17:51 -0400269struct queue_limits {
270 unsigned long bounce_pfn;
271 unsigned long seg_boundary_mask;
Keith Busch03100aa2015-08-19 14:24:05 -0700272 unsigned long virt_boundary_mask;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400273
274 unsigned int max_hw_sectors;
Martin K. Petersenca369d52015-11-13 16:46:48 -0500275 unsigned int max_dev_sectors;
Jens Axboe762380a2014-06-05 13:38:39 -0600276 unsigned int chunk_sectors;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400277 unsigned int max_sectors;
278 unsigned int max_segment_size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400279 unsigned int physical_block_size;
Mikulas Patocka5dbde462020-01-15 08:35:25 -0500280 unsigned int logical_block_size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400281 unsigned int alignment_offset;
282 unsigned int io_min;
283 unsigned int io_opt;
Christoph Hellwig67efc922009-09-30 13:54:20 +0200284 unsigned int max_discard_sectors;
Jens Axboe0034af02015-07-16 09:14:26 -0600285 unsigned int max_hw_discard_sectors;
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400286 unsigned int max_write_same_sectors;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100287 unsigned int discard_granularity;
288 unsigned int discard_alignment;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400289
Martin K. Petersen8a783622010-02-26 00:20:39 -0500290 unsigned short max_segments;
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200291 unsigned short max_integrity_segments;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400292
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400293 unsigned char misaligned;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100294 unsigned char discard_misaligned;
Martin K. Petersene692cb62010-12-01 19:41:49 +0100295 unsigned char cluster;
Martin K. Petersena934a002011-05-18 10:37:35 +0200296 unsigned char discard_zeroes_data;
Kent Overstreetc78afc62013-07-11 22:39:53 -0700297 unsigned char raid_partial_stripes_expensive;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400298};
299
Richard Kennedyd7b76302011-07-13 21:17:23 +0200300struct request_queue {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700301 /*
302 * Together with queue_head for cacheline sharing
303 */
304 struct list_head queue_head;
305 struct request *last_merge;
Jens Axboeb374d182008-10-31 10:05:07 +0100306 struct elevator_queue *elevator;
Tejun Heo8a5ecdd2012-06-04 20:40:58 -0700307 int nr_rqs[2]; /* # allocated [a]sync rqs */
308 int nr_rqs_elvpriv; /* # allocated rqs w/ elvpriv */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700309
310 /*
Tejun Heoa0516612012-06-26 15:05:44 -0700311 * If blkcg is not used, @q->root_rl serves all requests. If blkcg
312 * is used, root blkg allocates from @q->root_rl and all other
313 * blkgs from their own blkg->rl. Which one to use should be
314 * determined using bio_request_list().
Linus Torvalds1da177e2005-04-16 15:20:36 -0700315 */
Tejun Heoa0516612012-06-26 15:05:44 -0700316 struct request_list root_rl;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700317
318 request_fn_proc *request_fn;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700319 make_request_fn *make_request_fn;
320 prep_rq_fn *prep_rq_fn;
James Bottomley28018c22010-07-01 19:49:17 +0900321 unprep_rq_fn *unprep_rq_fn;
Jens Axboeff856ba2006-01-09 16:02:34 +0100322 softirq_done_fn *softirq_done_fn;
Jens Axboe242f9dc2008-09-14 05:55:09 -0700323 rq_timed_out_fn *rq_timed_out_fn;
Tejun Heo2fb98e82008-02-19 11:36:53 +0100324 dma_drain_needed_fn *dma_drain_needed;
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200325 lld_busy_fn *lld_busy_fn;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700326
Jens Axboe320ae512013-10-24 09:20:05 +0100327 struct blk_mq_ops *mq_ops;
328
329 unsigned int *mq_map;
330
331 /* sw queues */
Ming Leie6cdb092014-06-03 11:24:06 +0800332 struct blk_mq_ctx __percpu *queue_ctx;
Jens Axboe320ae512013-10-24 09:20:05 +0100333 unsigned int nr_queues;
334
335 /* hw dispatch queues */
336 struct blk_mq_hw_ctx **queue_hw_ctx;
337 unsigned int nr_hw_queues;
338
Linus Torvalds1da177e2005-04-16 15:20:36 -0700339 /*
Tejun Heo8922e162005-10-20 16:23:44 +0200340 * Dispatch queue sorting
341 */
Jens Axboe1b47f532005-10-20 16:37:00 +0200342 sector_t end_sector;
Tejun Heo8922e162005-10-20 16:23:44 +0200343 struct request *boundary_rq;
Tejun Heo8922e162005-10-20 16:23:44 +0200344
345 /*
Jens Axboe3cca6dc2011-03-02 11:08:00 -0500346 * Delayed queue handling
Linus Torvalds1da177e2005-04-16 15:20:36 -0700347 */
Jens Axboe3cca6dc2011-03-02 11:08:00 -0500348 struct delayed_work delay_work;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700349
350 struct backing_dev_info backing_dev_info;
351
352 /*
353 * The queue owner gets to use this for whatever they like.
354 * ll_rw_blk doesn't touch it.
355 */
356 void *queuedata;
357
Linus Torvalds1da177e2005-04-16 15:20:36 -0700358 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700359 * various queue flags, see QUEUE_* below
360 */
361 unsigned long queue_flags;
362
363 /*
Tejun Heoa73f7302011-12-14 00:33:37 +0100364 * ida allocated id for this queue. Used to index queues from
365 * ioctx.
366 */
367 int id;
368
369 /*
Richard Kennedyd7b76302011-07-13 21:17:23 +0200370 * queue needs bounce pages for pages above this limit
371 */
372 gfp_t bounce_gfp;
373
374 /*
152587d2005-04-12 16:22:06 -0500375 * protects queue structures from reentrancy. ->__queue_lock should
376 * _never_ be used directly, it is queue private. always use
377 * ->queue_lock.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700378 */
152587d2005-04-12 16:22:06 -0500379 spinlock_t __queue_lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700380 spinlock_t *queue_lock;
381
382 /*
383 * queue kobject
384 */
385 struct kobject kobj;
386
Jens Axboe320ae512013-10-24 09:20:05 +0100387 /*
388 * mq queue kobject
389 */
390 struct kobject mq_kobj;
391
Dan Williamsac6fc482015-10-21 13:20:18 -0400392#ifdef CONFIG_BLK_DEV_INTEGRITY
393 struct blk_integrity integrity;
394#endif /* CONFIG_BLK_DEV_INTEGRITY */
395
Rafael J. Wysocki47fafbc2014-12-04 01:00:23 +0100396#ifdef CONFIG_PM
Lin Ming6c954662013-03-23 11:42:26 +0800397 struct device *dev;
398 int rpm_status;
399 unsigned int nr_pending;
400#endif
401
Linus Torvalds1da177e2005-04-16 15:20:36 -0700402 /*
403 * queue settings
404 */
405 unsigned long nr_requests; /* Max # of requests */
406 unsigned int nr_congestion_on;
407 unsigned int nr_congestion_off;
408 unsigned int nr_batching;
409
James Bottomleyfa0ccd82008-01-10 11:30:36 -0600410 unsigned int dma_drain_size;
Richard Kennedyd7b76302011-07-13 21:17:23 +0200411 void *dma_drain_buffer;
Tejun Heoe3790c72008-03-04 11:18:17 +0100412 unsigned int dma_pad_mask;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700413 unsigned int dma_alignment;
414
415 struct blk_queue_tag *queue_tags;
Jens Axboe6eca9002007-10-25 10:14:47 +0200416 struct list_head tag_busy_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700417
Tejun Heo15853af2005-11-10 08:52:05 +0100418 unsigned int nr_sorted;
Jens Axboe0a7ae2f2009-05-20 08:54:31 +0200419 unsigned int in_flight[2];
Bart Van Assche24faf6f2012-11-28 13:46:45 +0100420 /*
421 * Number of active block driver functions for which blk_drain_queue()
422 * must wait. Must be incremented around functions that unlock the
423 * queue_lock internally, e.g. scsi_request_fn().
424 */
425 unsigned int request_fn_active;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700426
Jens Axboe242f9dc2008-09-14 05:55:09 -0700427 unsigned int rq_timeout;
428 struct timer_list timeout;
Christoph Hellwig287922e2015-10-30 20:57:30 +0800429 struct work_struct timeout_work;
Jens Axboe242f9dc2008-09-14 05:55:09 -0700430 struct list_head timeout_list;
431
Tejun Heoa612fdd2011-12-14 00:33:41 +0100432 struct list_head icq_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800433#ifdef CONFIG_BLK_CGROUP
Tejun Heoa2b16932012-04-13 13:11:33 -0700434 DECLARE_BITMAP (blkcg_pols, BLKCG_MAX_POLS);
Tejun Heo3c798392012-04-16 13:57:25 -0700435 struct blkcg_gq *root_blkg;
Tejun Heo03aa2642012-03-05 13:15:19 -0800436 struct list_head blkg_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800437#endif
Tejun Heoa612fdd2011-12-14 00:33:41 +0100438
Martin K. Petersen025146e2009-05-22 17:17:51 -0400439 struct queue_limits limits;
440
Linus Torvalds1da177e2005-04-16 15:20:36 -0700441 /*
442 * sg stuff
443 */
444 unsigned int sg_timeout;
445 unsigned int sg_reserved_size;
Christoph Lameter19460892005-06-23 00:08:19 -0700446 int node;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700447#ifdef CONFIG_BLK_DEV_IO_TRACE
Jan Kara284dba62020-02-06 15:28:12 +0100448 struct blk_trace __rcu *blk_trace;
Waiman Longb4880922017-09-20 13:12:20 -0600449 struct mutex blk_trace_mutex;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700450#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700451 /*
Tejun Heo4913efe2010-09-03 11:56:16 +0200452 * for flush operations
Linus Torvalds1da177e2005-04-16 15:20:36 -0700453 */
Ming Lei7c94e1c2014-09-25 23:23:43 +0800454 struct blk_flush_queue *fq;
Al Viro483f4af2006-03-18 18:34:37 -0500455
Christoph Hellwig6fca6a62014-05-28 08:08:02 -0600456 struct list_head requeue_list;
457 spinlock_t requeue_lock;
Mike Snitzer28494502016-09-14 13:28:30 -0400458 struct delayed_work requeue_work;
Christoph Hellwig6fca6a62014-05-28 08:08:02 -0600459
Al Viro483f4af2006-03-18 18:34:37 -0500460 struct mutex sysfs_lock;
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200461
Tejun Heod7325802012-03-05 13:14:58 -0800462 int bypass_depth;
Christoph Hellwig4ecd4fe2015-05-07 09:38:13 +0200463 atomic_t mq_freeze_depth;
Tejun Heod7325802012-03-05 13:14:58 -0800464
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200465#if defined(CONFIG_BLK_DEV_BSG)
Mike Christieaa387cc2011-07-31 22:05:09 +0200466 bsg_job_fn *bsg_job_fn;
467 int bsg_job_size;
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200468 struct bsg_class_device bsg_dev;
469#endif
Vivek Goyale43473b2010-09-15 17:06:35 -0400470
471#ifdef CONFIG_BLK_DEV_THROTTLING
472 /* Throttle data */
473 struct throtl_data *td;
474#endif
Tejun Heo548bc8e2013-01-09 08:05:13 -0800475 struct rcu_head rcu_head;
Jens Axboe320ae512013-10-24 09:20:05 +0100476 wait_queue_head_t mq_freeze_wq;
Dan Williams3ef28e82015-10-21 13:20:12 -0400477 struct percpu_ref q_usage_counter;
Jens Axboe320ae512013-10-24 09:20:05 +0100478 struct list_head all_q_node;
Jens Axboe0d2602c2014-05-13 15:10:52 -0600479
480 struct blk_mq_tag_set *tag_set;
481 struct list_head tag_set_list;
Kent Overstreet54efd502015-04-23 22:37:18 -0700482 struct bio_set *bio_split;
Akinobu Mita4593fdb2015-09-27 02:09:20 +0900483
484 bool mq_sysfs_init_done;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700485};
486
Linus Torvalds1da177e2005-04-16 15:20:36 -0700487#define QUEUE_FLAG_QUEUED 1 /* uses generic tag queueing */
488#define QUEUE_FLAG_STOPPED 2 /* queue is stopped */
Jens Axboe1faa16d2009-04-06 14:48:01 +0200489#define QUEUE_FLAG_SYNCFULL 3 /* read queue has been filled */
490#define QUEUE_FLAG_ASYNCFULL 4 /* write queue has been filled */
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100491#define QUEUE_FLAG_DYING 5 /* queue being torn down */
Tejun Heod7325802012-03-05 13:14:58 -0800492#define QUEUE_FLAG_BYPASS 6 /* act as dumb FIFO queue */
Jens Axboec21e6be2011-04-19 13:32:46 +0200493#define QUEUE_FLAG_BIDI 7 /* queue supports bidi requests */
494#define QUEUE_FLAG_NOMERGES 8 /* disable merge attempts */
Dan Williams5757a6d2011-07-23 20:44:25 +0200495#define QUEUE_FLAG_SAME_COMP 9 /* complete on same CPU-group */
Jens Axboec21e6be2011-04-19 13:32:46 +0200496#define QUEUE_FLAG_FAIL_IO 10 /* fake timeout */
497#define QUEUE_FLAG_STACKABLE 11 /* supports request stacking */
498#define QUEUE_FLAG_NONROT 12 /* non-rotational device (SSD) */
Fernando Luis Vázquez Cao88e740f2008-10-27 18:44:46 +0900499#define QUEUE_FLAG_VIRT QUEUE_FLAG_NONROT /* paravirt device */
Jens Axboec21e6be2011-04-19 13:32:46 +0200500#define QUEUE_FLAG_IO_STAT 13 /* do IO stats */
501#define QUEUE_FLAG_DISCARD 14 /* supports DISCARD */
502#define QUEUE_FLAG_NOXMERGES 15 /* No extended merges */
503#define QUEUE_FLAG_ADD_RANDOM 16 /* Contributes to random pool */
Christoph Hellwig288dab82016-06-09 16:00:36 +0200504#define QUEUE_FLAG_SECERASE 17 /* supports secure erase */
Dan Williams5757a6d2011-07-23 20:44:25 +0200505#define QUEUE_FLAG_SAME_FORCE 18 /* force complete on same CPU */
Bart Van Asschec246e802012-12-06 14:32:01 +0100506#define QUEUE_FLAG_DEAD 19 /* queue tear-down finished */
Jens Axboe320ae512013-10-24 09:20:05 +0100507#define QUEUE_FLAG_INIT_DONE 20 /* queue is initialized */
Jens Axboe05f1dd52014-05-29 09:53:32 -0600508#define QUEUE_FLAG_NO_SG_MERGE 21 /* don't attempt to merge SG segments*/
Jens Axboe05229be2015-11-05 10:44:55 -0700509#define QUEUE_FLAG_POLL 22 /* IO polling enabled if set */
Jens Axboe93e9d8e2016-04-12 12:32:46 -0600510#define QUEUE_FLAG_WC 23 /* Write back caching */
511#define QUEUE_FLAG_FUA 24 /* device supports FUA writes */
Jens Axboec888a8f2016-04-13 13:33:19 -0600512#define QUEUE_FLAG_FLUSH_NQ 25 /* flush not queueuable */
Toshi Kani163d4ba2016-06-23 17:05:50 -0400513#define QUEUE_FLAG_DAX 26 /* device supports DAX */
Jens Axboebc58ba92009-01-23 10:54:44 +0100514
515#define QUEUE_FLAG_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
Jens Axboe01e97f62009-09-03 20:06:47 +0200516 (1 << QUEUE_FLAG_STACKABLE) | \
Jens Axboee2e1a142010-06-09 10:42:09 +0200517 (1 << QUEUE_FLAG_SAME_COMP) | \
518 (1 << QUEUE_FLAG_ADD_RANDOM))
Tejun Heo797e7db2006-01-06 09:51:03 +0100519
Jens Axboe94eddfb2013-11-19 09:25:07 -0700520#define QUEUE_FLAG_MQ_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
Mike Snitzerad9cf3b2014-12-16 12:54:25 -0500521 (1 << QUEUE_FLAG_STACKABLE) | \
Christoph Hellwig8e0b60b2016-03-03 16:04:03 +0100522 (1 << QUEUE_FLAG_SAME_COMP) | \
523 (1 << QUEUE_FLAG_POLL))
Jens Axboe94eddfb2013-11-19 09:25:07 -0700524
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200525static inline void queue_lockdep_assert_held(struct request_queue *q)
Linus Torvalds8f45c1a2008-04-29 10:16:38 -0700526{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200527 if (q->queue_lock)
528 lockdep_assert_held(q->queue_lock);
Linus Torvalds8f45c1a2008-04-29 10:16:38 -0700529}
530
Nick Piggin75ad23b2008-04-29 14:48:33 +0200531static inline void queue_flag_set_unlocked(unsigned int flag,
532 struct request_queue *q)
533{
534 __set_bit(flag, &q->queue_flags);
535}
536
Jens Axboee48ec692008-07-03 13:18:54 +0200537static inline int queue_flag_test_and_clear(unsigned int flag,
538 struct request_queue *q)
539{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200540 queue_lockdep_assert_held(q);
Jens Axboee48ec692008-07-03 13:18:54 +0200541
542 if (test_bit(flag, &q->queue_flags)) {
543 __clear_bit(flag, &q->queue_flags);
544 return 1;
545 }
546
547 return 0;
548}
549
550static inline int queue_flag_test_and_set(unsigned int flag,
551 struct request_queue *q)
552{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200553 queue_lockdep_assert_held(q);
Jens Axboee48ec692008-07-03 13:18:54 +0200554
555 if (!test_bit(flag, &q->queue_flags)) {
556 __set_bit(flag, &q->queue_flags);
557 return 0;
558 }
559
560 return 1;
561}
562
Nick Piggin75ad23b2008-04-29 14:48:33 +0200563static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
564{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200565 queue_lockdep_assert_held(q);
Nick Piggin75ad23b2008-04-29 14:48:33 +0200566 __set_bit(flag, &q->queue_flags);
567}
568
569static inline void queue_flag_clear_unlocked(unsigned int flag,
570 struct request_queue *q)
571{
572 __clear_bit(flag, &q->queue_flags);
573}
574
Jens Axboe0a7ae2f2009-05-20 08:54:31 +0200575static inline int queue_in_flight(struct request_queue *q)
576{
577 return q->in_flight[0] + q->in_flight[1];
578}
579
Nick Piggin75ad23b2008-04-29 14:48:33 +0200580static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
581{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200582 queue_lockdep_assert_held(q);
Nick Piggin75ad23b2008-04-29 14:48:33 +0200583 __clear_bit(flag, &q->queue_flags);
584}
585
Linus Torvalds1da177e2005-04-16 15:20:36 -0700586#define blk_queue_tagged(q) test_bit(QUEUE_FLAG_QUEUED, &(q)->queue_flags)
587#define blk_queue_stopped(q) test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100588#define blk_queue_dying(q) test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
Bart Van Asschec246e802012-12-06 14:32:01 +0100589#define blk_queue_dead(q) test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
Tejun Heod7325802012-03-05 13:14:58 -0800590#define blk_queue_bypass(q) test_bit(QUEUE_FLAG_BYPASS, &(q)->queue_flags)
Jens Axboe320ae512013-10-24 09:20:05 +0100591#define blk_queue_init_done(q) test_bit(QUEUE_FLAG_INIT_DONE, &(q)->queue_flags)
Alan D. Brunelleac9fafa2008-04-29 14:44:19 +0200592#define blk_queue_nomerges(q) test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
Alan D. Brunelle488991e2010-01-29 09:04:08 +0100593#define blk_queue_noxmerges(q) \
594 test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
Jens Axboea68bbdd2008-09-24 13:03:33 +0200595#define blk_queue_nonrot(q) test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
Jens Axboebc58ba92009-01-23 10:54:44 +0100596#define blk_queue_io_stat(q) test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
Jens Axboee2e1a142010-06-09 10:42:09 +0200597#define blk_queue_add_random(q) test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
Kiyoshi Ueda4ee5eaf2008-09-18 10:46:13 -0400598#define blk_queue_stackable(q) \
599 test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
Christoph Hellwigc15227d2009-09-30 13:52:12 +0200600#define blk_queue_discard(q) test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
Christoph Hellwig288dab82016-06-09 16:00:36 +0200601#define blk_queue_secure_erase(q) \
602 (test_bit(QUEUE_FLAG_SECERASE, &(q)->queue_flags))
Toshi Kani163d4ba2016-06-23 17:05:50 -0400603#define blk_queue_dax(q) test_bit(QUEUE_FLAG_DAX, &(q)->queue_flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700604
Christoph Hellwig33659eb2010-08-07 18:17:56 +0200605#define blk_noretry_request(rq) \
606 ((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
607 REQ_FAILFAST_DRIVER))
Jens Axboe4aff5e22006-08-10 08:44:47 +0200608
Christoph Hellwig33659eb2010-08-07 18:17:56 +0200609#define blk_account_rq(rq) \
610 (((rq)->cmd_flags & REQ_STARTED) && \
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400611 ((rq)->cmd_type == REQ_TYPE_FS))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700612
Jens Axboeab780f12008-08-26 10:25:02 +0200613#define blk_rq_cpu_valid(rq) ((rq)->cpu != -1)
FUJITA Tomonoriabae1fd2007-07-16 08:52:14 +0200614#define blk_bidi_rq(rq) ((rq)->next_rq != NULL)
Kiyoshi Ueda336cdb42007-12-11 17:40:30 -0500615/* rq->queuelist of dequeued request must be list_empty() */
616#define blk_queued_rq(rq) (!list_empty(&(rq)->queuelist))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700617
618#define list_entry_rq(ptr) list_entry((ptr), struct request, queuelist)
619
Mike Christie4e1b2d522016-06-05 14:32:22 -0500620#define rq_data_dir(rq) (op_is_write(req_op(rq)) ? WRITE : READ)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700621
Jens Axboe49fd5242014-04-16 10:57:18 -0600622/*
623 * Driver can handle struct request, if it either has an old style
624 * request_fn defined, or is blk-mq based.
625 */
626static inline bool queue_is_rq_based(struct request_queue *q)
627{
628 return q->request_fn || q->mq_ops;
629}
630
Martin K. Petersene692cb62010-12-01 19:41:49 +0100631static inline unsigned int blk_queue_cluster(struct request_queue *q)
632{
633 return q->limits.cluster;
634}
635
Jens Axboe9e2585a2006-07-28 09:26:13 +0200636/*
Jens Axboe1faa16d2009-04-06 14:48:01 +0200637 * We regard a request as sync, if either a read or a sync write
Jens Axboe9e2585a2006-07-28 09:26:13 +0200638 */
Mike Christied9d8c5c2016-06-05 14:32:16 -0500639static inline bool rw_is_sync(int op, unsigned int rw_flags)
Jens Axboe1faa16d2009-04-06 14:48:01 +0200640{
Mike Christied9d8c5c2016-06-05 14:32:16 -0500641 return op == REQ_OP_READ || (rw_flags & REQ_SYNC);
Jens Axboe1faa16d2009-04-06 14:48:01 +0200642}
643
644static inline bool rq_is_sync(struct request *rq)
645{
Mike Christied9d8c5c2016-06-05 14:32:16 -0500646 return rw_is_sync(req_op(rq), rq->cmd_flags);
Jens Axboe1faa16d2009-04-06 14:48:01 +0200647}
648
Tejun Heo5b788ce2012-06-04 20:40:59 -0700649static inline bool blk_rl_full(struct request_list *rl, bool sync)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700650{
Tejun Heo5b788ce2012-06-04 20:40:59 -0700651 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
652
653 return rl->flags & flag;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700654}
655
Tejun Heo5b788ce2012-06-04 20:40:59 -0700656static inline void blk_set_rl_full(struct request_list *rl, bool sync)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700657{
Tejun Heo5b788ce2012-06-04 20:40:59 -0700658 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
659
660 rl->flags |= flag;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700661}
662
Tejun Heo5b788ce2012-06-04 20:40:59 -0700663static inline void blk_clear_rl_full(struct request_list *rl, bool sync)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700664{
Tejun Heo5b788ce2012-06-04 20:40:59 -0700665 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
666
667 rl->flags &= ~flag;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700668}
669
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400670static inline bool rq_mergeable(struct request *rq)
671{
Christoph Hellwigf3216242017-01-31 16:57:29 +0100672 if (blk_rq_is_passthrough(rq))
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400673 return false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700674
Mike Christie3a5e02c2016-06-05 14:32:23 -0500675 if (req_op(rq) == REQ_OP_FLUSH)
676 return false;
677
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400678 if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
679 return false;
680
681 return true;
682}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700683
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400684static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
685{
686 if (bio_data(a) == bio_data(b))
687 return true;
688
689 return false;
690}
691
Linus Torvalds1da177e2005-04-16 15:20:36 -0700692/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700693 * q->prep_rq_fn return values
694 */
Martin K. Petersen0fb5b1f2016-02-04 00:52:12 -0500695enum {
696 BLKPREP_OK, /* serve it */
697 BLKPREP_KILL, /* fatal error, kill, return -EIO */
698 BLKPREP_DEFER, /* leave on queue */
699 BLKPREP_INVALID, /* invalid command, kill, return -EREMOTEIO */
700};
Linus Torvalds1da177e2005-04-16 15:20:36 -0700701
702extern unsigned long blk_max_low_pfn, blk_max_pfn;
703
704/*
705 * standard bounce addresses:
706 *
707 * BLK_BOUNCE_HIGH : bounce all highmem pages
708 * BLK_BOUNCE_ANY : don't bounce anything
709 * BLK_BOUNCE_ISA : bounce pages above ISA DMA boundary
710 */
Andi Kleen24728922008-04-21 09:51:05 +0200711
712#if BITS_PER_LONG == 32
Linus Torvalds1da177e2005-04-16 15:20:36 -0700713#define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
Andi Kleen24728922008-04-21 09:51:05 +0200714#else
715#define BLK_BOUNCE_HIGH -1ULL
716#endif
717#define BLK_BOUNCE_ANY (-1ULL)
FUJITA Tomonoribfe17232010-05-31 15:59:03 +0900718#define BLK_BOUNCE_ISA (DMA_BIT_MASK(24))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700719
Jens Axboe3d6392c2007-07-09 12:38:05 +0200720/*
721 * default timeout for SG_IO if none specified
722 */
723#define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
Linus Torvaldsf2f1fa72008-12-05 14:49:18 -0800724#define BLK_MIN_SG_TIMEOUT (7 * HZ)
Jens Axboe3d6392c2007-07-09 12:38:05 +0200725
Christoph Lameter2a7326b2007-07-17 04:03:37 -0700726#ifdef CONFIG_BOUNCE
Linus Torvalds1da177e2005-04-16 15:20:36 -0700727extern int init_emergency_isa_pool(void);
Jens Axboe165125e2007-07-24 09:28:11 +0200728extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700729#else
730static inline int init_emergency_isa_pool(void)
731{
732 return 0;
733}
Jens Axboe165125e2007-07-24 09:28:11 +0200734static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700735{
736}
737#endif /* CONFIG_MMU */
738
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900739struct rq_map_data {
740 struct page **pages;
741 int page_order;
742 int nr_entries;
FUJITA Tomonori56c451f2008-12-18 14:49:37 +0900743 unsigned long offset;
FUJITA Tomonori97ae77a2008-12-18 14:49:38 +0900744 int null_mapped;
FUJITA Tomonoriecb554a2009-07-09 14:46:53 +0200745 int from_user;
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900746};
747
NeilBrown5705f702007-09-25 12:35:59 +0200748struct req_iterator {
Kent Overstreet79886132013-11-23 17:19:00 -0800749 struct bvec_iter iter;
NeilBrown5705f702007-09-25 12:35:59 +0200750 struct bio *bio;
751};
752
753/* This should not be used directly - use rq_for_each_segment */
Jens Axboe1e428072009-02-23 09:03:10 +0100754#define for_each_bio(_bio) \
755 for (; _bio; _bio = _bio->bi_next)
NeilBrown5705f702007-09-25 12:35:59 +0200756#define __rq_for_each_bio(_bio, rq) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700757 if ((rq->bio)) \
758 for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
759
NeilBrown5705f702007-09-25 12:35:59 +0200760#define rq_for_each_segment(bvl, _rq, _iter) \
761 __rq_for_each_bio(_iter.bio, _rq) \
Kent Overstreet79886132013-11-23 17:19:00 -0800762 bio_for_each_segment(bvl, _iter.bio, _iter.iter)
NeilBrown5705f702007-09-25 12:35:59 +0200763
Kent Overstreet4550dd62013-08-07 14:26:21 -0700764#define rq_iter_last(bvec, _iter) \
Kent Overstreet79886132013-11-23 17:19:00 -0800765 (_iter.bio->bi_next == NULL && \
Kent Overstreet4550dd62013-08-07 14:26:21 -0700766 bio_iter_last(bvec, _iter.iter))
NeilBrown5705f702007-09-25 12:35:59 +0200767
Ilya Loginov2d4dc892009-11-26 09:16:19 +0100768#ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
769# error "You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
770#endif
771#if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
772extern void rq_flush_dcache_pages(struct request *rq);
773#else
774static inline void rq_flush_dcache_pages(struct request *rq)
775{
776}
777#endif
778
Toshi Kani2af3a812016-05-10 10:23:52 -0600779#ifdef CONFIG_PRINTK
780#define vfs_msg(sb, level, fmt, ...) \
781 __vfs_msg(sb, level, fmt, ##__VA_ARGS__)
782#else
783#define vfs_msg(sb, level, fmt, ...) \
784do { \
785 no_printk(fmt, ##__VA_ARGS__); \
786 __vfs_msg(sb, "", " "); \
787} while (0)
788#endif
789
Linus Torvalds1da177e2005-04-16 15:20:36 -0700790extern int blk_register_queue(struct gendisk *disk);
791extern void blk_unregister_queue(struct gendisk *disk);
Jens Axboedece1632015-11-05 10:41:16 -0700792extern blk_qc_t generic_make_request(struct bio *bio);
FUJITA Tomonori2a4aa302008-04-29 09:54:36 +0200793extern void blk_rq_init(struct request_queue *q, struct request *rq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700794extern void blk_put_request(struct request *);
Jens Axboe165125e2007-07-24 09:28:11 +0200795extern void __blk_put_request(struct request_queue *, struct request *);
Jens Axboe165125e2007-07-24 09:28:11 +0200796extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
Jens Axboef27b0872014-06-06 07:57:37 -0600797extern void blk_rq_set_block_pc(struct request *);
Jens Axboe165125e2007-07-24 09:28:11 +0200798extern void blk_requeue_request(struct request_queue *, struct request *);
Christoph Hellwig66ac0282010-06-18 16:59:42 +0200799extern void blk_add_request_payload(struct request *rq, struct page *page,
Ming Lin37e58232016-03-22 00:24:44 -0700800 int offset, unsigned int len);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200801extern int blk_lld_busy(struct request_queue *q);
Mike Snitzer78d8e582015-06-26 10:01:13 -0400802extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
803 struct bio_set *bs, gfp_t gfp_mask,
804 int (*bio_ctr)(struct bio *, struct bio *, void *),
805 void *data);
806extern void blk_rq_unprep_clone(struct request *rq);
Kiyoshi Ueda82124d62008-09-18 10:45:38 -0400807extern int blk_insert_cloned_request(struct request_queue *q,
808 struct request *rq);
Christoph Hellwig98d61d52016-07-19 11:31:51 +0200809extern int blk_rq_append_bio(struct request *rq, struct bio *bio);
Jens Axboe3cca6dc2011-03-02 11:08:00 -0500810extern void blk_delay_queue(struct request_queue *, unsigned long);
Kent Overstreet54efd502015-04-23 22:37:18 -0700811extern void blk_queue_split(struct request_queue *, struct bio **,
812 struct bio_set *);
Jens Axboe165125e2007-07-24 09:28:11 +0200813extern void blk_recount_segments(struct request_queue *, struct bio *);
Paolo Bonzini0bfc96c2012-01-12 16:01:28 +0100814extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
Paolo Bonzini577ebb32012-01-12 16:01:27 +0100815extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
816 unsigned int, void __user *);
Al Viro74f3c8a2007-08-27 15:38:10 -0400817extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
818 unsigned int, void __user *);
Al Viroe915e872008-09-02 17:16:41 -0400819extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
820 struct scsi_ioctl_command __user *);
Andrew Morton3fcfab12006-10-19 23:28:16 -0700821
Christoph Hellwig6f3b0e82015-11-26 09:13:05 +0100822extern int blk_queue_enter(struct request_queue *q, bool nowait);
Dan Williams2e6edc92015-11-19 13:29:28 -0800823extern void blk_queue_exit(struct request_queue *q);
Jens Axboe165125e2007-07-24 09:28:11 +0200824extern void blk_start_queue(struct request_queue *q);
Jens Axboe21491412015-12-28 13:01:22 -0700825extern void blk_start_queue_async(struct request_queue *q);
Jens Axboe165125e2007-07-24 09:28:11 +0200826extern void blk_stop_queue(struct request_queue *q);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700827extern void blk_sync_queue(struct request_queue *q);
Jens Axboe165125e2007-07-24 09:28:11 +0200828extern void __blk_stop_queue(struct request_queue *q);
Christoph Hellwig24ecfbe2011-04-18 11:41:33 +0200829extern void __blk_run_queue(struct request_queue *q);
Christoph Hellwiga7928c12015-04-17 22:37:20 +0200830extern void __blk_run_queue_uncond(struct request_queue *q);
Jens Axboe165125e2007-07-24 09:28:11 +0200831extern void blk_run_queue(struct request_queue *);
Jens Axboec21e6be2011-04-19 13:32:46 +0200832extern void blk_run_queue_async(struct request_queue *q);
FUJITA Tomonoria3bce902008-08-28 16:17:05 +0900833extern int blk_rq_map_user(struct request_queue *, struct request *,
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900834 struct rq_map_data *, void __user *, unsigned long,
835 gfp_t);
Jens Axboe8e5cfc42006-12-19 11:12:46 +0100836extern int blk_rq_unmap_user(struct bio *);
Jens Axboe165125e2007-07-24 09:28:11 +0200837extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
838extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
Kent Overstreet26e49cf2015-01-18 16:16:31 +0100839 struct rq_map_data *, const struct iov_iter *,
840 gfp_t);
Jens Axboe165125e2007-07-24 09:28:11 +0200841extern int blk_execute_rq(struct request_queue *, struct gendisk *,
James Bottomley 994ca9a2005-06-20 14:11:09 +0200842 struct request *, int);
Jens Axboe165125e2007-07-24 09:28:11 +0200843extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
Jens Axboe15fc8582006-01-06 10:00:50 +0100844 struct request *, int, rq_end_io_fn *);
Mike Christie6e39b69e2005-11-11 05:30:24 -0600845
Jens Axboe05229be2015-11-05 10:44:55 -0700846bool blk_poll(struct request_queue *q, blk_qc_t cookie);
847
Jens Axboe165125e2007-07-24 09:28:11 +0200848static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700849{
Tejun Heoff9ea322014-09-08 08:03:56 +0900850 return bdev->bd_disk->queue; /* this is never NULL */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700851}
852
Linus Torvalds1da177e2005-04-16 15:20:36 -0700853/*
Bart Van Assched24c4072018-03-14 15:48:06 -0700854 * The basic unit of block I/O is a sector. It is used in a number of contexts
855 * in Linux (blk, bio, genhd). The size of one sector is 512 = 2**9
856 * bytes. Variables of type sector_t represent an offset or size that is a
857 * multiple of 512 bytes. Hence these two constants.
858 */
859#ifndef SECTOR_SHIFT
860#define SECTOR_SHIFT 9
861#endif
862#ifndef SECTOR_SIZE
863#define SECTOR_SIZE (1 << SECTOR_SHIFT)
864#endif
865
866/*
Tejun Heo80a761f2009-07-03 17:48:17 +0900867 * blk_rq_pos() : the current sector
868 * blk_rq_bytes() : bytes left in the entire request
869 * blk_rq_cur_bytes() : bytes left in the current segment
870 * blk_rq_err_bytes() : bytes left till the next error boundary
871 * blk_rq_sectors() : sectors left in the entire request
872 * blk_rq_cur_sectors() : sectors left in the current segment
Tejun Heo5efccd12009-04-23 11:05:18 +0900873 */
Tejun Heo5b936292009-05-07 22:24:38 +0900874static inline sector_t blk_rq_pos(const struct request *rq)
875{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900876 return rq->__sector;
Tejun Heo5b936292009-05-07 22:24:38 +0900877}
878
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900879static inline unsigned int blk_rq_bytes(const struct request *rq)
880{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900881 return rq->__data_len;
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900882}
883
884static inline int blk_rq_cur_bytes(const struct request *rq)
885{
886 return rq->bio ? bio_cur_bytes(rq->bio) : 0;
887}
Tejun Heo5efccd12009-04-23 11:05:18 +0900888
Tejun Heo80a761f2009-07-03 17:48:17 +0900889extern unsigned int blk_rq_err_bytes(const struct request *rq);
890
Tejun Heo5b936292009-05-07 22:24:38 +0900891static inline unsigned int blk_rq_sectors(const struct request *rq)
892{
Bart Van Assched24c4072018-03-14 15:48:06 -0700893 return blk_rq_bytes(rq) >> SECTOR_SHIFT;
Tejun Heo5b936292009-05-07 22:24:38 +0900894}
895
896static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
897{
Bart Van Assched24c4072018-03-14 15:48:06 -0700898 return blk_rq_cur_bytes(rq) >> SECTOR_SHIFT;
Tejun Heo5b936292009-05-07 22:24:38 +0900899}
900
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400901static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
Mike Christie8fe0d472016-06-05 14:32:15 -0500902 int op)
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400903{
Adrian Hunter7afafc82016-08-16 10:59:35 +0300904 if (unlikely(op == REQ_OP_DISCARD || op == REQ_OP_SECURE_ERASE))
Bart Van Assched24c4072018-03-14 15:48:06 -0700905 return min(q->limits.max_discard_sectors,
906 UINT_MAX >> SECTOR_SHIFT);
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400907
Mike Christie8fe0d472016-06-05 14:32:15 -0500908 if (unlikely(op == REQ_OP_WRITE_SAME))
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400909 return q->limits.max_write_same_sectors;
910
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400911 return q->limits.max_sectors;
912}
913
Jens Axboe762380a2014-06-05 13:38:39 -0600914/*
915 * Return maximum size of a request at given offset. Only valid for
916 * file system requests.
917 */
918static inline unsigned int blk_max_size_offset(struct request_queue *q,
919 sector_t offset)
920{
921 if (!q->limits.chunk_sectors)
Jens Axboe736ed4d2014-06-17 22:09:29 -0700922 return q->limits.max_sectors;
Jens Axboe762380a2014-06-05 13:38:39 -0600923
Keith Busch17057c52018-06-26 09:14:58 -0600924 return min(q->limits.max_sectors, (unsigned int)(q->limits.chunk_sectors -
925 (offset & (q->limits.chunk_sectors - 1))));
Jens Axboe762380a2014-06-05 13:38:39 -0600926}
927
Damien Le Moal17007f32016-07-20 21:40:47 -0600928static inline unsigned int blk_rq_get_max_sectors(struct request *rq,
929 sector_t offset)
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400930{
931 struct request_queue *q = rq->q;
932
Christoph Hellwigf3216242017-01-31 16:57:29 +0100933 if (blk_rq_is_passthrough(rq))
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400934 return q->limits.max_hw_sectors;
935
Adrian Hunter7afafc82016-08-16 10:59:35 +0300936 if (!q->limits.chunk_sectors ||
937 req_op(rq) == REQ_OP_DISCARD ||
938 req_op(rq) == REQ_OP_SECURE_ERASE)
Mike Christie8fe0d472016-06-05 14:32:15 -0500939 return blk_queue_get_max_sectors(q, req_op(rq));
Jens Axboe762380a2014-06-05 13:38:39 -0600940
Damien Le Moal17007f32016-07-20 21:40:47 -0600941 return min(blk_max_size_offset(q, offset),
Mike Christie8fe0d472016-06-05 14:32:15 -0500942 blk_queue_get_max_sectors(q, req_op(rq)));
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400943}
944
Jun'ichi Nomura75afb352013-09-21 13:57:47 -0600945static inline unsigned int blk_rq_count_bios(struct request *rq)
946{
947 unsigned int nr_bios = 0;
948 struct bio *bio;
949
950 __rq_for_each_bio(bio, rq)
951 nr_bios++;
952
953 return nr_bios;
954}
955
Tejun Heo5efccd12009-04-23 11:05:18 +0900956/*
Tejun Heo9934c8c2009-05-08 11:54:16 +0900957 * Request issue related functions.
958 */
959extern struct request *blk_peek_request(struct request_queue *q);
960extern void blk_start_request(struct request *rq);
961extern struct request *blk_fetch_request(struct request_queue *q);
962
963/*
Tejun Heo2e60e022009-04-23 11:05:18 +0900964 * Request completion related functions.
965 *
966 * blk_update_request() completes given number of bytes and updates
967 * the request without completing it.
968 *
Tejun Heof06d9a22009-04-23 11:05:19 +0900969 * blk_end_request() and friends. __blk_end_request() must be called
970 * with the request queue spinlock acquired.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700971 *
972 * Several drivers define their own end_request and call
Kiyoshi Ueda3bcddea2007-12-11 17:52:28 -0500973 * blk_end_request() for parts of the original function.
974 * This prevents code duplication in drivers.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700975 */
Tejun Heo2e60e022009-04-23 11:05:18 +0900976extern bool blk_update_request(struct request *rq, int error,
977 unsigned int nr_bytes);
Christoph Hellwig12120072014-04-16 09:44:59 +0200978extern void blk_finish_request(struct request *rq, int error);
FUJITA Tomonorib1f74492009-05-11 17:56:09 +0900979extern bool blk_end_request(struct request *rq, int error,
980 unsigned int nr_bytes);
981extern void blk_end_request_all(struct request *rq, int error);
982extern bool blk_end_request_cur(struct request *rq, int error);
Tejun Heo80a761f2009-07-03 17:48:17 +0900983extern bool blk_end_request_err(struct request *rq, int error);
FUJITA Tomonorib1f74492009-05-11 17:56:09 +0900984extern bool __blk_end_request(struct request *rq, int error,
985 unsigned int nr_bytes);
986extern void __blk_end_request_all(struct request *rq, int error);
987extern bool __blk_end_request_cur(struct request *rq, int error);
Tejun Heo80a761f2009-07-03 17:48:17 +0900988extern bool __blk_end_request_err(struct request *rq, int error);
Tejun Heo2e60e022009-04-23 11:05:18 +0900989
Jens Axboeff856ba2006-01-09 16:02:34 +0100990extern void blk_complete_request(struct request *);
Jens Axboe242f9dc2008-09-14 05:55:09 -0700991extern void __blk_complete_request(struct request *);
992extern void blk_abort_request(struct request *);
James Bottomley28018c22010-07-01 19:49:17 +0900993extern void blk_unprep_request(struct request *);
Jens Axboeff856ba2006-01-09 16:02:34 +0100994
Linus Torvalds1da177e2005-04-16 15:20:36 -0700995/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700996 * Access functions for manipulating queue properties
997 */
Jens Axboe165125e2007-07-24 09:28:11 +0200998extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
Christoph Lameter19460892005-06-23 00:08:19 -0700999 spinlock_t *lock, int node_id);
Jens Axboe165125e2007-07-24 09:28:11 +02001000extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
Mike Snitzer01effb02010-05-11 08:57:42 +02001001extern struct request_queue *blk_init_allocated_queue(struct request_queue *,
1002 request_fn_proc *, spinlock_t *);
Jens Axboe165125e2007-07-24 09:28:11 +02001003extern void blk_cleanup_queue(struct request_queue *);
1004extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
1005extern void blk_queue_bounce_limit(struct request_queue *, u64);
Martin K. Petersen086fa5f2010-02-26 00:20:38 -05001006extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
Jens Axboe762380a2014-06-05 13:38:39 -06001007extern void blk_queue_chunk_sectors(struct request_queue *, unsigned int);
Martin K. Petersen8a783622010-02-26 00:20:39 -05001008extern void blk_queue_max_segments(struct request_queue *, unsigned short);
Jens Axboe165125e2007-07-24 09:28:11 +02001009extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
Christoph Hellwig67efc922009-09-30 13:54:20 +02001010extern void blk_queue_max_discard_sectors(struct request_queue *q,
1011 unsigned int max_discard_sectors);
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001012extern void blk_queue_max_write_same_sectors(struct request_queue *q,
1013 unsigned int max_write_same_sectors);
Mikulas Patocka5dbde462020-01-15 08:35:25 -05001014extern void blk_queue_logical_block_size(struct request_queue *, unsigned int);
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001015extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001016extern void blk_queue_alignment_offset(struct request_queue *q,
1017 unsigned int alignment);
Martin K. Petersen7c958e32009-07-31 11:49:11 -04001018extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001019extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
Martin K. Petersen3c5820c2009-09-11 21:54:52 +02001020extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001021extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
Martin K. Petersene475bba2009-06-16 08:23:52 +02001022extern void blk_set_default_limits(struct queue_limits *lim);
Martin K. Petersenb1bd0552012-01-11 16:27:11 +01001023extern void blk_set_stacking_limits(struct queue_limits *lim);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001024extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
1025 sector_t offset);
Martin K. Petersen17be8c22010-01-11 03:21:49 -05001026extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
1027 sector_t offset);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001028extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
1029 sector_t offset);
Jens Axboe165125e2007-07-24 09:28:11 +02001030extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
Tejun Heoe3790c72008-03-04 11:18:17 +01001031extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
FUJITA Tomonori27f82212008-07-04 09:30:03 +02001032extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
Tejun Heo2fb98e82008-02-19 11:36:53 +01001033extern int blk_queue_dma_drain(struct request_queue *q,
1034 dma_drain_needed_fn *dma_drain_needed,
1035 void *buf, unsigned int size);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +02001036extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
Jens Axboe165125e2007-07-24 09:28:11 +02001037extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
Keith Busch03100aa2015-08-19 14:24:05 -07001038extern void blk_queue_virt_boundary(struct request_queue *, unsigned long);
Jens Axboe165125e2007-07-24 09:28:11 +02001039extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
James Bottomley28018c22010-07-01 19:49:17 +09001040extern void blk_queue_unprep_rq(struct request_queue *, unprep_rq_fn *ufn);
Jens Axboe165125e2007-07-24 09:28:11 +02001041extern void blk_queue_dma_alignment(struct request_queue *, int);
James Bottomley11c3e682007-12-31 16:37:00 -06001042extern void blk_queue_update_dma_alignment(struct request_queue *, int);
Jens Axboe165125e2007-07-24 09:28:11 +02001043extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
Jens Axboe242f9dc2008-09-14 05:55:09 -07001044extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
1045extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001046extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
Jens Axboe93e9d8e2016-04-12 12:32:46 -06001047extern void blk_queue_write_cache(struct request_queue *q, bool enabled, bool fua);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001048extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001049
Jens Axboe165125e2007-07-24 09:28:11 +02001050extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001051extern void blk_dump_rq_flags(struct request *, char *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001052extern long nr_blockdev_pages(void);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001053
Tejun Heo09ac46c2011-12-14 00:33:38 +01001054bool __must_check blk_get_queue(struct request_queue *);
Jens Axboe165125e2007-07-24 09:28:11 +02001055struct request_queue *blk_alloc_queue(gfp_t);
1056struct request_queue *blk_alloc_queue_node(gfp_t, int);
1057extern void blk_put_queue(struct request_queue *);
Jens Axboe3f21c262015-06-05 10:57:37 -06001058extern void blk_set_queue_dying(struct request_queue *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001059
Shaohua Li316cc672011-07-08 08:19:21 +02001060/*
Lin Ming6c954662013-03-23 11:42:26 +08001061 * block layer runtime pm functions
1062 */
Rafael J. Wysocki47fafbc2014-12-04 01:00:23 +01001063#ifdef CONFIG_PM
Lin Ming6c954662013-03-23 11:42:26 +08001064extern void blk_pm_runtime_init(struct request_queue *q, struct device *dev);
1065extern int blk_pre_runtime_suspend(struct request_queue *q);
1066extern void blk_post_runtime_suspend(struct request_queue *q, int err);
1067extern void blk_pre_runtime_resume(struct request_queue *q);
1068extern void blk_post_runtime_resume(struct request_queue *q, int err);
Mika Westerbergd07ab6d2016-02-18 10:54:11 +02001069extern void blk_set_runtime_active(struct request_queue *q);
Lin Ming6c954662013-03-23 11:42:26 +08001070#else
1071static inline void blk_pm_runtime_init(struct request_queue *q,
1072 struct device *dev) {}
1073static inline int blk_pre_runtime_suspend(struct request_queue *q)
1074{
1075 return -ENOSYS;
1076}
1077static inline void blk_post_runtime_suspend(struct request_queue *q, int err) {}
1078static inline void blk_pre_runtime_resume(struct request_queue *q) {}
1079static inline void blk_post_runtime_resume(struct request_queue *q, int err) {}
Tobias Klauserf99694c2016-11-18 15:16:06 +01001080static inline void blk_set_runtime_active(struct request_queue *q) {}
Lin Ming6c954662013-03-23 11:42:26 +08001081#endif
1082
1083/*
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001084 * blk_plug permits building a queue of related requests by holding the I/O
1085 * fragments for a short period. This allows merging of sequential requests
1086 * into single larger request. As the requests are moved from a per-task list to
1087 * the device's request_queue in a batch, this results in improved scalability
1088 * as the lock contention for request_queue lock is reduced.
1089 *
1090 * It is ok not to disable preemption when adding the request to the plug list
1091 * or when attempting a merge, because blk_schedule_flush_list() will only flush
1092 * the plug list when the task sleeps by itself. For details, please see
1093 * schedule() where blk_schedule_flush_plug() is called.
Shaohua Li316cc672011-07-08 08:19:21 +02001094 */
Jens Axboe73c10102011-03-08 13:19:51 +01001095struct blk_plug {
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001096 struct list_head list; /* requests */
Jens Axboe320ae512013-10-24 09:20:05 +01001097 struct list_head mq_list; /* blk-mq requests */
Suresh Jayaraman75df7132011-09-21 10:00:16 +02001098 struct list_head cb_list; /* md requires an unplug callback */
Jens Axboe73c10102011-03-08 13:19:51 +01001099};
Shaohua Li55c022b2011-07-08 08:19:20 +02001100#define BLK_MAX_REQUEST_COUNT 16
1101
NeilBrown9cbb1752012-07-31 09:08:14 +02001102struct blk_plug_cb;
NeilBrown74018dc2012-07-31 09:08:15 +02001103typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
NeilBrown048c9372011-04-18 09:52:22 +02001104struct blk_plug_cb {
1105 struct list_head list;
NeilBrown9cbb1752012-07-31 09:08:14 +02001106 blk_plug_cb_fn callback;
1107 void *data;
NeilBrown048c9372011-04-18 09:52:22 +02001108};
NeilBrown9cbb1752012-07-31 09:08:14 +02001109extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
1110 void *data, int size);
Jens Axboe73c10102011-03-08 13:19:51 +01001111extern void blk_start_plug(struct blk_plug *);
1112extern void blk_finish_plug(struct blk_plug *);
Jens Axboef6603782011-04-15 15:49:07 +02001113extern void blk_flush_plug_list(struct blk_plug *, bool);
Jens Axboe73c10102011-03-08 13:19:51 +01001114
1115static inline void blk_flush_plug(struct task_struct *tsk)
1116{
1117 struct blk_plug *plug = tsk->plug;
1118
Christoph Hellwig88b996c2011-04-15 15:20:10 +02001119 if (plug)
Jens Axboea237c1c2011-04-16 13:27:55 +02001120 blk_flush_plug_list(plug, false);
1121}
1122
1123static inline void blk_schedule_flush_plug(struct task_struct *tsk)
1124{
1125 struct blk_plug *plug = tsk->plug;
1126
1127 if (plug)
Jens Axboef6603782011-04-15 15:49:07 +02001128 blk_flush_plug_list(plug, true);
Jens Axboe73c10102011-03-08 13:19:51 +01001129}
1130
1131static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1132{
1133 struct blk_plug *plug = tsk->plug;
1134
Jens Axboe320ae512013-10-24 09:20:05 +01001135 return plug &&
1136 (!list_empty(&plug->list) ||
1137 !list_empty(&plug->mq_list) ||
1138 !list_empty(&plug->cb_list));
Jens Axboe73c10102011-03-08 13:19:51 +01001139}
1140
Linus Torvalds1da177e2005-04-16 15:20:36 -07001141/*
1142 * tag stuff
1143 */
Jens Axboe165125e2007-07-24 09:28:11 +02001144extern int blk_queue_start_tag(struct request_queue *, struct request *);
1145extern struct request *blk_queue_find_tag(struct request_queue *, int);
1146extern void blk_queue_end_tag(struct request_queue *, struct request *);
Shaohua Liee1b6f72015-01-15 17:32:25 -08001147extern int blk_queue_init_tags(struct request_queue *, int, struct blk_queue_tag *, int);
Jens Axboe165125e2007-07-24 09:28:11 +02001148extern void blk_queue_free_tags(struct request_queue *);
1149extern int blk_queue_resize_tags(struct request_queue *, int);
1150extern void blk_queue_invalidate_tags(struct request_queue *);
Shaohua Liee1b6f72015-01-15 17:32:25 -08001151extern struct blk_queue_tag *blk_init_tags(int, int);
James Bottomley492dfb42006-08-30 15:48:45 -04001152extern void blk_free_tags(struct blk_queue_tag *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001153
David C Somayajuluf583f492006-10-04 08:27:25 +02001154static inline struct request *blk_map_queue_find_tag(struct blk_queue_tag *bqt,
1155 int tag)
1156{
1157 if (unlikely(bqt == NULL || tag >= bqt->real_max_depth))
1158 return NULL;
1159 return bqt->tag_index[tag];
1160}
Christoph Hellwigdd3932e2010-09-16 20:51:46 +02001161
Christoph Hellwige950fdf2016-07-19 11:23:33 +02001162
1163#define BLKDEV_DISCARD_SECURE (1 << 0) /* issue a secure erase */
1164#define BLKDEV_DISCARD_ZERO (1 << 1) /* must reliably zero data */
Christoph Hellwigdd3932e2010-09-16 20:51:46 +02001165
1166extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
Dmitry Monakhovfbd9b092010-04-28 17:55:06 +04001167extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1168 sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
Christoph Hellwig38f25252016-04-16 14:55:28 -04001169extern int __blkdev_issue_discard(struct block_device *bdev, sector_t sector,
Christoph Hellwig288dab82016-06-09 16:00:36 +02001170 sector_t nr_sects, gfp_t gfp_mask, int flags,
Mike Christie469e3212016-06-05 14:31:49 -05001171 struct bio **biop);
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001172extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
1173 sector_t nr_sects, gfp_t gfp_mask, struct page *page);
Dmitry Monakhov3f14d792010-04-28 17:55:09 +04001174extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
Martin K. Petersend93ba7a2015-01-20 20:06:30 -05001175 sector_t nr_sects, gfp_t gfp_mask, bool discard);
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001176static inline int sb_issue_discard(struct super_block *sb, sector_t block,
1177 sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
David Woodhousefb2dce82008-08-05 18:01:53 +01001178{
Bart Van Assched24c4072018-03-14 15:48:06 -07001179 return blkdev_issue_discard(sb->s_bdev,
1180 block << (sb->s_blocksize_bits -
1181 SECTOR_SHIFT),
1182 nr_blocks << (sb->s_blocksize_bits -
1183 SECTOR_SHIFT),
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001184 gfp_mask, flags);
David Woodhousefb2dce82008-08-05 18:01:53 +01001185}
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001186static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
Theodore Ts'oa107e5a2010-10-27 23:44:47 -04001187 sector_t nr_blocks, gfp_t gfp_mask)
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001188{
1189 return blkdev_issue_zeroout(sb->s_bdev,
Bart Van Assched24c4072018-03-14 15:48:06 -07001190 block << (sb->s_blocksize_bits -
1191 SECTOR_SHIFT),
1192 nr_blocks << (sb->s_blocksize_bits -
1193 SECTOR_SHIFT),
Martin K. Petersend93ba7a2015-01-20 20:06:30 -05001194 gfp_mask, true);
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001195}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001196
Jens Axboe018e0442009-06-26 16:27:10 +02001197extern int blk_verify_command(unsigned char *cmd, fmode_t has_write_perm);
Adel Gadllah0b07de82008-06-26 13:48:27 +02001198
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001199enum blk_default_limits {
1200 BLK_MAX_SEGMENTS = 128,
1201 BLK_SAFE_MAX_SECTORS = 255,
Jeff Moyerd2be5372015-08-13 14:57:57 -04001202 BLK_DEF_MAX_SECTORS = 2560,
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001203 BLK_MAX_SEGMENT_SIZE = 65536,
1204 BLK_SEG_BOUNDARY_MASK = 0xFFFFFFFFUL,
1205};
Milan Broz0e435ac2008-12-03 12:55:08 +01001206
Linus Torvalds1da177e2005-04-16 15:20:36 -07001207#define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
1208
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001209static inline unsigned long queue_bounce_pfn(struct request_queue *q)
1210{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001211 return q->limits.bounce_pfn;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001212}
1213
1214static inline unsigned long queue_segment_boundary(struct request_queue *q)
1215{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001216 return q->limits.seg_boundary_mask;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001217}
1218
Keith Busch03100aa2015-08-19 14:24:05 -07001219static inline unsigned long queue_virt_boundary(struct request_queue *q)
1220{
1221 return q->limits.virt_boundary_mask;
1222}
1223
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001224static inline unsigned int queue_max_sectors(struct request_queue *q)
1225{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001226 return q->limits.max_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001227}
1228
1229static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1230{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001231 return q->limits.max_hw_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001232}
1233
Martin K. Petersen8a783622010-02-26 00:20:39 -05001234static inline unsigned short queue_max_segments(struct request_queue *q)
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001235{
Martin K. Petersen8a783622010-02-26 00:20:39 -05001236 return q->limits.max_segments;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001237}
1238
1239static inline unsigned int queue_max_segment_size(struct request_queue *q)
1240{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001241 return q->limits.max_segment_size;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001242}
1243
Mikulas Patocka5dbde462020-01-15 08:35:25 -05001244static inline unsigned queue_logical_block_size(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001245{
1246 int retval = 512;
1247
Martin K. Petersen025146e2009-05-22 17:17:51 -04001248 if (q && q->limits.logical_block_size)
1249 retval = q->limits.logical_block_size;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001250
1251 return retval;
1252}
1253
Mikulas Patocka5dbde462020-01-15 08:35:25 -05001254static inline unsigned int bdev_logical_block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001255{
Martin K. Petersene1defc42009-05-22 17:17:49 -04001256 return queue_logical_block_size(bdev_get_queue(bdev));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001257}
1258
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001259static inline unsigned int queue_physical_block_size(struct request_queue *q)
1260{
1261 return q->limits.physical_block_size;
1262}
1263
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001264static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
Martin K. Petersenac481c22009-10-03 20:52:01 +02001265{
1266 return queue_physical_block_size(bdev_get_queue(bdev));
1267}
1268
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001269static inline unsigned int queue_io_min(struct request_queue *q)
1270{
1271 return q->limits.io_min;
1272}
1273
Martin K. Petersenac481c22009-10-03 20:52:01 +02001274static inline int bdev_io_min(struct block_device *bdev)
1275{
1276 return queue_io_min(bdev_get_queue(bdev));
1277}
1278
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001279static inline unsigned int queue_io_opt(struct request_queue *q)
1280{
1281 return q->limits.io_opt;
1282}
1283
Martin K. Petersenac481c22009-10-03 20:52:01 +02001284static inline int bdev_io_opt(struct block_device *bdev)
1285{
1286 return queue_io_opt(bdev_get_queue(bdev));
1287}
1288
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001289static inline int queue_alignment_offset(struct request_queue *q)
1290{
Martin K. Petersenac481c22009-10-03 20:52:01 +02001291 if (q->limits.misaligned)
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001292 return -1;
1293
Martin K. Petersenac481c22009-10-03 20:52:01 +02001294 return q->limits.alignment_offset;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001295}
1296
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001297static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001298{
1299 unsigned int granularity = max(lim->physical_block_size, lim->io_min);
Bart Van Assched24c4072018-03-14 15:48:06 -07001300 unsigned int alignment = sector_div(sector, granularity >> SECTOR_SHIFT)
1301 << SECTOR_SHIFT;
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001302
Mike Snitzerb8839b82014-10-08 18:26:13 -04001303 return (granularity + lim->alignment_offset - alignment) % granularity;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001304}
1305
Martin K. Petersenac481c22009-10-03 20:52:01 +02001306static inline int bdev_alignment_offset(struct block_device *bdev)
1307{
1308 struct request_queue *q = bdev_get_queue(bdev);
1309
1310 if (q->limits.misaligned)
1311 return -1;
1312
1313 if (bdev != bdev->bd_contains)
1314 return bdev->bd_part->alignment_offset;
1315
1316 return q->limits.alignment_offset;
1317}
1318
Martin K. Petersen86b37282009-11-10 11:50:21 +01001319static inline int queue_discard_alignment(struct request_queue *q)
1320{
1321 if (q->limits.discard_misaligned)
1322 return -1;
1323
1324 return q->limits.discard_alignment;
1325}
1326
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001327static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
Martin K. Petersen86b37282009-11-10 11:50:21 +01001328{
Linus Torvalds59771072012-12-19 07:18:35 -08001329 unsigned int alignment, granularity, offset;
Martin K. Petersendd3d1452010-01-11 03:21:48 -05001330
Martin K. Petersena934a002011-05-18 10:37:35 +02001331 if (!lim->max_discard_sectors)
1332 return 0;
1333
Linus Torvalds59771072012-12-19 07:18:35 -08001334 /* Why are these in bytes, not sectors? */
Bart Van Assched24c4072018-03-14 15:48:06 -07001335 alignment = lim->discard_alignment >> SECTOR_SHIFT;
1336 granularity = lim->discard_granularity >> SECTOR_SHIFT;
Linus Torvalds59771072012-12-19 07:18:35 -08001337 if (!granularity)
1338 return 0;
1339
1340 /* Offset of the partition start in 'granularity' sectors */
1341 offset = sector_div(sector, granularity);
1342
1343 /* And why do we do this modulus *again* in blkdev_issue_discard()? */
1344 offset = (granularity + alignment - offset) % granularity;
1345
1346 /* Turn it back into bytes, gaah */
Bart Van Assched24c4072018-03-14 15:48:06 -07001347 return offset << SECTOR_SHIFT;
Martin K. Petersen86b37282009-11-10 11:50:21 +01001348}
1349
Paolo Bonzinic6e66632012-08-02 09:48:50 +02001350static inline int bdev_discard_alignment(struct block_device *bdev)
1351{
1352 struct request_queue *q = bdev_get_queue(bdev);
1353
1354 if (bdev != bdev->bd_contains)
1355 return bdev->bd_part->discard_alignment;
1356
1357 return q->limits.discard_alignment;
1358}
1359
Martin K. Petersen98262f22009-12-03 09:24:48 +01001360static inline unsigned int queue_discard_zeroes_data(struct request_queue *q)
1361{
Martin K. Petersena934a002011-05-18 10:37:35 +02001362 if (q->limits.max_discard_sectors && q->limits.discard_zeroes_data == 1)
Martin K. Petersen98262f22009-12-03 09:24:48 +01001363 return 1;
1364
1365 return 0;
1366}
1367
1368static inline unsigned int bdev_discard_zeroes_data(struct block_device *bdev)
1369{
1370 return queue_discard_zeroes_data(bdev_get_queue(bdev));
1371}
1372
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001373static inline unsigned int bdev_write_same(struct block_device *bdev)
1374{
1375 struct request_queue *q = bdev_get_queue(bdev);
1376
1377 if (q)
1378 return q->limits.max_write_same_sectors;
1379
1380 return 0;
1381}
1382
Jens Axboe165125e2007-07-24 09:28:11 +02001383static inline int queue_dma_alignment(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001384{
Pete Wyckoff482eb682008-01-01 10:23:02 -05001385 return q ? q->dma_alignment : 511;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001386}
1387
Namhyung Kim14417792010-09-15 13:08:27 +02001388static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
FUJITA Tomonori87904072008-08-28 15:05:58 +09001389 unsigned int len)
1390{
1391 unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
Namhyung Kim14417792010-09-15 13:08:27 +02001392 return !(addr & alignment) && !(len & alignment);
FUJITA Tomonori87904072008-08-28 15:05:58 +09001393}
1394
Linus Torvalds1da177e2005-04-16 15:20:36 -07001395/* assumes size > 256 */
1396static inline unsigned int blksize_bits(unsigned int size)
1397{
1398 unsigned int bits = 8;
1399 do {
1400 bits++;
1401 size >>= 1;
1402 } while (size > 256);
1403 return bits;
1404}
1405
Adrian Bunk2befb9e2005-09-10 00:27:17 -07001406static inline unsigned int block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001407{
1408 return bdev->bd_block_size;
1409}
1410
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001411static inline bool queue_flush_queueable(struct request_queue *q)
1412{
Jens Axboec888a8f2016-04-13 13:33:19 -06001413 return !test_bit(QUEUE_FLAG_FLUSH_NQ, &q->queue_flags);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001414}
1415
Linus Torvalds1da177e2005-04-16 15:20:36 -07001416typedef struct {struct page *v;} Sector;
1417
1418unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
1419
1420static inline void put_dev_sector(Sector p)
1421{
Kirill A. Shutemov09cbfea2016-04-01 15:29:47 +03001422 put_page(p.v);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001423}
1424
Ming Leie0af2912016-02-26 23:40:51 +08001425static inline bool __bvec_gap_to_prev(struct request_queue *q,
1426 struct bio_vec *bprv, unsigned int offset)
1427{
1428 return offset ||
1429 ((bprv->bv_offset + bprv->bv_len) & queue_virt_boundary(q));
1430}
1431
Keith Busch03100aa2015-08-19 14:24:05 -07001432/*
1433 * Check if adding a bio_vec after bprv with offset would create a gap in
1434 * the SG list. Most drivers don't care about this, but some do.
1435 */
1436static inline bool bvec_gap_to_prev(struct request_queue *q,
1437 struct bio_vec *bprv, unsigned int offset)
1438{
1439 if (!queue_virt_boundary(q))
1440 return false;
Ming Leie0af2912016-02-26 23:40:51 +08001441 return __bvec_gap_to_prev(q, bprv, offset);
Keith Busch03100aa2015-08-19 14:24:05 -07001442}
1443
Jens Axboe5e7c4272015-09-03 19:28:20 +03001444static inline bool bio_will_gap(struct request_queue *q, struct bio *prev,
1445 struct bio *next)
1446{
Ming Lei25e71a92016-02-26 23:40:52 +08001447 if (bio_has_data(prev) && queue_virt_boundary(q)) {
1448 struct bio_vec pb, nb;
Jens Axboe5e7c4272015-09-03 19:28:20 +03001449
Ming Lei25e71a92016-02-26 23:40:52 +08001450 bio_get_last_bvec(prev, &pb);
1451 bio_get_first_bvec(next, &nb);
1452
1453 return __bvec_gap_to_prev(q, &pb, nb.bv_offset);
1454 }
1455
1456 return false;
Jens Axboe5e7c4272015-09-03 19:28:20 +03001457}
1458
1459static inline bool req_gap_back_merge(struct request *req, struct bio *bio)
1460{
1461 return bio_will_gap(req->q, req->biotail, bio);
1462}
1463
1464static inline bool req_gap_front_merge(struct request *req, struct bio *bio)
1465{
1466 return bio_will_gap(req->q, bio, req->bio);
1467}
1468
Jens Axboe59c3d452014-04-08 09:15:35 -06001469int kblockd_schedule_work(struct work_struct *work);
Jens Axboeee63cfa2016-08-24 15:52:48 -06001470int kblockd_schedule_work_on(int cpu, struct work_struct *work);
Jens Axboe59c3d452014-04-08 09:15:35 -06001471int kblockd_schedule_delayed_work(struct delayed_work *dwork, unsigned long delay);
Jens Axboe8ab14592014-04-08 09:17:40 -06001472int kblockd_schedule_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001473
Divyesh Shah91952912010-04-01 15:01:41 -07001474#ifdef CONFIG_BLK_CGROUP
Jens Axboe28f41972010-06-01 12:23:18 +02001475/*
1476 * This should not be using sched_clock(). A real patch is in progress
1477 * to fix this up, until that is in place we need to disable preemption
1478 * around sched_clock() in this function and set_io_start_time_ns().
1479 */
Divyesh Shah91952912010-04-01 15:01:41 -07001480static inline void set_start_time_ns(struct request *req)
1481{
Jens Axboe28f41972010-06-01 12:23:18 +02001482 preempt_disable();
Divyesh Shah91952912010-04-01 15:01:41 -07001483 req->start_time_ns = sched_clock();
Jens Axboe28f41972010-06-01 12:23:18 +02001484 preempt_enable();
Divyesh Shah91952912010-04-01 15:01:41 -07001485}
1486
1487static inline void set_io_start_time_ns(struct request *req)
1488{
Jens Axboe28f41972010-06-01 12:23:18 +02001489 preempt_disable();
Divyesh Shah91952912010-04-01 15:01:41 -07001490 req->io_start_time_ns = sched_clock();
Jens Axboe28f41972010-06-01 12:23:18 +02001491 preempt_enable();
Divyesh Shah91952912010-04-01 15:01:41 -07001492}
Divyesh Shah84c124d2010-04-09 08:31:19 +02001493
1494static inline uint64_t rq_start_time_ns(struct request *req)
1495{
1496 return req->start_time_ns;
1497}
1498
1499static inline uint64_t rq_io_start_time_ns(struct request *req)
1500{
1501 return req->io_start_time_ns;
1502}
Divyesh Shah91952912010-04-01 15:01:41 -07001503#else
1504static inline void set_start_time_ns(struct request *req) {}
1505static inline void set_io_start_time_ns(struct request *req) {}
Divyesh Shah84c124d2010-04-09 08:31:19 +02001506static inline uint64_t rq_start_time_ns(struct request *req)
1507{
1508 return 0;
1509}
1510static inline uint64_t rq_io_start_time_ns(struct request *req)
1511{
1512 return 0;
1513}
Divyesh Shah91952912010-04-01 15:01:41 -07001514#endif
1515
Linus Torvalds1da177e2005-04-16 15:20:36 -07001516#define MODULE_ALIAS_BLOCKDEV(major,minor) \
1517 MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
1518#define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
1519 MODULE_ALIAS("block-major-" __stringify(major) "-*")
1520
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001521#if defined(CONFIG_BLK_DEV_INTEGRITY)
1522
Martin K. Petersen8288f492014-09-26 19:20:02 -04001523enum blk_integrity_flags {
1524 BLK_INTEGRITY_VERIFY = 1 << 0,
1525 BLK_INTEGRITY_GENERATE = 1 << 1,
Martin K. Petersen3aec2f42014-09-26 19:20:03 -04001526 BLK_INTEGRITY_DEVICE_CAPABLE = 1 << 2,
Martin K. Petersenaae7df52014-09-26 19:20:05 -04001527 BLK_INTEGRITY_IP_CHECKSUM = 1 << 3,
Martin K. Petersen8288f492014-09-26 19:20:02 -04001528};
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001529
Martin K. Petersen18593082014-09-26 19:20:01 -04001530struct blk_integrity_iter {
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001531 void *prot_buf;
1532 void *data_buf;
Martin K. Petersen3be91c42014-09-26 19:19:59 -04001533 sector_t seed;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001534 unsigned int data_size;
Martin K. Petersen3be91c42014-09-26 19:19:59 -04001535 unsigned short interval;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001536 const char *disk_name;
1537};
1538
Martin K. Petersen18593082014-09-26 19:20:01 -04001539typedef int (integrity_processing_fn) (struct blk_integrity_iter *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001540
Martin K. Petersen0f8087e2015-10-21 13:19:33 -04001541struct blk_integrity_profile {
1542 integrity_processing_fn *generate_fn;
1543 integrity_processing_fn *verify_fn;
1544 const char *name;
1545};
1546
Martin K. Petersen25520d52015-10-21 13:19:49 -04001547extern void blk_integrity_register(struct gendisk *, struct blk_integrity *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001548extern void blk_integrity_unregister(struct gendisk *);
Martin K. Petersenad7fce92008-10-01 03:38:39 -04001549extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001550extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
1551 struct scatterlist *);
1552extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001553extern bool blk_integrity_merge_rq(struct request_queue *, struct request *,
1554 struct request *);
1555extern bool blk_integrity_merge_bio(struct request_queue *, struct request *,
1556 struct bio *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001557
Martin K. Petersen25520d52015-10-21 13:19:49 -04001558static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1559{
Dan Williamsac6fc482015-10-21 13:20:18 -04001560 struct blk_integrity *bi = &disk->queue->integrity;
Martin K. Petersen25520d52015-10-21 13:19:49 -04001561
1562 if (!bi->profile)
1563 return NULL;
1564
1565 return bi;
1566}
1567
Jens Axboeb04accc2008-10-02 12:53:22 +02001568static inline
1569struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1570{
Martin K. Petersen25520d52015-10-21 13:19:49 -04001571 return blk_get_integrity(bdev->bd_disk);
Martin K. Petersenb02739b2008-10-02 18:47:49 +02001572}
1573
Martin K. Petersen180b2f92014-09-26 19:19:56 -04001574static inline bool blk_integrity_rq(struct request *rq)
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001575{
Martin K. Petersen180b2f92014-09-26 19:19:56 -04001576 return rq->cmd_flags & REQ_INTEGRITY;
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001577}
1578
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001579static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1580 unsigned int segs)
1581{
1582 q->limits.max_integrity_segments = segs;
1583}
1584
1585static inline unsigned short
1586queue_max_integrity_segments(struct request_queue *q)
1587{
1588 return q->limits.max_integrity_segments;
1589}
1590
Sagi Grimberg7f39add2015-09-11 09:03:04 -06001591static inline bool integrity_req_gap_back_merge(struct request *req,
1592 struct bio *next)
1593{
1594 struct bio_integrity_payload *bip = bio_integrity(req->bio);
1595 struct bio_integrity_payload *bip_next = bio_integrity(next);
1596
1597 return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
1598 bip_next->bip_vec[0].bv_offset);
1599}
1600
1601static inline bool integrity_req_gap_front_merge(struct request *req,
1602 struct bio *bio)
1603{
1604 struct bio_integrity_payload *bip = bio_integrity(bio);
1605 struct bio_integrity_payload *bip_next = bio_integrity(req->bio);
1606
1607 return bvec_gap_to_prev(req->q, &bip->bip_vec[bip->bip_vcnt - 1],
1608 bip_next->bip_vec[0].bv_offset);
1609}
1610
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001611#else /* CONFIG_BLK_DEV_INTEGRITY */
1612
Stephen Rothwellfd832402012-01-12 09:17:30 +01001613struct bio;
1614struct block_device;
1615struct gendisk;
1616struct blk_integrity;
1617
1618static inline int blk_integrity_rq(struct request *rq)
1619{
1620 return 0;
1621}
1622static inline int blk_rq_count_integrity_sg(struct request_queue *q,
1623 struct bio *b)
1624{
1625 return 0;
1626}
1627static inline int blk_rq_map_integrity_sg(struct request_queue *q,
1628 struct bio *b,
1629 struct scatterlist *s)
1630{
1631 return 0;
1632}
1633static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
1634{
Michele Curti61a04e52014-10-09 15:30:17 -07001635 return NULL;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001636}
1637static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1638{
1639 return NULL;
1640}
1641static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
1642{
1643 return 0;
1644}
Martin K. Petersen25520d52015-10-21 13:19:49 -04001645static inline void blk_integrity_register(struct gendisk *d,
Stephen Rothwellfd832402012-01-12 09:17:30 +01001646 struct blk_integrity *b)
1647{
Stephen Rothwellfd832402012-01-12 09:17:30 +01001648}
1649static inline void blk_integrity_unregister(struct gendisk *d)
1650{
1651}
1652static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1653 unsigned int segs)
1654{
1655}
1656static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
1657{
1658 return 0;
1659}
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001660static inline bool blk_integrity_merge_rq(struct request_queue *rq,
1661 struct request *r1,
1662 struct request *r2)
Stephen Rothwellfd832402012-01-12 09:17:30 +01001663{
Martin K. Petersencb1a5ab2014-10-28 20:27:43 -06001664 return true;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001665}
Martin K. Petersen4eaf99b2014-09-26 19:20:06 -04001666static inline bool blk_integrity_merge_bio(struct request_queue *rq,
1667 struct request *r,
1668 struct bio *b)
Stephen Rothwellfd832402012-01-12 09:17:30 +01001669{
Martin K. Petersencb1a5ab2014-10-28 20:27:43 -06001670 return true;
Stephen Rothwellfd832402012-01-12 09:17:30 +01001671}
Martin K. Petersen25520d52015-10-21 13:19:49 -04001672
Sagi Grimberg7f39add2015-09-11 09:03:04 -06001673static inline bool integrity_req_gap_back_merge(struct request *req,
1674 struct bio *next)
1675{
1676 return false;
1677}
1678static inline bool integrity_req_gap_front_merge(struct request *req,
1679 struct bio *bio)
1680{
1681 return false;
1682}
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001683
1684#endif /* CONFIG_BLK_DEV_INTEGRITY */
1685
Dan Williamsb2e0d162016-01-15 16:55:59 -08001686/**
1687 * struct blk_dax_ctl - control and output parameters for ->direct_access
1688 * @sector: (input) offset relative to a block_device
1689 * @addr: (output) kernel virtual address for @sector populated by driver
1690 * @pfn: (output) page frame number for @addr populated by driver
1691 * @size: (input) number of bytes requested
1692 */
1693struct blk_dax_ctl {
1694 sector_t sector;
Dan Williams7a9eb202016-06-03 18:06:47 -07001695 void *addr;
Dan Williamsb2e0d162016-01-15 16:55:59 -08001696 long size;
Dan Williams34c0fd52016-01-15 16:56:14 -08001697 pfn_t pfn;
Dan Williamsb2e0d162016-01-15 16:55:59 -08001698};
1699
Al Viro08f85852007-10-08 13:26:20 -04001700struct block_device_operations {
Al Virod4430d622008-03-02 09:09:22 -05001701 int (*open) (struct block_device *, fmode_t);
Al Virodb2a1442013-05-05 21:52:57 -04001702 void (*release) (struct gendisk *, fmode_t);
Jens Axboec11f0c02016-08-05 08:11:04 -06001703 int (*rw_page)(struct block_device *, sector_t, struct page *, bool);
Al Virod4430d622008-03-02 09:09:22 -05001704 int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1705 int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
Dan Williams7a9eb202016-06-03 18:06:47 -07001706 long (*direct_access)(struct block_device *, sector_t, void **, pfn_t *,
1707 long);
Tejun Heo77ea8872010-12-08 20:57:37 +01001708 unsigned int (*check_events) (struct gendisk *disk,
1709 unsigned int clearing);
1710 /* ->media_changed() is DEPRECATED, use ->check_events() instead */
Al Viro08f85852007-10-08 13:26:20 -04001711 int (*media_changed) (struct gendisk *);
Tejun Heoc3e33e02010-05-15 20:09:29 +02001712 void (*unlock_native_capacity) (struct gendisk *);
Al Viro08f85852007-10-08 13:26:20 -04001713 int (*revalidate_disk) (struct gendisk *);
1714 int (*getgeo)(struct block_device *, struct hd_geometry *);
Nitin Guptab3a27d02010-05-17 11:02:43 +05301715 /* this callback is with swap_lock and sometimes page table lock held */
1716 void (*swap_slot_free_notify) (struct block_device *, unsigned long);
Al Viro08f85852007-10-08 13:26:20 -04001717 struct module *owner;
Christoph Hellwigbbd3e062015-10-15 14:10:48 +02001718 const struct pr_ops *pr_ops;
Al Viro08f85852007-10-08 13:26:20 -04001719};
1720
Al Viro633a08b2007-08-29 20:34:12 -04001721extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1722 unsigned long);
Matthew Wilcox47a191f2014-06-04 16:07:46 -07001723extern int bdev_read_page(struct block_device *, sector_t, struct page *);
1724extern int bdev_write_page(struct block_device *, sector_t, struct page *,
1725 struct writeback_control *);
Dan Williamsb2e0d162016-01-15 16:55:59 -08001726extern long bdev_direct_access(struct block_device *, struct blk_dax_ctl *);
Toshi Kani2d96afc2016-05-10 10:23:53 -06001727extern int bdev_dax_supported(struct super_block *, int);
Toshi Kania8078b12016-05-10 10:23:57 -06001728extern bool bdev_dax_capable(struct block_device *);
David Howells93614012006-09-30 20:45:40 +02001729#else /* CONFIG_BLOCK */
Fabian Frederickac13a822014-06-04 16:06:27 -07001730
1731struct block_device;
1732
David Howells93614012006-09-30 20:45:40 +02001733/*
1734 * stubs for when the block layer is configured out
1735 */
1736#define buffer_heads_over_limit 0
1737
David Howells93614012006-09-30 20:45:40 +02001738static inline long nr_blockdev_pages(void)
1739{
1740 return 0;
1741}
1742
Jens Axboe1f940bd2011-03-11 20:17:08 +01001743struct blk_plug {
1744};
1745
1746static inline void blk_start_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001747{
1748}
1749
Jens Axboe1f940bd2011-03-11 20:17:08 +01001750static inline void blk_finish_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001751{
1752}
1753
Jens Axboe1f940bd2011-03-11 20:17:08 +01001754static inline void blk_flush_plug(struct task_struct *task)
Jens Axboe73c10102011-03-08 13:19:51 +01001755{
1756}
1757
Jens Axboea237c1c2011-04-16 13:27:55 +02001758static inline void blk_schedule_flush_plug(struct task_struct *task)
1759{
1760}
1761
1762
Jens Axboe73c10102011-03-08 13:19:51 +01001763static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1764{
1765 return false;
1766}
1767
Fabian Frederickac13a822014-06-04 16:06:27 -07001768static inline int blkdev_issue_flush(struct block_device *bdev, gfp_t gfp_mask,
1769 sector_t *error_sector)
1770{
1771 return 0;
1772}
1773
David Howells93614012006-09-30 20:45:40 +02001774#endif /* CONFIG_BLOCK */
1775
Linus Torvalds1da177e2005-04-16 15:20:36 -07001776#endif