blob: 8bc46c250ca4c7500d7664e9e64cbbd94d2a07ea [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>
11#include <linux/timer.h>
12#include <linux/workqueue.h>
13#include <linux/pagemap.h>
14#include <linux/backing-dev.h>
15#include <linux/wait.h>
16#include <linux/mempool.h>
17#include <linux/bio.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070018#include <linux/stringify.h>
Hugh Dickins3e6053d2008-09-11 10:57:55 +020019#include <linux/gfp.h>
FUJITA Tomonorid351af02007-07-09 12:40:35 +020020#include <linux/bsg.h>
Jens Axboec7c22e42008-09-13 20:26:01 +020021#include <linux/smp.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070022
23#include <asm/scatterlist.h>
24
Paul Gortmakerde477252011-05-26 13:46:22 -040025struct module;
Christoph Hellwig21b2f0c2006-03-22 17:52:04 +010026struct scsi_ioctl_command;
27
Linus Torvalds1da177e2005-04-16 15:20:36 -070028struct request_queue;
Linus Torvalds1da177e2005-04-16 15:20:36 -070029struct elevator_queue;
Linus Torvalds1da177e2005-04-16 15:20:36 -070030struct request_pm_state;
Jens Axboe2056a782006-03-23 20:00:26 +010031struct blk_trace;
Jens Axboe3d6392c2007-07-09 12:38:05 +020032struct request;
33struct sg_io_hdr;
Mike Christieaa387cc2011-07-31 22:05:09 +020034struct bsg_job;
Tejun Heo3c798392012-04-16 13:57:25 -070035struct blkcg_gq;
Linus Torvalds1da177e2005-04-16 15:20:36 -070036
37#define BLKDEV_MIN_RQ 4
38#define BLKDEV_MAX_RQ 128 /* Default maximum */
39
Tejun Heo8bd435b2012-04-13 13:11:28 -070040/*
41 * Maximum number of blkcg policies allowed to be registered concurrently.
42 * Defined here to simplify include dependency.
43 */
44#define BLKCG_MAX_POLS 2
45
Linus Torvalds1da177e2005-04-16 15:20:36 -070046struct request;
Tejun Heo8ffdc652006-01-06 09:49:03 +010047typedef void (rq_end_io_fn)(struct request *, int);
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
Tejun Heo5b788ce2012-06-04 20:40:59 -070049#define BLK_RL_SYNCFULL (1U << 0)
50#define BLK_RL_ASYNCFULL (1U << 1)
51
Linus Torvalds1da177e2005-04-16 15:20:36 -070052struct request_list {
Tejun Heo5b788ce2012-06-04 20:40:59 -070053 struct request_queue *q; /* the queue this rl belongs to */
Tejun Heoa0516612012-06-26 15:05:44 -070054#ifdef CONFIG_BLK_CGROUP
55 struct blkcg_gq *blkg; /* blkg this request pool belongs to */
56#endif
Jens Axboe1faa16d2009-04-06 14:48:01 +020057 /*
58 * count[], starved[], and wait[] are indexed by
59 * BLK_RW_SYNC/BLK_RW_ASYNC
60 */
Tejun Heo8a5ecdd2012-06-04 20:40:58 -070061 int count[2];
62 int starved[2];
63 mempool_t *rq_pool;
64 wait_queue_head_t wait[2];
Tejun Heo5b788ce2012-06-04 20:40:59 -070065 unsigned int flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -070066};
67
Jens Axboe4aff5e22006-08-10 08:44:47 +020068/*
69 * request command types
70 */
71enum rq_cmd_type_bits {
72 REQ_TYPE_FS = 1, /* fs request */
73 REQ_TYPE_BLOCK_PC, /* scsi command */
74 REQ_TYPE_SENSE, /* sense request */
75 REQ_TYPE_PM_SUSPEND, /* suspend request */
76 REQ_TYPE_PM_RESUME, /* resume request */
77 REQ_TYPE_PM_SHUTDOWN, /* shutdown request */
Jens Axboe4aff5e22006-08-10 08:44:47 +020078 REQ_TYPE_SPECIAL, /* driver defined type */
Jens Axboe4aff5e22006-08-10 08:44:47 +020079 /*
80 * for ATA/ATAPI devices. this really doesn't belong here, ide should
81 * use REQ_TYPE_SPECIAL and use rq->cmd[0] with the range of driver
82 * private REQ_LB opcodes to differentiate what type of request this is
83 */
Jens Axboe4aff5e22006-08-10 08:44:47 +020084 REQ_TYPE_ATA_TASKFILE,
Jens Axboecea28852006-10-12 15:08:45 +020085 REQ_TYPE_ATA_PC,
Jens Axboe4aff5e22006-08-10 08:44:47 +020086};
87
Linus Torvalds1da177e2005-04-16 15:20:36 -070088#define BLK_MAX_CDB 16
89
90/*
Jens Axboe63a71382008-02-08 12:41:03 +010091 * try to put the fields that are referenced together in the same cacheline.
Wanlong Gao4d0d98b62011-06-13 10:45:38 +020092 * if you modify this structure, be sure to check block/blk-core.c:blk_rq_init()
Jens Axboe63a71382008-02-08 12:41:03 +010093 * as well!
Linus Torvalds1da177e2005-04-16 15:20:36 -070094 */
95struct request {
Jens Axboeff856ba2006-01-09 16:02:34 +010096 struct list_head queuelist;
Jens Axboec7c22e42008-09-13 20:26:01 +020097 struct call_single_data csd;
Jens Axboeff856ba2006-01-09 16:02:34 +010098
Jens Axboe165125e2007-07-24 09:28:11 +020099 struct request_queue *q;
Jens Axboee6a1c872006-08-10 09:00:21 +0200100
Jens Axboe4aff5e22006-08-10 08:44:47 +0200101 unsigned int cmd_flags;
102 enum rq_cmd_type_bits cmd_type;
Jens Axboe242f9dc2008-09-14 05:55:09 -0700103 unsigned long atomic_flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104
Richard Kennedy181fdde2010-03-19 08:58:16 +0100105 int cpu;
106
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900107 /* the following two fields are internal, NEVER access directly */
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900108 unsigned int __data_len; /* total data len */
Richard Kennedy181fdde2010-03-19 08:58:16 +0100109 sector_t __sector; /* sector cursor */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700110
111 struct bio *bio;
112 struct bio *biotail;
113
Jens Axboe98170642006-07-28 09:23:08 +0200114 struct hlist_node hash; /* merge hash */
Jens Axboee6a1c872006-08-10 09:00:21 +0200115 /*
116 * The rb_node is only used inside the io scheduler, requests
117 * are pruned when moved to the dispatch queue. So let the
Mike Snitzerc1867942011-02-11 11:08:00 +0100118 * completion_data share space with the rb_node.
Jens Axboee6a1c872006-08-10 09:00:21 +0200119 */
120 union {
121 struct rb_node rb_node; /* sort/lookup */
Mike Snitzerc1867942011-02-11 11:08:00 +0100122 void *completion_data;
Jens Axboee6a1c872006-08-10 09:00:21 +0200123 };
Jens Axboe98170642006-07-28 09:23:08 +0200124
Jens Axboeff7d1452006-07-12 14:04:37 +0200125 /*
Vivek Goyal7f1dc8a2010-04-21 17:44:16 +0200126 * Three pointers are available for the IO schedulers, if they need
Mike Snitzerc1867942011-02-11 11:08:00 +0100127 * more they have to dynamically allocate it. Flush requests are
128 * never put on the IO scheduler. So let the flush fields share
Tejun Heoa612fdd2011-12-14 00:33:41 +0100129 * space with the elevator data.
Jens Axboeff7d1452006-07-12 14:04:37 +0200130 */
Mike Snitzerc1867942011-02-11 11:08:00 +0100131 union {
Tejun Heoa612fdd2011-12-14 00:33:41 +0100132 struct {
133 struct io_cq *icq;
134 void *priv[2];
135 } elv;
136
Mike Snitzerc1867942011-02-11 11:08:00 +0100137 struct {
138 unsigned int seq;
139 struct list_head list;
Jeff Moyer4853aba2011-08-15 21:37:25 +0200140 rq_end_io_fn *saved_end_io;
Mike Snitzerc1867942011-02-11 11:08:00 +0100141 } flush;
142 };
Jens Axboeff7d1452006-07-12 14:04:37 +0200143
Jens Axboe8f34ee72006-06-13 09:02:34 +0200144 struct gendisk *rq_disk;
Jerome Marchand09e099d2011-01-05 16:57:38 +0100145 struct hd_struct *part;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700146 unsigned long start_time;
Divyesh Shah91952912010-04-01 15:01:41 -0700147#ifdef CONFIG_BLK_CGROUP
Tejun Heoa0516612012-06-26 15:05:44 -0700148 struct request_list *rl; /* rl this rq is alloced from */
Divyesh Shah91952912010-04-01 15:01:41 -0700149 unsigned long long start_time_ns;
150 unsigned long long io_start_time_ns; /* when passed to hardware */
151#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152 /* Number of scatter-gather DMA addr+len pairs after
153 * physical address coalescing is performed.
154 */
155 unsigned short nr_phys_segments;
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200156#if defined(CONFIG_BLK_DEV_INTEGRITY)
157 unsigned short nr_integrity_segments;
158#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700159
Jens Axboe8f34ee72006-06-13 09:02:34 +0200160 unsigned short ioprio;
161
Richard Kennedy181fdde2010-03-19 08:58:16 +0100162 int ref_count;
163
Tejun Heo731ec492009-04-23 11:05:20 +0900164 void *special; /* opaque pointer available for LLD use */
165 char *buffer; /* kaddr of the current segment if available */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166
Jens Axboecdd60262006-07-28 09:32:07 +0200167 int tag;
168 int errors;
169
Linus Torvalds1da177e2005-04-16 15:20:36 -0700170 /*
171 * when request is used as a packet command carrier
172 */
FUJITA Tomonorid7e3c322008-04-29 09:54:39 +0200173 unsigned char __cmd[BLK_MAX_CDB];
174 unsigned char *cmd;
Richard Kennedy181fdde2010-03-19 08:58:16 +0100175 unsigned short cmd_len;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700176
FUJITA Tomonori7a85f882008-03-04 11:17:11 +0100177 unsigned int extra_len; /* length of alignment and padding */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700178 unsigned int sense_len;
Tejun Heoc3a4d782009-05-07 22:24:37 +0900179 unsigned int resid_len; /* residual count */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700180 void *sense;
181
Jens Axboe242f9dc2008-09-14 05:55:09 -0700182 unsigned long deadline;
183 struct list_head timeout_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700184 unsigned int timeout;
Mike Christie17e01f22005-11-11 05:31:37 -0600185 int retries;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700186
187 /*
Jens Axboec00895a2006-09-30 20:29:12 +0200188 * completion callback.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700189 */
190 rq_end_io_fn *end_io;
191 void *end_io_data;
FUJITA Tomonoriabae1fd2007-07-16 08:52:14 +0200192
193 /* for bidi */
194 struct request *next_rq;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700195};
196
Fernando Luis Vázquez Cao766ca442008-08-14 09:59:13 +0200197static inline unsigned short req_get_ioprio(struct request *req)
198{
199 return req->ioprio;
200}
201
Linus Torvalds1da177e2005-04-16 15:20:36 -0700202/*
Jens Axboe4aff5e22006-08-10 08:44:47 +0200203 * State information carried for REQ_TYPE_PM_SUSPEND and REQ_TYPE_PM_RESUME
Linus Torvalds1da177e2005-04-16 15:20:36 -0700204 * requests. Some step values could eventually be made generic.
205 */
206struct request_pm_state
207{
208 /* PM state machine step value, currently driver specific */
209 int pm_step;
210 /* requested PM state value (S1, S2, S3, S4, ...) */
211 u32 pm_state;
212 void* data; /* for driver use */
213};
214
215#include <linux/elevator.h>
216
Jens Axboe165125e2007-07-24 09:28:11 +0200217typedef void (request_fn_proc) (struct request_queue *q);
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200218typedef void (make_request_fn) (struct request_queue *q, struct bio *bio);
Jens Axboe165125e2007-07-24 09:28:11 +0200219typedef int (prep_rq_fn) (struct request_queue *, struct request *);
James Bottomley28018c22010-07-01 19:49:17 +0900220typedef void (unprep_rq_fn) (struct request_queue *, struct request *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700221
222struct bio_vec;
Alasdair G Kergoncc371e62008-07-03 09:53:43 +0200223struct bvec_merge_data {
224 struct block_device *bi_bdev;
225 sector_t bi_sector;
226 unsigned bi_size;
227 unsigned long bi_rw;
228};
229typedef int (merge_bvec_fn) (struct request_queue *, struct bvec_merge_data *,
230 struct bio_vec *);
Jens Axboeff856ba2006-01-09 16:02:34 +0100231typedef void (softirq_done_fn)(struct request *);
Tejun Heo2fb98e82008-02-19 11:36:53 +0100232typedef int (dma_drain_needed_fn)(struct request *);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200233typedef int (lld_busy_fn) (struct request_queue *q);
Mike Christieaa387cc2011-07-31 22:05:09 +0200234typedef int (bsg_job_fn) (struct bsg_job *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235
Jens Axboe242f9dc2008-09-14 05:55:09 -0700236enum blk_eh_timer_return {
237 BLK_EH_NOT_HANDLED,
238 BLK_EH_HANDLED,
239 BLK_EH_RESET_TIMER,
240};
241
242typedef enum blk_eh_timer_return (rq_timed_out_fn)(struct request *);
243
Linus Torvalds1da177e2005-04-16 15:20:36 -0700244enum blk_queue_state {
245 Queue_down,
246 Queue_up,
247};
248
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249struct blk_queue_tag {
250 struct request **tag_index; /* map of busy tags */
251 unsigned long *tag_map; /* bit map of free/busy tags */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700252 int busy; /* current depth */
253 int max_depth; /* what we will send to device */
Tejun Heoba025082005-08-05 13:28:11 -0700254 int real_max_depth; /* what the array can hold */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700255 atomic_t refcnt; /* map can be shared */
256};
257
FUJITA Tomonoriabf54392008-08-16 14:10:05 +0900258#define BLK_SCSI_MAX_CMDS (256)
259#define BLK_SCSI_CMD_PER_LONG (BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
260
Martin K. Petersen025146e2009-05-22 17:17:51 -0400261struct queue_limits {
262 unsigned long bounce_pfn;
263 unsigned long seg_boundary_mask;
264
265 unsigned int max_hw_sectors;
266 unsigned int max_sectors;
267 unsigned int max_segment_size;
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400268 unsigned int physical_block_size;
269 unsigned int alignment_offset;
270 unsigned int io_min;
271 unsigned int io_opt;
Christoph Hellwig67efc922009-09-30 13:54:20 +0200272 unsigned int max_discard_sectors;
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400273 unsigned int max_write_same_sectors;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100274 unsigned int discard_granularity;
275 unsigned int discard_alignment;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400276
277 unsigned short logical_block_size;
Martin K. Petersen8a783622010-02-26 00:20:39 -0500278 unsigned short max_segments;
Martin K. Petersen13f05c82010-09-10 20:50:10 +0200279 unsigned short max_integrity_segments;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400280
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400281 unsigned char misaligned;
Martin K. Petersen86b37282009-11-10 11:50:21 +0100282 unsigned char discard_misaligned;
Martin K. Petersene692cb62010-12-01 19:41:49 +0100283 unsigned char cluster;
Martin K. Petersena934a002011-05-18 10:37:35 +0200284 unsigned char discard_zeroes_data;
Martin K. Petersen025146e2009-05-22 17:17:51 -0400285};
286
Richard Kennedyd7b76302011-07-13 21:17:23 +0200287struct request_queue {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700288 /*
289 * Together with queue_head for cacheline sharing
290 */
291 struct list_head queue_head;
292 struct request *last_merge;
Jens Axboeb374d182008-10-31 10:05:07 +0100293 struct elevator_queue *elevator;
Tejun Heo8a5ecdd2012-06-04 20:40:58 -0700294 int nr_rqs[2]; /* # allocated [a]sync rqs */
295 int nr_rqs_elvpriv; /* # allocated rqs w/ elvpriv */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700296
297 /*
Tejun Heoa0516612012-06-26 15:05:44 -0700298 * If blkcg is not used, @q->root_rl serves all requests. If blkcg
299 * is used, root blkg allocates from @q->root_rl and all other
300 * blkgs from their own blkg->rl. Which one to use should be
301 * determined using bio_request_list().
Linus Torvalds1da177e2005-04-16 15:20:36 -0700302 */
Tejun Heoa0516612012-06-26 15:05:44 -0700303 struct request_list root_rl;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700304
305 request_fn_proc *request_fn;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700306 make_request_fn *make_request_fn;
307 prep_rq_fn *prep_rq_fn;
James Bottomley28018c22010-07-01 19:49:17 +0900308 unprep_rq_fn *unprep_rq_fn;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700309 merge_bvec_fn *merge_bvec_fn;
Jens Axboeff856ba2006-01-09 16:02:34 +0100310 softirq_done_fn *softirq_done_fn;
Jens Axboe242f9dc2008-09-14 05:55:09 -0700311 rq_timed_out_fn *rq_timed_out_fn;
Tejun Heo2fb98e82008-02-19 11:36:53 +0100312 dma_drain_needed_fn *dma_drain_needed;
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200313 lld_busy_fn *lld_busy_fn;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700314
315 /*
Tejun Heo8922e162005-10-20 16:23:44 +0200316 * Dispatch queue sorting
317 */
Jens Axboe1b47f532005-10-20 16:37:00 +0200318 sector_t end_sector;
Tejun Heo8922e162005-10-20 16:23:44 +0200319 struct request *boundary_rq;
Tejun Heo8922e162005-10-20 16:23:44 +0200320
321 /*
Jens Axboe3cca6dc2011-03-02 11:08:00 -0500322 * Delayed queue handling
Linus Torvalds1da177e2005-04-16 15:20:36 -0700323 */
Jens Axboe3cca6dc2011-03-02 11:08:00 -0500324 struct delayed_work delay_work;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700325
326 struct backing_dev_info backing_dev_info;
327
328 /*
329 * The queue owner gets to use this for whatever they like.
330 * ll_rw_blk doesn't touch it.
331 */
332 void *queuedata;
333
Linus Torvalds1da177e2005-04-16 15:20:36 -0700334 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700335 * various queue flags, see QUEUE_* below
336 */
337 unsigned long queue_flags;
338
339 /*
Tejun Heoa73f7302011-12-14 00:33:37 +0100340 * ida allocated id for this queue. Used to index queues from
341 * ioctx.
342 */
343 int id;
344
345 /*
Richard Kennedyd7b76302011-07-13 21:17:23 +0200346 * queue needs bounce pages for pages above this limit
347 */
348 gfp_t bounce_gfp;
349
350 /*
152587d2005-04-12 16:22:06 -0500351 * protects queue structures from reentrancy. ->__queue_lock should
352 * _never_ be used directly, it is queue private. always use
353 * ->queue_lock.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700354 */
152587d2005-04-12 16:22:06 -0500355 spinlock_t __queue_lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700356 spinlock_t *queue_lock;
357
358 /*
359 * queue kobject
360 */
361 struct kobject kobj;
362
363 /*
364 * queue settings
365 */
366 unsigned long nr_requests; /* Max # of requests */
367 unsigned int nr_congestion_on;
368 unsigned int nr_congestion_off;
369 unsigned int nr_batching;
370
James Bottomleyfa0ccd82008-01-10 11:30:36 -0600371 unsigned int dma_drain_size;
Richard Kennedyd7b76302011-07-13 21:17:23 +0200372 void *dma_drain_buffer;
Tejun Heoe3790c72008-03-04 11:18:17 +0100373 unsigned int dma_pad_mask;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700374 unsigned int dma_alignment;
375
376 struct blk_queue_tag *queue_tags;
Jens Axboe6eca9002007-10-25 10:14:47 +0200377 struct list_head tag_busy_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700378
Tejun Heo15853af2005-11-10 08:52:05 +0100379 unsigned int nr_sorted;
Jens Axboe0a7ae2f2009-05-20 08:54:31 +0200380 unsigned int in_flight[2];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700381
Jens Axboe242f9dc2008-09-14 05:55:09 -0700382 unsigned int rq_timeout;
383 struct timer_list timeout;
384 struct list_head timeout_list;
385
Tejun Heoa612fdd2011-12-14 00:33:41 +0100386 struct list_head icq_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800387#ifdef CONFIG_BLK_CGROUP
Tejun Heoa2b16932012-04-13 13:11:33 -0700388 DECLARE_BITMAP (blkcg_pols, BLKCG_MAX_POLS);
Tejun Heo3c798392012-04-16 13:57:25 -0700389 struct blkcg_gq *root_blkg;
Tejun Heo03aa2642012-03-05 13:15:19 -0800390 struct list_head blkg_list;
Tejun Heo4eef3042012-03-05 13:15:18 -0800391#endif
Tejun Heoa612fdd2011-12-14 00:33:41 +0100392
Martin K. Petersen025146e2009-05-22 17:17:51 -0400393 struct queue_limits limits;
394
Linus Torvalds1da177e2005-04-16 15:20:36 -0700395 /*
396 * sg stuff
397 */
398 unsigned int sg_timeout;
399 unsigned int sg_reserved_size;
Christoph Lameter19460892005-06-23 00:08:19 -0700400 int node;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700401#ifdef CONFIG_BLK_DEV_IO_TRACE
Jens Axboe2056a782006-03-23 20:00:26 +0100402 struct blk_trace *blk_trace;
Alexey Dobriyan6c5c9342006-09-29 01:59:40 -0700403#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700404 /*
Tejun Heo4913efe2010-09-03 11:56:16 +0200405 * for flush operations
Linus Torvalds1da177e2005-04-16 15:20:36 -0700406 */
Tejun Heo4913efe2010-09-03 11:56:16 +0200407 unsigned int flush_flags;
shaohua.li@intel.comf3876932011-05-06 11:34:32 -0600408 unsigned int flush_not_queueable:1;
shaohua.li@intel.com3ac0cc42011-05-06 11:34:41 -0600409 unsigned int flush_queue_delayed:1;
Tejun Heoae1b1532011-01-25 12:43:54 +0100410 unsigned int flush_pending_idx:1;
411 unsigned int flush_running_idx:1;
412 unsigned long flush_pending_since;
413 struct list_head flush_queue[2];
414 struct list_head flush_data_in_flight;
Tejun Heodd4c1332010-09-03 11:56:16 +0200415 struct request flush_rq;
Al Viro483f4af2006-03-18 18:34:37 -0500416
417 struct mutex sysfs_lock;
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200418
Tejun Heod7325802012-03-05 13:14:58 -0800419 int bypass_depth;
420
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200421#if defined(CONFIG_BLK_DEV_BSG)
Mike Christieaa387cc2011-07-31 22:05:09 +0200422 bsg_job_fn *bsg_job_fn;
423 int bsg_job_size;
FUJITA Tomonorid351af02007-07-09 12:40:35 +0200424 struct bsg_class_device bsg_dev;
425#endif
Vivek Goyale43473b2010-09-15 17:06:35 -0400426
Tejun Heo923adde2012-03-05 13:15:13 -0800427#ifdef CONFIG_BLK_CGROUP
428 struct list_head all_q_node;
429#endif
Vivek Goyale43473b2010-09-15 17:06:35 -0400430#ifdef CONFIG_BLK_DEV_THROTTLING
431 /* Throttle data */
432 struct throtl_data *td;
433#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700434};
435
Linus Torvalds1da177e2005-04-16 15:20:36 -0700436#define QUEUE_FLAG_QUEUED 1 /* uses generic tag queueing */
437#define QUEUE_FLAG_STOPPED 2 /* queue is stopped */
Jens Axboe1faa16d2009-04-06 14:48:01 +0200438#define QUEUE_FLAG_SYNCFULL 3 /* read queue has been filled */
439#define QUEUE_FLAG_ASYNCFULL 4 /* write queue has been filled */
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100440#define QUEUE_FLAG_DYING 5 /* queue being torn down */
Tejun Heod7325802012-03-05 13:14:58 -0800441#define QUEUE_FLAG_BYPASS 6 /* act as dumb FIFO queue */
Jens Axboec21e6be2011-04-19 13:32:46 +0200442#define QUEUE_FLAG_BIDI 7 /* queue supports bidi requests */
443#define QUEUE_FLAG_NOMERGES 8 /* disable merge attempts */
Dan Williams5757a6d2011-07-23 20:44:25 +0200444#define QUEUE_FLAG_SAME_COMP 9 /* complete on same CPU-group */
Jens Axboec21e6be2011-04-19 13:32:46 +0200445#define QUEUE_FLAG_FAIL_IO 10 /* fake timeout */
446#define QUEUE_FLAG_STACKABLE 11 /* supports request stacking */
447#define QUEUE_FLAG_NONROT 12 /* non-rotational device (SSD) */
Fernando Luis Vázquez Cao88e740f2008-10-27 18:44:46 +0900448#define QUEUE_FLAG_VIRT QUEUE_FLAG_NONROT /* paravirt device */
Jens Axboec21e6be2011-04-19 13:32:46 +0200449#define QUEUE_FLAG_IO_STAT 13 /* do IO stats */
450#define QUEUE_FLAG_DISCARD 14 /* supports DISCARD */
451#define QUEUE_FLAG_NOXMERGES 15 /* No extended merges */
452#define QUEUE_FLAG_ADD_RANDOM 16 /* Contributes to random pool */
453#define QUEUE_FLAG_SECDISCARD 17 /* supports SECDISCARD */
Dan Williams5757a6d2011-07-23 20:44:25 +0200454#define QUEUE_FLAG_SAME_FORCE 18 /* force complete on same CPU */
Bart Van Asschec246e802012-12-06 14:32:01 +0100455#define QUEUE_FLAG_DEAD 19 /* queue tear-down finished */
Jens Axboebc58ba92009-01-23 10:54:44 +0100456
457#define QUEUE_FLAG_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
Jens Axboe01e97f62009-09-03 20:06:47 +0200458 (1 << QUEUE_FLAG_STACKABLE) | \
Jens Axboee2e1a142010-06-09 10:42:09 +0200459 (1 << QUEUE_FLAG_SAME_COMP) | \
460 (1 << QUEUE_FLAG_ADD_RANDOM))
Tejun Heo797e7db2006-01-06 09:51:03 +0100461
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200462static inline void queue_lockdep_assert_held(struct request_queue *q)
Linus Torvalds8f45c1a2008-04-29 10:16:38 -0700463{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200464 if (q->queue_lock)
465 lockdep_assert_held(q->queue_lock);
Linus Torvalds8f45c1a2008-04-29 10:16:38 -0700466}
467
Nick Piggin75ad23b2008-04-29 14:48:33 +0200468static inline void queue_flag_set_unlocked(unsigned int flag,
469 struct request_queue *q)
470{
471 __set_bit(flag, &q->queue_flags);
472}
473
Jens Axboee48ec692008-07-03 13:18:54 +0200474static inline int queue_flag_test_and_clear(unsigned int flag,
475 struct request_queue *q)
476{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200477 queue_lockdep_assert_held(q);
Jens Axboee48ec692008-07-03 13:18:54 +0200478
479 if (test_bit(flag, &q->queue_flags)) {
480 __clear_bit(flag, &q->queue_flags);
481 return 1;
482 }
483
484 return 0;
485}
486
487static inline int queue_flag_test_and_set(unsigned int flag,
488 struct request_queue *q)
489{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200490 queue_lockdep_assert_held(q);
Jens Axboee48ec692008-07-03 13:18:54 +0200491
492 if (!test_bit(flag, &q->queue_flags)) {
493 __set_bit(flag, &q->queue_flags);
494 return 0;
495 }
496
497 return 1;
498}
499
Nick Piggin75ad23b2008-04-29 14:48:33 +0200500static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
501{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200502 queue_lockdep_assert_held(q);
Nick Piggin75ad23b2008-04-29 14:48:33 +0200503 __set_bit(flag, &q->queue_flags);
504}
505
506static inline void queue_flag_clear_unlocked(unsigned int flag,
507 struct request_queue *q)
508{
509 __clear_bit(flag, &q->queue_flags);
510}
511
Jens Axboe0a7ae2f2009-05-20 08:54:31 +0200512static inline int queue_in_flight(struct request_queue *q)
513{
514 return q->in_flight[0] + q->in_flight[1];
515}
516
Nick Piggin75ad23b2008-04-29 14:48:33 +0200517static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
518{
Andi Kleen8bcb6c72012-03-30 12:33:28 +0200519 queue_lockdep_assert_held(q);
Nick Piggin75ad23b2008-04-29 14:48:33 +0200520 __clear_bit(flag, &q->queue_flags);
521}
522
Linus Torvalds1da177e2005-04-16 15:20:36 -0700523#define blk_queue_tagged(q) test_bit(QUEUE_FLAG_QUEUED, &(q)->queue_flags)
524#define blk_queue_stopped(q) test_bit(QUEUE_FLAG_STOPPED, &(q)->queue_flags)
Bart Van Assche3f3299d2012-11-28 13:42:38 +0100525#define blk_queue_dying(q) test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
Bart Van Asschec246e802012-12-06 14:32:01 +0100526#define blk_queue_dead(q) test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
Tejun Heod7325802012-03-05 13:14:58 -0800527#define blk_queue_bypass(q) test_bit(QUEUE_FLAG_BYPASS, &(q)->queue_flags)
Alan D. Brunelleac9fafa2008-04-29 14:44:19 +0200528#define blk_queue_nomerges(q) test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
Alan D. Brunelle488991e2010-01-29 09:04:08 +0100529#define blk_queue_noxmerges(q) \
530 test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
Jens Axboea68bbddba2008-09-24 13:03:33 +0200531#define blk_queue_nonrot(q) test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
Jens Axboebc58ba92009-01-23 10:54:44 +0100532#define blk_queue_io_stat(q) test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
Jens Axboee2e1a142010-06-09 10:42:09 +0200533#define blk_queue_add_random(q) test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
Kiyoshi Ueda4ee5eaf2008-09-18 10:46:13 -0400534#define blk_queue_stackable(q) \
535 test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
Christoph Hellwigc15227d2009-09-30 13:52:12 +0200536#define blk_queue_discard(q) test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
Adrian Hunter8d57a982010-08-11 14:17:49 -0700537#define blk_queue_secdiscard(q) (blk_queue_discard(q) && \
538 test_bit(QUEUE_FLAG_SECDISCARD, &(q)->queue_flags))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700539
Christoph Hellwig33659eb2010-08-07 18:17:56 +0200540#define blk_noretry_request(rq) \
541 ((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
542 REQ_FAILFAST_DRIVER))
Jens Axboe4aff5e22006-08-10 08:44:47 +0200543
Christoph Hellwig33659eb2010-08-07 18:17:56 +0200544#define blk_account_rq(rq) \
545 (((rq)->cmd_flags & REQ_STARTED) && \
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400546 ((rq)->cmd_type == REQ_TYPE_FS))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700547
Linus Torvalds1da177e2005-04-16 15:20:36 -0700548#define blk_pm_request(rq) \
Christoph Hellwig33659eb2010-08-07 18:17:56 +0200549 ((rq)->cmd_type == REQ_TYPE_PM_SUSPEND || \
550 (rq)->cmd_type == REQ_TYPE_PM_RESUME)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700551
Jens Axboeab780f12008-08-26 10:25:02 +0200552#define blk_rq_cpu_valid(rq) ((rq)->cpu != -1)
FUJITA Tomonoriabae1fd2007-07-16 08:52:14 +0200553#define blk_bidi_rq(rq) ((rq)->next_rq != NULL)
Kiyoshi Ueda336cdb42007-12-11 17:40:30 -0500554/* rq->queuelist of dequeued request must be list_empty() */
555#define blk_queued_rq(rq) (!list_empty(&(rq)->queuelist))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700556
557#define list_entry_rq(ptr) list_entry((ptr), struct request, queuelist)
558
Jens Axboe4aff5e22006-08-10 08:44:47 +0200559#define rq_data_dir(rq) ((rq)->cmd_flags & 1)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700560
Martin K. Petersene692cb62010-12-01 19:41:49 +0100561static inline unsigned int blk_queue_cluster(struct request_queue *q)
562{
563 return q->limits.cluster;
564}
565
Jens Axboe9e2585a2006-07-28 09:26:13 +0200566/*
Jens Axboe1faa16d2009-04-06 14:48:01 +0200567 * We regard a request as sync, if either a read or a sync write
Jens Axboe9e2585a2006-07-28 09:26:13 +0200568 */
Jens Axboe1faa16d2009-04-06 14:48:01 +0200569static inline bool rw_is_sync(unsigned int rw_flags)
570{
Christoph Hellwig7b6d91d2010-08-07 18:20:39 +0200571 return !(rw_flags & REQ_WRITE) || (rw_flags & REQ_SYNC);
Jens Axboe1faa16d2009-04-06 14:48:01 +0200572}
573
574static inline bool rq_is_sync(struct request *rq)
575{
576 return rw_is_sync(rq->cmd_flags);
577}
578
Tejun Heo5b788ce2012-06-04 20:40:59 -0700579static inline bool blk_rl_full(struct request_list *rl, bool sync)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700580{
Tejun Heo5b788ce2012-06-04 20:40:59 -0700581 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
582
583 return rl->flags & flag;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700584}
585
Tejun Heo5b788ce2012-06-04 20:40:59 -0700586static inline void blk_set_rl_full(struct request_list *rl, bool sync)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700587{
Tejun Heo5b788ce2012-06-04 20:40:59 -0700588 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
589
590 rl->flags |= flag;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700591}
592
Tejun Heo5b788ce2012-06-04 20:40:59 -0700593static inline void blk_clear_rl_full(struct request_list *rl, bool sync)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700594{
Tejun Heo5b788ce2012-06-04 20:40:59 -0700595 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
596
597 rl->flags &= ~flag;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700598}
599
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400600static inline bool rq_mergeable(struct request *rq)
601{
602 if (rq->cmd_type != REQ_TYPE_FS)
603 return false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700604
Martin K. Petersene2a60da2012-09-18 12:19:25 -0400605 if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
606 return false;
607
608 return true;
609}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700610
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400611static inline bool blk_check_merge_flags(unsigned int flags1,
612 unsigned int flags2)
613{
614 if ((flags1 & REQ_DISCARD) != (flags2 & REQ_DISCARD))
615 return false;
616
617 if ((flags1 & REQ_SECURE) != (flags2 & REQ_SECURE))
618 return false;
619
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400620 if ((flags1 & REQ_WRITE_SAME) != (flags2 & REQ_WRITE_SAME))
621 return false;
622
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400623 return true;
624}
625
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400626static inline bool blk_write_same_mergeable(struct bio *a, struct bio *b)
627{
628 if (bio_data(a) == bio_data(b))
629 return true;
630
631 return false;
632}
633
Linus Torvalds1da177e2005-04-16 15:20:36 -0700634/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700635 * q->prep_rq_fn return values
636 */
637#define BLKPREP_OK 0 /* serve it */
638#define BLKPREP_KILL 1 /* fatal error, kill */
639#define BLKPREP_DEFER 2 /* leave on queue */
640
641extern unsigned long blk_max_low_pfn, blk_max_pfn;
642
643/*
644 * standard bounce addresses:
645 *
646 * BLK_BOUNCE_HIGH : bounce all highmem pages
647 * BLK_BOUNCE_ANY : don't bounce anything
648 * BLK_BOUNCE_ISA : bounce pages above ISA DMA boundary
649 */
Andi Kleen24728922008-04-21 09:51:05 +0200650
651#if BITS_PER_LONG == 32
Linus Torvalds1da177e2005-04-16 15:20:36 -0700652#define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
Andi Kleen24728922008-04-21 09:51:05 +0200653#else
654#define BLK_BOUNCE_HIGH -1ULL
655#endif
656#define BLK_BOUNCE_ANY (-1ULL)
FUJITA Tomonoribfe17232010-05-31 15:59:03 +0900657#define BLK_BOUNCE_ISA (DMA_BIT_MASK(24))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700658
Jens Axboe3d6392c2007-07-09 12:38:05 +0200659/*
660 * default timeout for SG_IO if none specified
661 */
662#define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
Linus Torvaldsf2f1fa72008-12-05 14:49:18 -0800663#define BLK_MIN_SG_TIMEOUT (7 * HZ)
Jens Axboe3d6392c2007-07-09 12:38:05 +0200664
Christoph Lameter2a7326b2007-07-17 04:03:37 -0700665#ifdef CONFIG_BOUNCE
Linus Torvalds1da177e2005-04-16 15:20:36 -0700666extern int init_emergency_isa_pool(void);
Jens Axboe165125e2007-07-24 09:28:11 +0200667extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700668#else
669static inline int init_emergency_isa_pool(void)
670{
671 return 0;
672}
Jens Axboe165125e2007-07-24 09:28:11 +0200673static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700674{
675}
676#endif /* CONFIG_MMU */
677
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900678struct rq_map_data {
679 struct page **pages;
680 int page_order;
681 int nr_entries;
FUJITA Tomonori56c451f2008-12-18 14:49:37 +0900682 unsigned long offset;
FUJITA Tomonori97ae77a2008-12-18 14:49:38 +0900683 int null_mapped;
FUJITA Tomonoriecb554a2009-07-09 14:46:53 +0200684 int from_user;
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900685};
686
NeilBrown5705f702007-09-25 12:35:59 +0200687struct req_iterator {
688 int i;
689 struct bio *bio;
690};
691
692/* This should not be used directly - use rq_for_each_segment */
Jens Axboe1e428072009-02-23 09:03:10 +0100693#define for_each_bio(_bio) \
694 for (; _bio; _bio = _bio->bi_next)
NeilBrown5705f702007-09-25 12:35:59 +0200695#define __rq_for_each_bio(_bio, rq) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700696 if ((rq->bio)) \
697 for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
698
NeilBrown5705f702007-09-25 12:35:59 +0200699#define rq_for_each_segment(bvl, _rq, _iter) \
700 __rq_for_each_bio(_iter.bio, _rq) \
701 bio_for_each_segment(bvl, _iter.bio, _iter.i)
702
703#define rq_iter_last(rq, _iter) \
704 (_iter.bio->bi_next == NULL && _iter.i == _iter.bio->bi_vcnt-1)
705
Ilya Loginov2d4dc892009-11-26 09:16:19 +0100706#ifndef ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
707# error "You should define ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE for your platform"
708#endif
709#if ARCH_IMPLEMENTS_FLUSH_DCACHE_PAGE
710extern void rq_flush_dcache_pages(struct request *rq);
711#else
712static inline void rq_flush_dcache_pages(struct request *rq)
713{
714}
715#endif
716
Linus Torvalds1da177e2005-04-16 15:20:36 -0700717extern int blk_register_queue(struct gendisk *disk);
718extern void blk_unregister_queue(struct gendisk *disk);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700719extern void generic_make_request(struct bio *bio);
FUJITA Tomonori2a4aa302008-04-29 09:54:36 +0200720extern void blk_rq_init(struct request_queue *q, struct request *rq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700721extern void blk_put_request(struct request *);
Jens Axboe165125e2007-07-24 09:28:11 +0200722extern void __blk_put_request(struct request_queue *, struct request *);
Jens Axboe165125e2007-07-24 09:28:11 +0200723extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
Boaz Harrosh79eb63e2009-05-17 18:57:15 +0300724extern struct request *blk_make_request(struct request_queue *, struct bio *,
725 gfp_t);
Jens Axboe165125e2007-07-24 09:28:11 +0200726extern void blk_requeue_request(struct request_queue *, struct request *);
Christoph Hellwig66ac0282010-06-18 16:59:42 +0200727extern void blk_add_request_payload(struct request *rq, struct page *page,
728 unsigned int len);
Kiyoshi Ueda82124d62008-09-18 10:45:38 -0400729extern int blk_rq_check_limits(struct request_queue *q, struct request *rq);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200730extern int blk_lld_busy(struct request_queue *q);
Kiyoshi Uedab0fd2712009-06-11 13:10:16 +0200731extern int blk_rq_prep_clone(struct request *rq, struct request *rq_src,
732 struct bio_set *bs, gfp_t gfp_mask,
733 int (*bio_ctr)(struct bio *, struct bio *, void *),
734 void *data);
735extern void blk_rq_unprep_clone(struct request *rq);
Kiyoshi Ueda82124d62008-09-18 10:45:38 -0400736extern int blk_insert_cloned_request(struct request_queue *q,
737 struct request *rq);
Jens Axboe3cca6dc2011-03-02 11:08:00 -0500738extern void blk_delay_queue(struct request_queue *, unsigned long);
Jens Axboe165125e2007-07-24 09:28:11 +0200739extern void blk_recount_segments(struct request_queue *, struct bio *);
Paolo Bonzini0bfc96c2012-01-12 16:01:28 +0100740extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
Paolo Bonzini577ebb32012-01-12 16:01:27 +0100741extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
742 unsigned int, void __user *);
Al Viro74f3c8a2007-08-27 15:38:10 -0400743extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
744 unsigned int, void __user *);
Al Viroe915e872008-09-02 17:16:41 -0400745extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
746 struct scsi_ioctl_command __user *);
Andrew Morton3fcfab12006-10-19 23:28:16 -0700747
Christoph Hellwig5a7bbad2011-09-12 12:12:01 +0200748extern void blk_queue_bio(struct request_queue *q, struct bio *bio);
Christoph Hellwig166e1f92011-09-12 12:08:27 +0200749
Andrew Morton3fcfab12006-10-19 23:28:16 -0700750/*
751 * A queue has just exitted congestion. Note this in the global counter of
752 * congested queues, and wake up anyone who was waiting for requests to be
753 * put back.
754 */
Jens Axboe8aa7e842009-07-09 14:52:32 +0200755static inline void blk_clear_queue_congested(struct request_queue *q, int sync)
Andrew Morton3fcfab12006-10-19 23:28:16 -0700756{
Jens Axboe8aa7e842009-07-09 14:52:32 +0200757 clear_bdi_congested(&q->backing_dev_info, sync);
Andrew Morton3fcfab12006-10-19 23:28:16 -0700758}
759
760/*
761 * A queue has just entered congestion. Flag that in the queue's VM-visible
762 * state flags and increment the global gounter of congested queues.
763 */
Jens Axboe8aa7e842009-07-09 14:52:32 +0200764static inline void blk_set_queue_congested(struct request_queue *q, int sync)
Andrew Morton3fcfab12006-10-19 23:28:16 -0700765{
Jens Axboe8aa7e842009-07-09 14:52:32 +0200766 set_bdi_congested(&q->backing_dev_info, sync);
Andrew Morton3fcfab12006-10-19 23:28:16 -0700767}
768
Jens Axboe165125e2007-07-24 09:28:11 +0200769extern void blk_start_queue(struct request_queue *q);
770extern void blk_stop_queue(struct request_queue *q);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700771extern void blk_sync_queue(struct request_queue *q);
Jens Axboe165125e2007-07-24 09:28:11 +0200772extern void __blk_stop_queue(struct request_queue *q);
Christoph Hellwig24ecfbe2011-04-18 11:41:33 +0200773extern void __blk_run_queue(struct request_queue *q);
Jens Axboe165125e2007-07-24 09:28:11 +0200774extern void blk_run_queue(struct request_queue *);
Jens Axboec21e6be2011-04-19 13:32:46 +0200775extern void blk_run_queue_async(struct request_queue *q);
FUJITA Tomonoria3bce902008-08-28 16:17:05 +0900776extern int blk_rq_map_user(struct request_queue *, struct request *,
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900777 struct rq_map_data *, void __user *, unsigned long,
778 gfp_t);
Jens Axboe8e5cfc42006-12-19 11:12:46 +0100779extern int blk_rq_unmap_user(struct bio *);
Jens Axboe165125e2007-07-24 09:28:11 +0200780extern int blk_rq_map_kern(struct request_queue *, struct request *, void *, unsigned int, gfp_t);
781extern int blk_rq_map_user_iov(struct request_queue *, struct request *,
FUJITA Tomonori152e2832008-08-28 16:17:06 +0900782 struct rq_map_data *, struct sg_iovec *, int,
783 unsigned int, gfp_t);
Jens Axboe165125e2007-07-24 09:28:11 +0200784extern int blk_execute_rq(struct request_queue *, struct gendisk *,
James Bottomley 994ca9a2005-06-20 14:11:09 +0200785 struct request *, int);
Jens Axboe165125e2007-07-24 09:28:11 +0200786extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
Jens Axboe15fc8582006-01-06 10:00:50 +0100787 struct request *, int, rq_end_io_fn *);
Mike Christie6e39b69e2005-11-11 05:30:24 -0600788
Jens Axboe165125e2007-07-24 09:28:11 +0200789static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700790{
791 return bdev->bd_disk->queue;
792}
793
Linus Torvalds1da177e2005-04-16 15:20:36 -0700794/*
Tejun Heo80a761f2009-07-03 17:48:17 +0900795 * blk_rq_pos() : the current sector
796 * blk_rq_bytes() : bytes left in the entire request
797 * blk_rq_cur_bytes() : bytes left in the current segment
798 * blk_rq_err_bytes() : bytes left till the next error boundary
799 * blk_rq_sectors() : sectors left in the entire request
800 * blk_rq_cur_sectors() : sectors left in the current segment
Tejun Heo5efccd12009-04-23 11:05:18 +0900801 */
Tejun Heo5b936292009-05-07 22:24:38 +0900802static inline sector_t blk_rq_pos(const struct request *rq)
803{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900804 return rq->__sector;
Tejun Heo5b936292009-05-07 22:24:38 +0900805}
806
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900807static inline unsigned int blk_rq_bytes(const struct request *rq)
808{
Tejun Heoa2dec7b2009-05-07 22:24:44 +0900809 return rq->__data_len;
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900810}
811
812static inline int blk_rq_cur_bytes(const struct request *rq)
813{
814 return rq->bio ? bio_cur_bytes(rq->bio) : 0;
815}
Tejun Heo5efccd12009-04-23 11:05:18 +0900816
Tejun Heo80a761f2009-07-03 17:48:17 +0900817extern unsigned int blk_rq_err_bytes(const struct request *rq);
818
Tejun Heo5b936292009-05-07 22:24:38 +0900819static inline unsigned int blk_rq_sectors(const struct request *rq)
820{
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900821 return blk_rq_bytes(rq) >> 9;
Tejun Heo5b936292009-05-07 22:24:38 +0900822}
823
824static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
825{
Tejun Heo2e46e8b2009-05-07 22:24:41 +0900826 return blk_rq_cur_bytes(rq) >> 9;
Tejun Heo5b936292009-05-07 22:24:38 +0900827}
828
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400829static inline unsigned int blk_queue_get_max_sectors(struct request_queue *q,
830 unsigned int cmd_flags)
831{
832 if (unlikely(cmd_flags & REQ_DISCARD))
833 return q->limits.max_discard_sectors;
834
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400835 if (unlikely(cmd_flags & REQ_WRITE_SAME))
836 return q->limits.max_write_same_sectors;
837
Martin K. Petersenf31dc1c2012-09-18 12:19:26 -0400838 return q->limits.max_sectors;
839}
840
841static inline unsigned int blk_rq_get_max_sectors(struct request *rq)
842{
843 struct request_queue *q = rq->q;
844
845 if (unlikely(rq->cmd_type == REQ_TYPE_BLOCK_PC))
846 return q->limits.max_hw_sectors;
847
848 return blk_queue_get_max_sectors(q, rq->cmd_flags);
849}
850
Tejun Heo5efccd12009-04-23 11:05:18 +0900851/*
Tejun Heo9934c8c2009-05-08 11:54:16 +0900852 * Request issue related functions.
853 */
854extern struct request *blk_peek_request(struct request_queue *q);
855extern void blk_start_request(struct request *rq);
856extern struct request *blk_fetch_request(struct request_queue *q);
857
858/*
Tejun Heo2e60e022009-04-23 11:05:18 +0900859 * Request completion related functions.
860 *
861 * blk_update_request() completes given number of bytes and updates
862 * the request without completing it.
863 *
Tejun Heof06d9a22009-04-23 11:05:19 +0900864 * blk_end_request() and friends. __blk_end_request() must be called
865 * with the request queue spinlock acquired.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700866 *
867 * Several drivers define their own end_request and call
Kiyoshi Ueda3bcddea2007-12-11 17:52:28 -0500868 * blk_end_request() for parts of the original function.
869 * This prevents code duplication in drivers.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700870 */
Tejun Heo2e60e022009-04-23 11:05:18 +0900871extern bool blk_update_request(struct request *rq, int error,
872 unsigned int nr_bytes);
FUJITA Tomonorib1f74492009-05-11 17:56:09 +0900873extern bool blk_end_request(struct request *rq, int error,
874 unsigned int nr_bytes);
875extern void blk_end_request_all(struct request *rq, int error);
876extern bool blk_end_request_cur(struct request *rq, int error);
Tejun Heo80a761f2009-07-03 17:48:17 +0900877extern bool blk_end_request_err(struct request *rq, int error);
FUJITA Tomonorib1f74492009-05-11 17:56:09 +0900878extern bool __blk_end_request(struct request *rq, int error,
879 unsigned int nr_bytes);
880extern void __blk_end_request_all(struct request *rq, int error);
881extern bool __blk_end_request_cur(struct request *rq, int error);
Tejun Heo80a761f2009-07-03 17:48:17 +0900882extern bool __blk_end_request_err(struct request *rq, int error);
Tejun Heo2e60e022009-04-23 11:05:18 +0900883
Jens Axboeff856ba2006-01-09 16:02:34 +0100884extern void blk_complete_request(struct request *);
Jens Axboe242f9dc2008-09-14 05:55:09 -0700885extern void __blk_complete_request(struct request *);
886extern void blk_abort_request(struct request *);
James Bottomley28018c22010-07-01 19:49:17 +0900887extern void blk_unprep_request(struct request *);
Jens Axboeff856ba2006-01-09 16:02:34 +0100888
Linus Torvalds1da177e2005-04-16 15:20:36 -0700889/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700890 * Access functions for manipulating queue properties
891 */
Jens Axboe165125e2007-07-24 09:28:11 +0200892extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
Christoph Lameter19460892005-06-23 00:08:19 -0700893 spinlock_t *lock, int node_id);
Jens Axboe165125e2007-07-24 09:28:11 +0200894extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
Mike Snitzer01effb02010-05-11 08:57:42 +0200895extern struct request_queue *blk_init_allocated_queue(struct request_queue *,
896 request_fn_proc *, spinlock_t *);
Jens Axboe165125e2007-07-24 09:28:11 +0200897extern void blk_cleanup_queue(struct request_queue *);
898extern void blk_queue_make_request(struct request_queue *, make_request_fn *);
899extern void blk_queue_bounce_limit(struct request_queue *, u64);
Mike Snitzer72d4cd92010-12-17 08:34:20 +0100900extern void blk_limits_max_hw_sectors(struct queue_limits *, unsigned int);
Martin K. Petersen086fa5f2010-02-26 00:20:38 -0500901extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
Martin K. Petersen8a783622010-02-26 00:20:39 -0500902extern void blk_queue_max_segments(struct request_queue *, unsigned short);
Jens Axboe165125e2007-07-24 09:28:11 +0200903extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
Christoph Hellwig67efc922009-09-30 13:54:20 +0200904extern void blk_queue_max_discard_sectors(struct request_queue *q,
905 unsigned int max_discard_sectors);
Martin K. Petersen4363ac72012-09-18 12:19:27 -0400906extern void blk_queue_max_write_same_sectors(struct request_queue *q,
907 unsigned int max_write_same_sectors);
Martin K. Petersene1defc42009-05-22 17:17:49 -0400908extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
Martin K. Petersen892b6f92010-10-13 21:18:03 +0200909extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400910extern void blk_queue_alignment_offset(struct request_queue *q,
911 unsigned int alignment);
Martin K. Petersen7c958e32009-07-31 11:49:11 -0400912extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400913extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
Martin K. Petersen3c5820c2009-09-11 21:54:52 +0200914extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400915extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
Martin K. Petersene475bba2009-06-16 08:23:52 +0200916extern void blk_set_default_limits(struct queue_limits *lim);
Martin K. Petersenb1bd0552012-01-11 16:27:11 +0100917extern void blk_set_stacking_limits(struct queue_limits *lim);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400918extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
919 sector_t offset);
Martin K. Petersen17be8c22010-01-11 03:21:49 -0500920extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
921 sector_t offset);
Martin K. Petersenc72758f2009-05-22 17:17:53 -0400922extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
923 sector_t offset);
Jens Axboe165125e2007-07-24 09:28:11 +0200924extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
Tejun Heoe3790c72008-03-04 11:18:17 +0100925extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
FUJITA Tomonori27f82212008-07-04 09:30:03 +0200926extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
Tejun Heo2fb98e82008-02-19 11:36:53 +0100927extern int blk_queue_dma_drain(struct request_queue *q,
928 dma_drain_needed_fn *dma_drain_needed,
929 void *buf, unsigned int size);
Kiyoshi Uedaef9e3fa2008-10-01 16:12:15 +0200930extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
Jens Axboe165125e2007-07-24 09:28:11 +0200931extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
932extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
James Bottomley28018c22010-07-01 19:49:17 +0900933extern void blk_queue_unprep_rq(struct request_queue *, unprep_rq_fn *ufn);
Jens Axboe165125e2007-07-24 09:28:11 +0200934extern void blk_queue_merge_bvec(struct request_queue *, merge_bvec_fn *);
935extern void blk_queue_dma_alignment(struct request_queue *, int);
James Bottomley11c3e682007-12-31 16:37:00 -0600936extern void blk_queue_update_dma_alignment(struct request_queue *, int);
Jens Axboe165125e2007-07-24 09:28:11 +0200937extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
Jens Axboe242f9dc2008-09-14 05:55:09 -0700938extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
939extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
Tejun Heo4913efe2010-09-03 11:56:16 +0200940extern void blk_queue_flush(struct request_queue *q, unsigned int flush);
shaohua.li@intel.comf3876932011-05-06 11:34:32 -0600941extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700942extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700943
Jens Axboe165125e2007-07-24 09:28:11 +0200944extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
Asias He85b9f662012-08-02 23:42:04 +0200945extern int blk_bio_map_sg(struct request_queue *q, struct bio *bio,
946 struct scatterlist *sglist);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700947extern void blk_dump_rq_flags(struct request *, char *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700948extern long nr_blockdev_pages(void);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700949
Tejun Heo09ac46c2011-12-14 00:33:38 +0100950bool __must_check blk_get_queue(struct request_queue *);
Jens Axboe165125e2007-07-24 09:28:11 +0200951struct request_queue *blk_alloc_queue(gfp_t);
952struct request_queue *blk_alloc_queue_node(gfp_t, int);
953extern void blk_put_queue(struct request_queue *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700954
Shaohua Li316cc672011-07-08 08:19:21 +0200955/*
Suresh Jayaraman75df7132011-09-21 10:00:16 +0200956 * blk_plug permits building a queue of related requests by holding the I/O
957 * fragments for a short period. This allows merging of sequential requests
958 * into single larger request. As the requests are moved from a per-task list to
959 * the device's request_queue in a batch, this results in improved scalability
960 * as the lock contention for request_queue lock is reduced.
961 *
962 * It is ok not to disable preemption when adding the request to the plug list
963 * or when attempting a merge, because blk_schedule_flush_list() will only flush
964 * the plug list when the task sleeps by itself. For details, please see
965 * schedule() where blk_schedule_flush_plug() is called.
Shaohua Li316cc672011-07-08 08:19:21 +0200966 */
Jens Axboe73c10102011-03-08 13:19:51 +0100967struct blk_plug {
Suresh Jayaraman75df7132011-09-21 10:00:16 +0200968 unsigned long magic; /* detect uninitialized use-cases */
969 struct list_head list; /* requests */
970 struct list_head cb_list; /* md requires an unplug callback */
971 unsigned int should_sort; /* list to be sorted before flushing? */
Jens Axboe73c10102011-03-08 13:19:51 +0100972};
Shaohua Li55c022b2011-07-08 08:19:20 +0200973#define BLK_MAX_REQUEST_COUNT 16
974
NeilBrown9cbb1752012-07-31 09:08:14 +0200975struct blk_plug_cb;
NeilBrown74018dc2012-07-31 09:08:15 +0200976typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
NeilBrown048c9372011-04-18 09:52:22 +0200977struct blk_plug_cb {
978 struct list_head list;
NeilBrown9cbb1752012-07-31 09:08:14 +0200979 blk_plug_cb_fn callback;
980 void *data;
NeilBrown048c9372011-04-18 09:52:22 +0200981};
NeilBrown9cbb1752012-07-31 09:08:14 +0200982extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
983 void *data, int size);
Jens Axboe73c10102011-03-08 13:19:51 +0100984extern void blk_start_plug(struct blk_plug *);
985extern void blk_finish_plug(struct blk_plug *);
Jens Axboef6603782011-04-15 15:49:07 +0200986extern void blk_flush_plug_list(struct blk_plug *, bool);
Jens Axboe73c10102011-03-08 13:19:51 +0100987
988static inline void blk_flush_plug(struct task_struct *tsk)
989{
990 struct blk_plug *plug = tsk->plug;
991
Christoph Hellwig88b996c2011-04-15 15:20:10 +0200992 if (plug)
Jens Axboea237c1c2011-04-16 13:27:55 +0200993 blk_flush_plug_list(plug, false);
994}
995
996static inline void blk_schedule_flush_plug(struct task_struct *tsk)
997{
998 struct blk_plug *plug = tsk->plug;
999
1000 if (plug)
Jens Axboef6603782011-04-15 15:49:07 +02001001 blk_flush_plug_list(plug, true);
Jens Axboe73c10102011-03-08 13:19:51 +01001002}
1003
1004static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1005{
1006 struct blk_plug *plug = tsk->plug;
1007
NeilBrown048c9372011-04-18 09:52:22 +02001008 return plug && (!list_empty(&plug->list) || !list_empty(&plug->cb_list));
Jens Axboe73c10102011-03-08 13:19:51 +01001009}
1010
Linus Torvalds1da177e2005-04-16 15:20:36 -07001011/*
1012 * tag stuff
1013 */
Jens Axboe4aff5e22006-08-10 08:44:47 +02001014#define blk_rq_tagged(rq) ((rq)->cmd_flags & REQ_QUEUED)
Jens Axboe165125e2007-07-24 09:28:11 +02001015extern int blk_queue_start_tag(struct request_queue *, struct request *);
1016extern struct request *blk_queue_find_tag(struct request_queue *, int);
1017extern void blk_queue_end_tag(struct request_queue *, struct request *);
1018extern int blk_queue_init_tags(struct request_queue *, int, struct blk_queue_tag *);
1019extern void blk_queue_free_tags(struct request_queue *);
1020extern int blk_queue_resize_tags(struct request_queue *, int);
1021extern void blk_queue_invalidate_tags(struct request_queue *);
James Bottomley492dfb42006-08-30 15:48:45 -04001022extern struct blk_queue_tag *blk_init_tags(int);
1023extern void blk_free_tags(struct blk_queue_tag *);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001024
David C Somayajuluf583f492006-10-04 08:27:25 +02001025static inline struct request *blk_map_queue_find_tag(struct blk_queue_tag *bqt,
1026 int tag)
1027{
1028 if (unlikely(bqt == NULL || tag >= bqt->real_max_depth))
1029 return NULL;
1030 return bqt->tag_index[tag];
1031}
Christoph Hellwigdd3932e2010-09-16 20:51:46 +02001032
1033#define BLKDEV_DISCARD_SECURE 0x01 /* secure discard */
1034
1035extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
Dmitry Monakhovfbd9b092010-04-28 17:55:06 +04001036extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1037 sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001038extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
1039 sector_t nr_sects, gfp_t gfp_mask, struct page *page);
Dmitry Monakhov3f14d792010-04-28 17:55:09 +04001040extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
Christoph Hellwigdd3932e2010-09-16 20:51:46 +02001041 sector_t nr_sects, gfp_t gfp_mask);
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001042static inline int sb_issue_discard(struct super_block *sb, sector_t block,
1043 sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
David Woodhousefb2dce82008-08-05 18:01:53 +01001044{
Christoph Hellwig2cf6d262010-08-18 05:29:10 -04001045 return blkdev_issue_discard(sb->s_bdev, block << (sb->s_blocksize_bits - 9),
1046 nr_blocks << (sb->s_blocksize_bits - 9),
1047 gfp_mask, flags);
David Woodhousefb2dce82008-08-05 18:01:53 +01001048}
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001049static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
Theodore Ts'oa107e5a2010-10-27 23:44:47 -04001050 sector_t nr_blocks, gfp_t gfp_mask)
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001051{
1052 return blkdev_issue_zeroout(sb->s_bdev,
1053 block << (sb->s_blocksize_bits - 9),
1054 nr_blocks << (sb->s_blocksize_bits - 9),
Theodore Ts'oa107e5a2010-10-27 23:44:47 -04001055 gfp_mask);
Lukas Czernere6fa0be2010-10-27 21:30:04 -04001056}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001057
Jens Axboe018e0442009-06-26 16:27:10 +02001058extern int blk_verify_command(unsigned char *cmd, fmode_t has_write_perm);
Adel Gadllah0b07de82008-06-26 13:48:27 +02001059
Martin K. Peterseneb28d312010-02-26 00:20:37 -05001060enum blk_default_limits {
1061 BLK_MAX_SEGMENTS = 128,
1062 BLK_SAFE_MAX_SECTORS = 255,
1063 BLK_DEF_MAX_SECTORS = 1024,
1064 BLK_MAX_SEGMENT_SIZE = 65536,
1065 BLK_SEG_BOUNDARY_MASK = 0xFFFFFFFFUL,
1066};
Milan Broz0e435ac2008-12-03 12:55:08 +01001067
Linus Torvalds1da177e2005-04-16 15:20:36 -07001068#define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
1069
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001070static inline unsigned long queue_bounce_pfn(struct request_queue *q)
1071{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001072 return q->limits.bounce_pfn;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001073}
1074
1075static inline unsigned long queue_segment_boundary(struct request_queue *q)
1076{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001077 return q->limits.seg_boundary_mask;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001078}
1079
1080static inline unsigned int queue_max_sectors(struct request_queue *q)
1081{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001082 return q->limits.max_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001083}
1084
1085static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1086{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001087 return q->limits.max_hw_sectors;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001088}
1089
Martin K. Petersen8a783622010-02-26 00:20:39 -05001090static inline unsigned short queue_max_segments(struct request_queue *q)
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001091{
Martin K. Petersen8a783622010-02-26 00:20:39 -05001092 return q->limits.max_segments;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001093}
1094
1095static inline unsigned int queue_max_segment_size(struct request_queue *q)
1096{
Martin K. Petersen025146e2009-05-22 17:17:51 -04001097 return q->limits.max_segment_size;
Martin K. Petersenae03bf62009-05-22 17:17:50 -04001098}
1099
Martin K. Petersene1defc42009-05-22 17:17:49 -04001100static inline unsigned short queue_logical_block_size(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001101{
1102 int retval = 512;
1103
Martin K. Petersen025146e2009-05-22 17:17:51 -04001104 if (q && q->limits.logical_block_size)
1105 retval = q->limits.logical_block_size;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001106
1107 return retval;
1108}
1109
Martin K. Petersene1defc42009-05-22 17:17:49 -04001110static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001111{
Martin K. Petersene1defc42009-05-22 17:17:49 -04001112 return queue_logical_block_size(bdev_get_queue(bdev));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001113}
1114
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001115static inline unsigned int queue_physical_block_size(struct request_queue *q)
1116{
1117 return q->limits.physical_block_size;
1118}
1119
Martin K. Petersen892b6f92010-10-13 21:18:03 +02001120static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
Martin K. Petersenac481c22009-10-03 20:52:01 +02001121{
1122 return queue_physical_block_size(bdev_get_queue(bdev));
1123}
1124
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001125static inline unsigned int queue_io_min(struct request_queue *q)
1126{
1127 return q->limits.io_min;
1128}
1129
Martin K. Petersenac481c22009-10-03 20:52:01 +02001130static inline int bdev_io_min(struct block_device *bdev)
1131{
1132 return queue_io_min(bdev_get_queue(bdev));
1133}
1134
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001135static inline unsigned int queue_io_opt(struct request_queue *q)
1136{
1137 return q->limits.io_opt;
1138}
1139
Martin K. Petersenac481c22009-10-03 20:52:01 +02001140static inline int bdev_io_opt(struct block_device *bdev)
1141{
1142 return queue_io_opt(bdev_get_queue(bdev));
1143}
1144
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001145static inline int queue_alignment_offset(struct request_queue *q)
1146{
Martin K. Petersenac481c22009-10-03 20:52:01 +02001147 if (q->limits.misaligned)
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001148 return -1;
1149
Martin K. Petersenac481c22009-10-03 20:52:01 +02001150 return q->limits.alignment_offset;
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001151}
1152
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001153static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001154{
1155 unsigned int granularity = max(lim->physical_block_size, lim->io_min);
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001156 unsigned int alignment = (sector << 9) & (granularity - 1);
Martin K. Petersen81744ee2009-12-29 08:35:35 +01001157
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001158 return (granularity + lim->alignment_offset - alignment)
1159 & (granularity - 1);
Martin K. Petersenc72758f2009-05-22 17:17:53 -04001160}
1161
Martin K. Petersenac481c22009-10-03 20:52:01 +02001162static inline int bdev_alignment_offset(struct block_device *bdev)
1163{
1164 struct request_queue *q = bdev_get_queue(bdev);
1165
1166 if (q->limits.misaligned)
1167 return -1;
1168
1169 if (bdev != bdev->bd_contains)
1170 return bdev->bd_part->alignment_offset;
1171
1172 return q->limits.alignment_offset;
1173}
1174
Martin K. Petersen86b37282009-11-10 11:50:21 +01001175static inline int queue_discard_alignment(struct request_queue *q)
1176{
1177 if (q->limits.discard_misaligned)
1178 return -1;
1179
1180 return q->limits.discard_alignment;
1181}
1182
Martin K. Petersene03a72e2010-01-11 03:21:51 -05001183static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
Martin K. Petersen86b37282009-11-10 11:50:21 +01001184{
Martin K. Petersendd3d1452010-01-11 03:21:48 -05001185 unsigned int alignment = (sector << 9) & (lim->discard_granularity - 1);
1186
Martin K. Petersena934a002011-05-18 10:37:35 +02001187 if (!lim->max_discard_sectors)
1188 return 0;
1189
Martin K. Petersendd3d1452010-01-11 03:21:48 -05001190 return (lim->discard_granularity + lim->discard_alignment - alignment)
1191 & (lim->discard_granularity - 1);
Martin K. Petersen86b37282009-11-10 11:50:21 +01001192}
1193
Paolo Bonzinic6e66632012-08-02 09:48:50 +02001194static inline int bdev_discard_alignment(struct block_device *bdev)
1195{
1196 struct request_queue *q = bdev_get_queue(bdev);
1197
1198 if (bdev != bdev->bd_contains)
1199 return bdev->bd_part->discard_alignment;
1200
1201 return q->limits.discard_alignment;
1202}
1203
Martin K. Petersen98262f22009-12-03 09:24:48 +01001204static inline unsigned int queue_discard_zeroes_data(struct request_queue *q)
1205{
Martin K. Petersena934a002011-05-18 10:37:35 +02001206 if (q->limits.max_discard_sectors && q->limits.discard_zeroes_data == 1)
Martin K. Petersen98262f22009-12-03 09:24:48 +01001207 return 1;
1208
1209 return 0;
1210}
1211
1212static inline unsigned int bdev_discard_zeroes_data(struct block_device *bdev)
1213{
1214 return queue_discard_zeroes_data(bdev_get_queue(bdev));
1215}
1216
Martin K. Petersen4363ac72012-09-18 12:19:27 -04001217static inline unsigned int bdev_write_same(struct block_device *bdev)
1218{
1219 struct request_queue *q = bdev_get_queue(bdev);
1220
1221 if (q)
1222 return q->limits.max_write_same_sectors;
1223
1224 return 0;
1225}
1226
Jens Axboe165125e2007-07-24 09:28:11 +02001227static inline int queue_dma_alignment(struct request_queue *q)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001228{
Pete Wyckoff482eb682008-01-01 10:23:02 -05001229 return q ? q->dma_alignment : 511;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001230}
1231
Namhyung Kim14417792010-09-15 13:08:27 +02001232static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
FUJITA Tomonori87904072008-08-28 15:05:58 +09001233 unsigned int len)
1234{
1235 unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
Namhyung Kim14417792010-09-15 13:08:27 +02001236 return !(addr & alignment) && !(len & alignment);
FUJITA Tomonori87904072008-08-28 15:05:58 +09001237}
1238
Linus Torvalds1da177e2005-04-16 15:20:36 -07001239/* assumes size > 256 */
1240static inline unsigned int blksize_bits(unsigned int size)
1241{
1242 unsigned int bits = 8;
1243 do {
1244 bits++;
1245 size >>= 1;
1246 } while (size > 256);
1247 return bits;
1248}
1249
Adrian Bunk2befb9e2005-09-10 00:27:17 -07001250static inline unsigned int block_size(struct block_device *bdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001251{
1252 return bdev->bd_block_size;
1253}
1254
shaohua.li@intel.comf3876932011-05-06 11:34:32 -06001255static inline bool queue_flush_queueable(struct request_queue *q)
1256{
1257 return !q->flush_not_queueable;
1258}
1259
Linus Torvalds1da177e2005-04-16 15:20:36 -07001260typedef struct {struct page *v;} Sector;
1261
1262unsigned char *read_dev_sector(struct block_device *, sector_t, Sector *);
1263
1264static inline void put_dev_sector(Sector p)
1265{
1266 page_cache_release(p.v);
1267}
1268
1269struct work_struct;
Jens Axboe18887ad2008-07-28 13:08:45 +02001270int kblockd_schedule_work(struct request_queue *q, struct work_struct *work);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001271
Divyesh Shah91952912010-04-01 15:01:41 -07001272#ifdef CONFIG_BLK_CGROUP
Jens Axboe28f41972010-06-01 12:23:18 +02001273/*
1274 * This should not be using sched_clock(). A real patch is in progress
1275 * to fix this up, until that is in place we need to disable preemption
1276 * around sched_clock() in this function and set_io_start_time_ns().
1277 */
Divyesh Shah91952912010-04-01 15:01:41 -07001278static inline void set_start_time_ns(struct request *req)
1279{
Jens Axboe28f41972010-06-01 12:23:18 +02001280 preempt_disable();
Divyesh Shah91952912010-04-01 15:01:41 -07001281 req->start_time_ns = sched_clock();
Jens Axboe28f41972010-06-01 12:23:18 +02001282 preempt_enable();
Divyesh Shah91952912010-04-01 15:01:41 -07001283}
1284
1285static inline void set_io_start_time_ns(struct request *req)
1286{
Jens Axboe28f41972010-06-01 12:23:18 +02001287 preempt_disable();
Divyesh Shah91952912010-04-01 15:01:41 -07001288 req->io_start_time_ns = sched_clock();
Jens Axboe28f41972010-06-01 12:23:18 +02001289 preempt_enable();
Divyesh Shah91952912010-04-01 15:01:41 -07001290}
Divyesh Shah84c124d2010-04-09 08:31:19 +02001291
1292static inline uint64_t rq_start_time_ns(struct request *req)
1293{
1294 return req->start_time_ns;
1295}
1296
1297static inline uint64_t rq_io_start_time_ns(struct request *req)
1298{
1299 return req->io_start_time_ns;
1300}
Divyesh Shah91952912010-04-01 15:01:41 -07001301#else
1302static inline void set_start_time_ns(struct request *req) {}
1303static inline void set_io_start_time_ns(struct request *req) {}
Divyesh Shah84c124d2010-04-09 08:31:19 +02001304static inline uint64_t rq_start_time_ns(struct request *req)
1305{
1306 return 0;
1307}
1308static inline uint64_t rq_io_start_time_ns(struct request *req)
1309{
1310 return 0;
1311}
Divyesh Shah91952912010-04-01 15:01:41 -07001312#endif
1313
Linus Torvalds1da177e2005-04-16 15:20:36 -07001314#define MODULE_ALIAS_BLOCKDEV(major,minor) \
1315 MODULE_ALIAS("block-major-" __stringify(major) "-" __stringify(minor))
1316#define MODULE_ALIAS_BLOCKDEV_MAJOR(major) \
1317 MODULE_ALIAS("block-major-" __stringify(major) "-*")
1318
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001319#if defined(CONFIG_BLK_DEV_INTEGRITY)
1320
Jens Axboeb24498d2008-06-27 09:12:09 +02001321#define INTEGRITY_FLAG_READ 2 /* verify data integrity on read */
1322#define INTEGRITY_FLAG_WRITE 4 /* generate data integrity on write */
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001323
1324struct blk_integrity_exchg {
1325 void *prot_buf;
1326 void *data_buf;
1327 sector_t sector;
1328 unsigned int data_size;
1329 unsigned short sector_size;
1330 const char *disk_name;
1331};
1332
1333typedef void (integrity_gen_fn) (struct blk_integrity_exchg *);
1334typedef int (integrity_vrfy_fn) (struct blk_integrity_exchg *);
1335typedef void (integrity_set_tag_fn) (void *, void *, unsigned int);
1336typedef void (integrity_get_tag_fn) (void *, void *, unsigned int);
1337
1338struct blk_integrity {
1339 integrity_gen_fn *generate_fn;
1340 integrity_vrfy_fn *verify_fn;
1341 integrity_set_tag_fn *set_tag_fn;
1342 integrity_get_tag_fn *get_tag_fn;
1343
1344 unsigned short flags;
1345 unsigned short tuple_size;
1346 unsigned short sector_size;
1347 unsigned short tag_size;
1348
1349 const char *name;
1350
1351 struct kobject kobj;
1352};
1353
Mike Snitzera63a5cf2011-04-01 21:02:31 +02001354extern bool blk_integrity_is_initialized(struct gendisk *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001355extern int blk_integrity_register(struct gendisk *, struct blk_integrity *);
1356extern void blk_integrity_unregister(struct gendisk *);
Martin K. Petersenad7fce92008-10-01 03:38:39 -04001357extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001358extern int blk_rq_map_integrity_sg(struct request_queue *, struct bio *,
1359 struct scatterlist *);
1360extern int blk_rq_count_integrity_sg(struct request_queue *, struct bio *);
1361extern int blk_integrity_merge_rq(struct request_queue *, struct request *,
1362 struct request *);
1363extern int blk_integrity_merge_bio(struct request_queue *, struct request *,
1364 struct bio *);
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001365
Jens Axboeb04accc2008-10-02 12:53:22 +02001366static inline
1367struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1368{
1369 return bdev->bd_disk->integrity;
1370}
1371
Martin K. Petersenb02739b2008-10-02 18:47:49 +02001372static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1373{
1374 return disk->integrity;
1375}
1376
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001377static inline int blk_integrity_rq(struct request *rq)
1378{
Martin K. Petersend442cc42008-07-16 16:09:06 -04001379 if (rq->bio == NULL)
1380 return 0;
1381
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001382 return bio_integrity(rq->bio);
1383}
1384
Martin K. Petersen13f05c82010-09-10 20:50:10 +02001385static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1386 unsigned int segs)
1387{
1388 q->limits.max_integrity_segments = segs;
1389}
1390
1391static inline unsigned short
1392queue_max_integrity_segments(struct request_queue *q)
1393{
1394 return q->limits.max_integrity_segments;
1395}
1396
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001397#else /* CONFIG_BLK_DEV_INTEGRITY */
1398
Stephen Rothwellfd832402012-01-12 09:17:30 +01001399struct bio;
1400struct block_device;
1401struct gendisk;
1402struct blk_integrity;
1403
1404static inline int blk_integrity_rq(struct request *rq)
1405{
1406 return 0;
1407}
1408static inline int blk_rq_count_integrity_sg(struct request_queue *q,
1409 struct bio *b)
1410{
1411 return 0;
1412}
1413static inline int blk_rq_map_integrity_sg(struct request_queue *q,
1414 struct bio *b,
1415 struct scatterlist *s)
1416{
1417 return 0;
1418}
1419static inline struct blk_integrity *bdev_get_integrity(struct block_device *b)
1420{
1421 return 0;
1422}
1423static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1424{
1425 return NULL;
1426}
1427static inline int blk_integrity_compare(struct gendisk *a, struct gendisk *b)
1428{
1429 return 0;
1430}
1431static inline int blk_integrity_register(struct gendisk *d,
1432 struct blk_integrity *b)
1433{
1434 return 0;
1435}
1436static inline void blk_integrity_unregister(struct gendisk *d)
1437{
1438}
1439static inline void blk_queue_max_integrity_segments(struct request_queue *q,
1440 unsigned int segs)
1441{
1442}
1443static inline unsigned short queue_max_integrity_segments(struct request_queue *q)
1444{
1445 return 0;
1446}
1447static inline int blk_integrity_merge_rq(struct request_queue *rq,
1448 struct request *r1,
1449 struct request *r2)
1450{
1451 return 0;
1452}
1453static inline int blk_integrity_merge_bio(struct request_queue *rq,
1454 struct request *r,
1455 struct bio *b)
1456{
1457 return 0;
1458}
1459static inline bool blk_integrity_is_initialized(struct gendisk *g)
1460{
1461 return 0;
1462}
Martin K. Petersen7ba1ba12008-06-30 20:04:41 +02001463
1464#endif /* CONFIG_BLK_DEV_INTEGRITY */
1465
Al Viro08f85852007-10-08 13:26:20 -04001466struct block_device_operations {
Al Virod4430d62008-03-02 09:09:22 -05001467 int (*open) (struct block_device *, fmode_t);
1468 int (*release) (struct gendisk *, fmode_t);
Al Virod4430d62008-03-02 09:09:22 -05001469 int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1470 int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
Al Viro08f85852007-10-08 13:26:20 -04001471 int (*direct_access) (struct block_device *, sector_t,
1472 void **, unsigned long *);
Tejun Heo77ea8872010-12-08 20:57:37 +01001473 unsigned int (*check_events) (struct gendisk *disk,
1474 unsigned int clearing);
1475 /* ->media_changed() is DEPRECATED, use ->check_events() instead */
Al Viro08f85852007-10-08 13:26:20 -04001476 int (*media_changed) (struct gendisk *);
Tejun Heoc3e33e02010-05-15 20:09:29 +02001477 void (*unlock_native_capacity) (struct gendisk *);
Al Viro08f85852007-10-08 13:26:20 -04001478 int (*revalidate_disk) (struct gendisk *);
1479 int (*getgeo)(struct block_device *, struct hd_geometry *);
Nitin Guptab3a27d02010-05-17 11:02:43 +05301480 /* this callback is with swap_lock and sometimes page table lock held */
1481 void (*swap_slot_free_notify) (struct block_device *, unsigned long);
Al Viro08f85852007-10-08 13:26:20 -04001482 struct module *owner;
1483};
1484
Al Viro633a08b2007-08-29 20:34:12 -04001485extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1486 unsigned long);
David Howells93614012006-09-30 20:45:40 +02001487#else /* CONFIG_BLOCK */
1488/*
1489 * stubs for when the block layer is configured out
1490 */
1491#define buffer_heads_over_limit 0
1492
David Howells93614012006-09-30 20:45:40 +02001493static inline long nr_blockdev_pages(void)
1494{
1495 return 0;
1496}
1497
Jens Axboe1f940bd2011-03-11 20:17:08 +01001498struct blk_plug {
1499};
1500
1501static inline void blk_start_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001502{
1503}
1504
Jens Axboe1f940bd2011-03-11 20:17:08 +01001505static inline void blk_finish_plug(struct blk_plug *plug)
Jens Axboe73c10102011-03-08 13:19:51 +01001506{
1507}
1508
Jens Axboe1f940bd2011-03-11 20:17:08 +01001509static inline void blk_flush_plug(struct task_struct *task)
Jens Axboe73c10102011-03-08 13:19:51 +01001510{
1511}
1512
Jens Axboea237c1c2011-04-16 13:27:55 +02001513static inline void blk_schedule_flush_plug(struct task_struct *task)
1514{
1515}
1516
1517
Jens Axboe73c10102011-03-08 13:19:51 +01001518static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1519{
1520 return false;
1521}
1522
David Howells93614012006-09-30 20:45:40 +02001523#endif /* CONFIG_BLOCK */
1524
Linus Torvalds1da177e2005-04-16 15:20:36 -07001525#endif