block: Avoid scheduling delayed work on a dead queue
[linux-2.6-block.git] / include / linux / blkdev.h
CommitLineData
1da177e4
LT
1#ifndef _LINUX_BLKDEV_H
2#define _LINUX_BLKDEV_H
3
85fd0bc9
RK
4#include <linux/sched.h>
5
f5ff8422
JA
6#ifdef CONFIG_BLOCK
7
1da177e4
LT
8#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>
1da177e4 18#include <linux/stringify.h>
3e6053d7 19#include <linux/gfp.h>
d351af01 20#include <linux/bsg.h>
c7c22e4d 21#include <linux/smp.h>
1da177e4
LT
22
23#include <asm/scatterlist.h>
24
de477254 25struct module;
21b2f0c8
CH
26struct scsi_ioctl_command;
27
1da177e4 28struct request_queue;
1da177e4 29struct elevator_queue;
1da177e4 30struct request_pm_state;
2056a782 31struct blk_trace;
3d6392cf
JA
32struct request;
33struct sg_io_hdr;
aa387cc8 34struct bsg_job;
3c798398 35struct blkcg_gq;
1da177e4
LT
36
37#define BLKDEV_MIN_RQ 4
38#define BLKDEV_MAX_RQ 128 /* Default maximum */
39
8bd435b3
TH
40/*
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
1da177e4 46struct request;
8ffdc655 47typedef void (rq_end_io_fn)(struct request *, int);
1da177e4 48
5b788ce3
TH
49#define BLK_RL_SYNCFULL (1U << 0)
50#define BLK_RL_ASYNCFULL (1U << 1)
51
1da177e4 52struct request_list {
5b788ce3 53 struct request_queue *q; /* the queue this rl belongs to */
a051661c
TH
54#ifdef CONFIG_BLK_CGROUP
55 struct blkcg_gq *blkg; /* blkg this request pool belongs to */
56#endif
1faa16d2
JA
57 /*
58 * count[], starved[], and wait[] are indexed by
59 * BLK_RW_SYNC/BLK_RW_ASYNC
60 */
8a5ecdd4
TH
61 int count[2];
62 int starved[2];
63 mempool_t *rq_pool;
64 wait_queue_head_t wait[2];
5b788ce3 65 unsigned int flags;
1da177e4
LT
66};
67
4aff5e23
JA
68/*
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 */
4aff5e23 78 REQ_TYPE_SPECIAL, /* driver defined type */
4aff5e23
JA
79 /*
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 */
4aff5e23 84 REQ_TYPE_ATA_TASKFILE,
cea2885a 85 REQ_TYPE_ATA_PC,
4aff5e23
JA
86};
87
1da177e4
LT
88#define BLK_MAX_CDB 16
89
90/*
63a71386 91 * try to put the fields that are referenced together in the same cacheline.
4d0d98b6 92 * if you modify this structure, be sure to check block/blk-core.c:blk_rq_init()
63a71386 93 * as well!
1da177e4
LT
94 */
95struct request {
ff856bad 96 struct list_head queuelist;
c7c22e4d 97 struct call_single_data csd;
ff856bad 98
165125e1 99 struct request_queue *q;
e6a1c874 100
4aff5e23
JA
101 unsigned int cmd_flags;
102 enum rq_cmd_type_bits cmd_type;
242f9dcb 103 unsigned long atomic_flags;
1da177e4 104
181fdde3
RK
105 int cpu;
106
a2dec7b3 107 /* the following two fields are internal, NEVER access directly */
a2dec7b3 108 unsigned int __data_len; /* total data len */
181fdde3 109 sector_t __sector; /* sector cursor */
1da177e4
LT
110
111 struct bio *bio;
112 struct bio *biotail;
113
9817064b 114 struct hlist_node hash; /* merge hash */
e6a1c874
JA
115 /*
116 * The rb_node is only used inside the io scheduler, requests
117 * are pruned when moved to the dispatch queue. So let the
c186794d 118 * completion_data share space with the rb_node.
e6a1c874
JA
119 */
120 union {
121 struct rb_node rb_node; /* sort/lookup */
c186794d 122 void *completion_data;
e6a1c874 123 };
9817064b 124
ff7d145f 125 /*
7f1dc8a2 126 * Three pointers are available for the IO schedulers, if they need
c186794d
MS
127 * more they have to dynamically allocate it. Flush requests are
128 * never put on the IO scheduler. So let the flush fields share
a612fddf 129 * space with the elevator data.
ff7d145f 130 */
c186794d 131 union {
a612fddf
TH
132 struct {
133 struct io_cq *icq;
134 void *priv[2];
135 } elv;
136
c186794d
MS
137 struct {
138 unsigned int seq;
139 struct list_head list;
4853abaa 140 rq_end_io_fn *saved_end_io;
c186794d
MS
141 } flush;
142 };
ff7d145f 143
8f34ee75 144 struct gendisk *rq_disk;
09e099d4 145 struct hd_struct *part;
1da177e4 146 unsigned long start_time;
9195291e 147#ifdef CONFIG_BLK_CGROUP
a051661c 148 struct request_list *rl; /* rl this rq is alloced from */
9195291e
DS
149 unsigned long long start_time_ns;
150 unsigned long long io_start_time_ns; /* when passed to hardware */
151#endif
1da177e4
LT
152 /* Number of scatter-gather DMA addr+len pairs after
153 * physical address coalescing is performed.
154 */
155 unsigned short nr_phys_segments;
13f05c8d
MP
156#if defined(CONFIG_BLK_DEV_INTEGRITY)
157 unsigned short nr_integrity_segments;
158#endif
1da177e4 159
8f34ee75
JA
160 unsigned short ioprio;
161
181fdde3
RK
162 int ref_count;
163
731ec497
TH
164 void *special; /* opaque pointer available for LLD use */
165 char *buffer; /* kaddr of the current segment if available */
1da177e4 166
cdd60262
JA
167 int tag;
168 int errors;
169
1da177e4
LT
170 /*
171 * when request is used as a packet command carrier
172 */
d7e3c324
FT
173 unsigned char __cmd[BLK_MAX_CDB];
174 unsigned char *cmd;
181fdde3 175 unsigned short cmd_len;
1da177e4 176
7a85f889 177 unsigned int extra_len; /* length of alignment and padding */
1da177e4 178 unsigned int sense_len;
c3a4d78c 179 unsigned int resid_len; /* residual count */
1da177e4
LT
180 void *sense;
181
242f9dcb
JA
182 unsigned long deadline;
183 struct list_head timeout_list;
1da177e4 184 unsigned int timeout;
17e01f21 185 int retries;
1da177e4 186
1da177e4 187 /*
c00895ab 188 * completion callback.
1da177e4
LT
189 */
190 rq_end_io_fn *end_io;
191 void *end_io_data;
abae1fde
FT
192
193 /* for bidi */
194 struct request *next_rq;
1da177e4
LT
195};
196
766ca442
FLVC
197static inline unsigned short req_get_ioprio(struct request *req)
198{
199 return req->ioprio;
200}
201
1da177e4 202/*
4aff5e23 203 * State information carried for REQ_TYPE_PM_SUSPEND and REQ_TYPE_PM_RESUME
1da177e4
LT
204 * 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
165125e1 217typedef void (request_fn_proc) (struct request_queue *q);
5a7bbad2 218typedef void (make_request_fn) (struct request_queue *q, struct bio *bio);
165125e1 219typedef int (prep_rq_fn) (struct request_queue *, struct request *);
28018c24 220typedef void (unprep_rq_fn) (struct request_queue *, struct request *);
1da177e4
LT
221
222struct bio_vec;
cc371e66
AK
223struct 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 *);
ff856bad 231typedef void (softirq_done_fn)(struct request *);
2fb98e84 232typedef int (dma_drain_needed_fn)(struct request *);
ef9e3fac 233typedef int (lld_busy_fn) (struct request_queue *q);
aa387cc8 234typedef int (bsg_job_fn) (struct bsg_job *);
1da177e4 235
242f9dcb
JA
236enum 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
1da177e4
LT
244enum blk_queue_state {
245 Queue_down,
246 Queue_up,
247};
248
1da177e4
LT
249struct blk_queue_tag {
250 struct request **tag_index; /* map of busy tags */
251 unsigned long *tag_map; /* bit map of free/busy tags */
1da177e4
LT
252 int busy; /* current depth */
253 int max_depth; /* what we will send to device */
ba025082 254 int real_max_depth; /* what the array can hold */
1da177e4
LT
255 atomic_t refcnt; /* map can be shared */
256};
257
abf54393
FT
258#define BLK_SCSI_MAX_CMDS (256)
259#define BLK_SCSI_CMD_PER_LONG (BLK_SCSI_MAX_CMDS / (sizeof(long) * 8))
260
025146e1
MP
261struct 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;
c72758f3
MP
268 unsigned int physical_block_size;
269 unsigned int alignment_offset;
270 unsigned int io_min;
271 unsigned int io_opt;
67efc925 272 unsigned int max_discard_sectors;
4363ac7c 273 unsigned int max_write_same_sectors;
86b37281
MP
274 unsigned int discard_granularity;
275 unsigned int discard_alignment;
025146e1
MP
276
277 unsigned short logical_block_size;
8a78362c 278 unsigned short max_segments;
13f05c8d 279 unsigned short max_integrity_segments;
025146e1 280
c72758f3 281 unsigned char misaligned;
86b37281 282 unsigned char discard_misaligned;
e692cb66 283 unsigned char cluster;
a934a00a 284 unsigned char discard_zeroes_data;
025146e1
MP
285};
286
d7b76301 287struct request_queue {
1da177e4
LT
288 /*
289 * Together with queue_head for cacheline sharing
290 */
291 struct list_head queue_head;
292 struct request *last_merge;
b374d18a 293 struct elevator_queue *elevator;
8a5ecdd4
TH
294 int nr_rqs[2]; /* # allocated [a]sync rqs */
295 int nr_rqs_elvpriv; /* # allocated rqs w/ elvpriv */
1da177e4
LT
296
297 /*
a051661c
TH
298 * 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().
1da177e4 302 */
a051661c 303 struct request_list root_rl;
1da177e4
LT
304
305 request_fn_proc *request_fn;
1da177e4
LT
306 make_request_fn *make_request_fn;
307 prep_rq_fn *prep_rq_fn;
28018c24 308 unprep_rq_fn *unprep_rq_fn;
1da177e4 309 merge_bvec_fn *merge_bvec_fn;
ff856bad 310 softirq_done_fn *softirq_done_fn;
242f9dcb 311 rq_timed_out_fn *rq_timed_out_fn;
2fb98e84 312 dma_drain_needed_fn *dma_drain_needed;
ef9e3fac 313 lld_busy_fn *lld_busy_fn;
1da177e4 314
8922e16c
TH
315 /*
316 * Dispatch queue sorting
317 */
1b47f531 318 sector_t end_sector;
8922e16c 319 struct request *boundary_rq;
8922e16c 320
1da177e4 321 /*
3cca6dc1 322 * Delayed queue handling
1da177e4 323 */
3cca6dc1 324 struct delayed_work delay_work;
1da177e4
LT
325
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
1da177e4 334 /*
d7b76301 335 * various queue flags, see QUEUE_* below
1da177e4 336 */
d7b76301 337 unsigned long queue_flags;
1da177e4 338
a73f730d
TH
339 /*
340 * ida allocated id for this queue. Used to index queues from
341 * ioctx.
342 */
343 int id;
344
1da177e4 345 /*
d7b76301 346 * queue needs bounce pages for pages above this limit
1da177e4 347 */
d7b76301 348 gfp_t bounce_gfp;
1da177e4
LT
349
350 /*
152587de 351 * protects queue structures from reentrancy. ->__queue_lock should
352 * _never_ be used directly, it is queue private. always use
353 * ->queue_lock.
1da177e4 354 */
152587de 355 spinlock_t __queue_lock;
1da177e4
LT
356 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
fa0ccd83 371 unsigned int dma_drain_size;
d7b76301 372 void *dma_drain_buffer;
e3790c7d 373 unsigned int dma_pad_mask;
1da177e4
LT
374 unsigned int dma_alignment;
375
376 struct blk_queue_tag *queue_tags;
6eca9004 377 struct list_head tag_busy_list;
1da177e4 378
15853af9 379 unsigned int nr_sorted;
0a7ae2ff 380 unsigned int in_flight[2];
1da177e4 381
242f9dcb
JA
382 unsigned int rq_timeout;
383 struct timer_list timeout;
384 struct list_head timeout_list;
385
a612fddf 386 struct list_head icq_list;
4eef3049 387#ifdef CONFIG_BLK_CGROUP
a2b1693b 388 DECLARE_BITMAP (blkcg_pols, BLKCG_MAX_POLS);
3c798398 389 struct blkcg_gq *root_blkg;
03aa264a 390 struct list_head blkg_list;
4eef3049 391#endif
a612fddf 392
025146e1
MP
393 struct queue_limits limits;
394
1da177e4
LT
395 /*
396 * sg stuff
397 */
398 unsigned int sg_timeout;
399 unsigned int sg_reserved_size;
1946089a 400 int node;
6c5c9341 401#ifdef CONFIG_BLK_DEV_IO_TRACE
2056a782 402 struct blk_trace *blk_trace;
6c5c9341 403#endif
1da177e4 404 /*
4913efe4 405 * for flush operations
1da177e4 406 */
4913efe4 407 unsigned int flush_flags;
f3876930 408 unsigned int flush_not_queueable:1;
3ac0cc45 409 unsigned int flush_queue_delayed:1;
ae1b1539
TH
410 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;
dd4c133f 415 struct request flush_rq;
483f4afc
AV
416
417 struct mutex sysfs_lock;
d351af01 418
d732580b
TH
419 int bypass_depth;
420
d351af01 421#if defined(CONFIG_BLK_DEV_BSG)
aa387cc8
MC
422 bsg_job_fn *bsg_job_fn;
423 int bsg_job_size;
d351af01
FT
424 struct bsg_class_device bsg_dev;
425#endif
e43473b7 426
923adde1
TH
427#ifdef CONFIG_BLK_CGROUP
428 struct list_head all_q_node;
429#endif
e43473b7
VG
430#ifdef CONFIG_BLK_DEV_THROTTLING
431 /* Throttle data */
432 struct throtl_data *td;
433#endif
1da177e4
LT
434};
435
1da177e4
LT
436#define QUEUE_FLAG_QUEUED 1 /* uses generic tag queueing */
437#define QUEUE_FLAG_STOPPED 2 /* queue is stopped */
1faa16d2
JA
438#define QUEUE_FLAG_SYNCFULL 3 /* read queue has been filled */
439#define QUEUE_FLAG_ASYNCFULL 4 /* write queue has been filled */
3f3299d5 440#define QUEUE_FLAG_DYING 5 /* queue being torn down */
d732580b 441#define QUEUE_FLAG_BYPASS 6 /* act as dumb FIFO queue */
c21e6beb
JA
442#define QUEUE_FLAG_BIDI 7 /* queue supports bidi requests */
443#define QUEUE_FLAG_NOMERGES 8 /* disable merge attempts */
5757a6d7 444#define QUEUE_FLAG_SAME_COMP 9 /* complete on same CPU-group */
c21e6beb
JA
445#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) */
88e740f1 448#define QUEUE_FLAG_VIRT QUEUE_FLAG_NONROT /* paravirt device */
c21e6beb
JA
449#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 */
5757a6d7 454#define QUEUE_FLAG_SAME_FORCE 18 /* force complete on same CPU */
c246e80d 455#define QUEUE_FLAG_DEAD 19 /* queue tear-down finished */
bc58ba94
JA
456
457#define QUEUE_FLAG_DEFAULT ((1 << QUEUE_FLAG_IO_STAT) | \
01e97f6b 458 (1 << QUEUE_FLAG_STACKABLE) | \
e2e1a148
JA
459 (1 << QUEUE_FLAG_SAME_COMP) | \
460 (1 << QUEUE_FLAG_ADD_RANDOM))
797e7dbb 461
8bcb6c7d 462static inline void queue_lockdep_assert_held(struct request_queue *q)
8f45c1a5 463{
8bcb6c7d
AK
464 if (q->queue_lock)
465 lockdep_assert_held(q->queue_lock);
8f45c1a5
LT
466}
467
75ad23bc
NP
468static inline void queue_flag_set_unlocked(unsigned int flag,
469 struct request_queue *q)
470{
471 __set_bit(flag, &q->queue_flags);
472}
473
e48ec690
JA
474static inline int queue_flag_test_and_clear(unsigned int flag,
475 struct request_queue *q)
476{
8bcb6c7d 477 queue_lockdep_assert_held(q);
e48ec690
JA
478
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{
8bcb6c7d 490 queue_lockdep_assert_held(q);
e48ec690
JA
491
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
75ad23bc
NP
500static inline void queue_flag_set(unsigned int flag, struct request_queue *q)
501{
8bcb6c7d 502 queue_lockdep_assert_held(q);
75ad23bc
NP
503 __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
0a7ae2ff
JA
512static inline int queue_in_flight(struct request_queue *q)
513{
514 return q->in_flight[0] + q->in_flight[1];
515}
516
75ad23bc
NP
517static inline void queue_flag_clear(unsigned int flag, struct request_queue *q)
518{
8bcb6c7d 519 queue_lockdep_assert_held(q);
75ad23bc
NP
520 __clear_bit(flag, &q->queue_flags);
521}
522
1da177e4
LT
523#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)
3f3299d5 525#define blk_queue_dying(q) test_bit(QUEUE_FLAG_DYING, &(q)->queue_flags)
c246e80d 526#define blk_queue_dead(q) test_bit(QUEUE_FLAG_DEAD, &(q)->queue_flags)
d732580b 527#define blk_queue_bypass(q) test_bit(QUEUE_FLAG_BYPASS, &(q)->queue_flags)
ac9fafa1 528#define blk_queue_nomerges(q) test_bit(QUEUE_FLAG_NOMERGES, &(q)->queue_flags)
488991e2
AB
529#define blk_queue_noxmerges(q) \
530 test_bit(QUEUE_FLAG_NOXMERGES, &(q)->queue_flags)
a68bbddb 531#define blk_queue_nonrot(q) test_bit(QUEUE_FLAG_NONROT, &(q)->queue_flags)
bc58ba94 532#define blk_queue_io_stat(q) test_bit(QUEUE_FLAG_IO_STAT, &(q)->queue_flags)
e2e1a148 533#define blk_queue_add_random(q) test_bit(QUEUE_FLAG_ADD_RANDOM, &(q)->queue_flags)
4ee5eaf4
KU
534#define blk_queue_stackable(q) \
535 test_bit(QUEUE_FLAG_STACKABLE, &(q)->queue_flags)
c15227de 536#define blk_queue_discard(q) test_bit(QUEUE_FLAG_DISCARD, &(q)->queue_flags)
8d57a98c
AH
537#define blk_queue_secdiscard(q) (blk_queue_discard(q) && \
538 test_bit(QUEUE_FLAG_SECDISCARD, &(q)->queue_flags))
1da177e4 539
33659ebb
CH
540#define blk_noretry_request(rq) \
541 ((rq)->cmd_flags & (REQ_FAILFAST_DEV|REQ_FAILFAST_TRANSPORT| \
542 REQ_FAILFAST_DRIVER))
543
544#define blk_account_rq(rq) \
545 (((rq)->cmd_flags & REQ_STARTED) && \
e2a60da7 546 ((rq)->cmd_type == REQ_TYPE_FS))
33659ebb 547
1da177e4 548#define blk_pm_request(rq) \
33659ebb
CH
549 ((rq)->cmd_type == REQ_TYPE_PM_SUSPEND || \
550 (rq)->cmd_type == REQ_TYPE_PM_RESUME)
1da177e4 551
ab780f1e 552#define blk_rq_cpu_valid(rq) ((rq)->cpu != -1)
abae1fde 553#define blk_bidi_rq(rq) ((rq)->next_rq != NULL)
336cdb40
KU
554/* rq->queuelist of dequeued request must be list_empty() */
555#define blk_queued_rq(rq) (!list_empty(&(rq)->queuelist))
1da177e4
LT
556
557#define list_entry_rq(ptr) list_entry((ptr), struct request, queuelist)
558
4aff5e23 559#define rq_data_dir(rq) ((rq)->cmd_flags & 1)
1da177e4 560
e692cb66
MP
561static inline unsigned int blk_queue_cluster(struct request_queue *q)
562{
563 return q->limits.cluster;
564}
565
9e2585a8 566/*
1faa16d2 567 * We regard a request as sync, if either a read or a sync write
9e2585a8 568 */
1faa16d2
JA
569static inline bool rw_is_sync(unsigned int rw_flags)
570{
7b6d91da 571 return !(rw_flags & REQ_WRITE) || (rw_flags & REQ_SYNC);
1faa16d2
JA
572}
573
574static inline bool rq_is_sync(struct request *rq)
575{
576 return rw_is_sync(rq->cmd_flags);
577}
578
5b788ce3 579static inline bool blk_rl_full(struct request_list *rl, bool sync)
1da177e4 580{
5b788ce3
TH
581 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
582
583 return rl->flags & flag;
1da177e4
LT
584}
585
5b788ce3 586static inline void blk_set_rl_full(struct request_list *rl, bool sync)
1da177e4 587{
5b788ce3
TH
588 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
589
590 rl->flags |= flag;
1da177e4
LT
591}
592
5b788ce3 593static inline void blk_clear_rl_full(struct request_list *rl, bool sync)
1da177e4 594{
5b788ce3
TH
595 unsigned int flag = sync ? BLK_RL_SYNCFULL : BLK_RL_ASYNCFULL;
596
597 rl->flags &= ~flag;
1da177e4
LT
598}
599
e2a60da7
MP
600static inline bool rq_mergeable(struct request *rq)
601{
602 if (rq->cmd_type != REQ_TYPE_FS)
603 return false;
1da177e4 604
e2a60da7
MP
605 if (rq->cmd_flags & REQ_NOMERGE_FLAGS)
606 return false;
607
608 return true;
609}
1da177e4 610
f31dc1cd
MP
611static 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
4363ac7c
MP
620 if ((flags1 & REQ_WRITE_SAME) != (flags2 & REQ_WRITE_SAME))
621 return false;
622
f31dc1cd
MP
623 return true;
624}
625
4363ac7c
MP
626static 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
1da177e4
LT
634/*
635 * 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 */
2472892a
AK
650
651#if BITS_PER_LONG == 32
1da177e4 652#define BLK_BOUNCE_HIGH ((u64)blk_max_low_pfn << PAGE_SHIFT)
2472892a
AK
653#else
654#define BLK_BOUNCE_HIGH -1ULL
655#endif
656#define BLK_BOUNCE_ANY (-1ULL)
bfe17231 657#define BLK_BOUNCE_ISA (DMA_BIT_MASK(24))
1da177e4 658
3d6392cf
JA
659/*
660 * default timeout for SG_IO if none specified
661 */
662#define BLK_DEFAULT_SG_TIMEOUT (60 * HZ)
f2f1fa78 663#define BLK_MIN_SG_TIMEOUT (7 * HZ)
3d6392cf 664
2a7326b5 665#ifdef CONFIG_BOUNCE
1da177e4 666extern int init_emergency_isa_pool(void);
165125e1 667extern void blk_queue_bounce(struct request_queue *q, struct bio **bio);
1da177e4
LT
668#else
669static inline int init_emergency_isa_pool(void)
670{
671 return 0;
672}
165125e1 673static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio)
1da177e4
LT
674{
675}
676#endif /* CONFIG_MMU */
677
152e283f
FT
678struct rq_map_data {
679 struct page **pages;
680 int page_order;
681 int nr_entries;
56c451f4 682 unsigned long offset;
97ae77a1 683 int null_mapped;
ecb554a8 684 int from_user;
152e283f
FT
685};
686
5705f702
N
687struct req_iterator {
688 int i;
689 struct bio *bio;
690};
691
692/* This should not be used directly - use rq_for_each_segment */
1e428079
JA
693#define for_each_bio(_bio) \
694 for (; _bio; _bio = _bio->bi_next)
5705f702 695#define __rq_for_each_bio(_bio, rq) \
1da177e4
LT
696 if ((rq->bio)) \
697 for (_bio = (rq)->bio; _bio; _bio = _bio->bi_next)
698
5705f702
N
699#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
2d4dc890
IL
706#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
1da177e4
LT
717extern int blk_register_queue(struct gendisk *disk);
718extern void blk_unregister_queue(struct gendisk *disk);
1da177e4 719extern void generic_make_request(struct bio *bio);
2a4aa30c 720extern void blk_rq_init(struct request_queue *q, struct request *rq);
1da177e4 721extern void blk_put_request(struct request *);
165125e1 722extern void __blk_put_request(struct request_queue *, struct request *);
165125e1 723extern struct request *blk_get_request(struct request_queue *, int, gfp_t);
79eb63e9
BH
724extern struct request *blk_make_request(struct request_queue *, struct bio *,
725 gfp_t);
165125e1 726extern void blk_requeue_request(struct request_queue *, struct request *);
66ac0280
CH
727extern void blk_add_request_payload(struct request *rq, struct page *page,
728 unsigned int len);
82124d60 729extern int blk_rq_check_limits(struct request_queue *q, struct request *rq);
ef9e3fac 730extern int blk_lld_busy(struct request_queue *q);
b0fd271d
KU
731extern 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);
82124d60
KU
736extern int blk_insert_cloned_request(struct request_queue *q,
737 struct request *rq);
3cca6dc1 738extern void blk_delay_queue(struct request_queue *, unsigned long);
165125e1 739extern void blk_recount_segments(struct request_queue *, struct bio *);
0bfc96cb 740extern int scsi_verify_blk_ioctl(struct block_device *, unsigned int);
577ebb37
PB
741extern int scsi_cmd_blk_ioctl(struct block_device *, fmode_t,
742 unsigned int, void __user *);
74f3c8af
AV
743extern int scsi_cmd_ioctl(struct request_queue *, struct gendisk *, fmode_t,
744 unsigned int, void __user *);
e915e872
AV
745extern int sg_scsi_ioctl(struct request_queue *, struct gendisk *, fmode_t,
746 struct scsi_ioctl_command __user *);
3fcfab16 747
5a7bbad2 748extern void blk_queue_bio(struct request_queue *q, struct bio *bio);
166e1f90 749
3fcfab16
AM
750/*
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 */
8aa7e847 755static inline void blk_clear_queue_congested(struct request_queue *q, int sync)
3fcfab16 756{
8aa7e847 757 clear_bdi_congested(&q->backing_dev_info, sync);
3fcfab16
AM
758}
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 */
8aa7e847 764static inline void blk_set_queue_congested(struct request_queue *q, int sync)
3fcfab16 765{
8aa7e847 766 set_bdi_congested(&q->backing_dev_info, sync);
3fcfab16
AM
767}
768
165125e1
JA
769extern void blk_start_queue(struct request_queue *q);
770extern void blk_stop_queue(struct request_queue *q);
1da177e4 771extern void blk_sync_queue(struct request_queue *q);
165125e1 772extern void __blk_stop_queue(struct request_queue *q);
24ecfbe2 773extern void __blk_run_queue(struct request_queue *q);
165125e1 774extern void blk_run_queue(struct request_queue *);
c21e6beb 775extern void blk_run_queue_async(struct request_queue *q);
a3bce90e 776extern int blk_rq_map_user(struct request_queue *, struct request *,
152e283f
FT
777 struct rq_map_data *, void __user *, unsigned long,
778 gfp_t);
8e5cfc45 779extern int blk_rq_unmap_user(struct bio *);
165125e1
JA
780extern 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 *,
152e283f
FT
782 struct rq_map_data *, struct sg_iovec *, int,
783 unsigned int, gfp_t);
165125e1 784extern int blk_execute_rq(struct request_queue *, struct gendisk *,
994ca9a1 785 struct request *, int);
165125e1 786extern void blk_execute_rq_nowait(struct request_queue *, struct gendisk *,
15fc858a 787 struct request *, int, rq_end_io_fn *);
6e39b69e 788
165125e1 789static inline struct request_queue *bdev_get_queue(struct block_device *bdev)
1da177e4
LT
790{
791 return bdev->bd_disk->queue;
792}
793
5efccd17 794/*
80a761fd
TH
795 * 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
5efccd17 801 */
5b93629b
TH
802static inline sector_t blk_rq_pos(const struct request *rq)
803{
a2dec7b3 804 return rq->__sector;
2e46e8b2
TH
805}
806
807static inline unsigned int blk_rq_bytes(const struct request *rq)
808{
a2dec7b3 809 return rq->__data_len;
5b93629b
TH
810}
811
2e46e8b2
TH
812static inline int blk_rq_cur_bytes(const struct request *rq)
813{
814 return rq->bio ? bio_cur_bytes(rq->bio) : 0;
815}
5efccd17 816
80a761fd
TH
817extern unsigned int blk_rq_err_bytes(const struct request *rq);
818
5b93629b
TH
819static inline unsigned int blk_rq_sectors(const struct request *rq)
820{
2e46e8b2 821 return blk_rq_bytes(rq) >> 9;
5b93629b
TH
822}
823
824static inline unsigned int blk_rq_cur_sectors(const struct request *rq)
825{
2e46e8b2 826 return blk_rq_cur_bytes(rq) >> 9;
5b93629b
TH
827}
828
f31dc1cd
MP
829static 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
4363ac7c
MP
835 if (unlikely(cmd_flags & REQ_WRITE_SAME))
836 return q->limits.max_write_same_sectors;
837
f31dc1cd
MP
838 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
9934c8c0
TH
851/*
852 * 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
1da177e4 858/*
2e60e022
TH
859 * Request completion related functions.
860 *
861 * blk_update_request() completes given number of bytes and updates
862 * the request without completing it.
863 *
f06d9a2b
TH
864 * blk_end_request() and friends. __blk_end_request() must be called
865 * with the request queue spinlock acquired.
1da177e4
LT
866 *
867 * Several drivers define their own end_request and call
3bcddeac
KU
868 * blk_end_request() for parts of the original function.
869 * This prevents code duplication in drivers.
1da177e4 870 */
2e60e022
TH
871extern bool blk_update_request(struct request *rq, int error,
872 unsigned int nr_bytes);
b1f74493
FT
873extern 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);
80a761fd 877extern bool blk_end_request_err(struct request *rq, int error);
b1f74493
FT
878extern 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);
80a761fd 882extern bool __blk_end_request_err(struct request *rq, int error);
2e60e022 883
ff856bad 884extern void blk_complete_request(struct request *);
242f9dcb
JA
885extern void __blk_complete_request(struct request *);
886extern void blk_abort_request(struct request *);
28018c24 887extern void blk_unprep_request(struct request *);
ff856bad 888
1da177e4
LT
889/*
890 * Access functions for manipulating queue properties
891 */
165125e1 892extern struct request_queue *blk_init_queue_node(request_fn_proc *rfn,
1946089a 893 spinlock_t *lock, int node_id);
165125e1 894extern struct request_queue *blk_init_queue(request_fn_proc *, spinlock_t *);
01effb0d
MS
895extern struct request_queue *blk_init_allocated_queue(struct request_queue *,
896 request_fn_proc *, spinlock_t *);
165125e1
JA
897extern 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);
72d4cd9f 900extern void blk_limits_max_hw_sectors(struct queue_limits *, unsigned int);
086fa5ff 901extern void blk_queue_max_hw_sectors(struct request_queue *, unsigned int);
8a78362c 902extern void blk_queue_max_segments(struct request_queue *, unsigned short);
165125e1 903extern void blk_queue_max_segment_size(struct request_queue *, unsigned int);
67efc925
CH
904extern void blk_queue_max_discard_sectors(struct request_queue *q,
905 unsigned int max_discard_sectors);
4363ac7c
MP
906extern void blk_queue_max_write_same_sectors(struct request_queue *q,
907 unsigned int max_write_same_sectors);
e1defc4f 908extern void blk_queue_logical_block_size(struct request_queue *, unsigned short);
892b6f90 909extern void blk_queue_physical_block_size(struct request_queue *, unsigned int);
c72758f3
MP
910extern void blk_queue_alignment_offset(struct request_queue *q,
911 unsigned int alignment);
7c958e32 912extern void blk_limits_io_min(struct queue_limits *limits, unsigned int min);
c72758f3 913extern void blk_queue_io_min(struct request_queue *q, unsigned int min);
3c5820c7 914extern void blk_limits_io_opt(struct queue_limits *limits, unsigned int opt);
c72758f3 915extern void blk_queue_io_opt(struct request_queue *q, unsigned int opt);
e475bba2 916extern void blk_set_default_limits(struct queue_limits *lim);
b1bd055d 917extern void blk_set_stacking_limits(struct queue_limits *lim);
c72758f3
MP
918extern int blk_stack_limits(struct queue_limits *t, struct queue_limits *b,
919 sector_t offset);
17be8c24
MP
920extern int bdev_stack_limits(struct queue_limits *t, struct block_device *bdev,
921 sector_t offset);
c72758f3
MP
922extern void disk_stack_limits(struct gendisk *disk, struct block_device *bdev,
923 sector_t offset);
165125e1 924extern void blk_queue_stack_limits(struct request_queue *t, struct request_queue *b);
e3790c7d 925extern void blk_queue_dma_pad(struct request_queue *, unsigned int);
27f8221a 926extern void blk_queue_update_dma_pad(struct request_queue *, unsigned int);
2fb98e84
TH
927extern int blk_queue_dma_drain(struct request_queue *q,
928 dma_drain_needed_fn *dma_drain_needed,
929 void *buf, unsigned int size);
ef9e3fac 930extern void blk_queue_lld_busy(struct request_queue *q, lld_busy_fn *fn);
165125e1
JA
931extern void blk_queue_segment_boundary(struct request_queue *, unsigned long);
932extern void blk_queue_prep_rq(struct request_queue *, prep_rq_fn *pfn);
28018c24 933extern void blk_queue_unprep_rq(struct request_queue *, unprep_rq_fn *ufn);
165125e1
JA
934extern void blk_queue_merge_bvec(struct request_queue *, merge_bvec_fn *);
935extern void blk_queue_dma_alignment(struct request_queue *, int);
11c3e689 936extern void blk_queue_update_dma_alignment(struct request_queue *, int);
165125e1 937extern void blk_queue_softirq_done(struct request_queue *, softirq_done_fn *);
242f9dcb
JA
938extern void blk_queue_rq_timed_out(struct request_queue *, rq_timed_out_fn *);
939extern void blk_queue_rq_timeout(struct request_queue *, unsigned int);
4913efe4 940extern void blk_queue_flush(struct request_queue *q, unsigned int flush);
f3876930 941extern void blk_queue_flush_queueable(struct request_queue *q, bool queueable);
1da177e4 942extern struct backing_dev_info *blk_get_backing_dev_info(struct block_device *bdev);
1da177e4 943
165125e1 944extern int blk_rq_map_sg(struct request_queue *, struct request *, struct scatterlist *);
85b9f66a
AH
945extern int blk_bio_map_sg(struct request_queue *q, struct bio *bio,
946 struct scatterlist *sglist);
1da177e4 947extern void blk_dump_rq_flags(struct request *, char *);
1da177e4 948extern long nr_blockdev_pages(void);
1da177e4 949
09ac46c4 950bool __must_check blk_get_queue(struct request_queue *);
165125e1
JA
951struct 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 *);
1da177e4 954
316cc67d 955/*
75df7136
SJ
956 * 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.
316cc67d 966 */
73c10101 967struct blk_plug {
75df7136
SJ
968 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? */
73c10101 972};
55c022bb
SL
973#define BLK_MAX_REQUEST_COUNT 16
974
9cbb1750 975struct blk_plug_cb;
74018dc3 976typedef void (*blk_plug_cb_fn)(struct blk_plug_cb *, bool);
048c9374
N
977struct blk_plug_cb {
978 struct list_head list;
9cbb1750
N
979 blk_plug_cb_fn callback;
980 void *data;
048c9374 981};
9cbb1750
N
982extern struct blk_plug_cb *blk_check_plugged(blk_plug_cb_fn unplug,
983 void *data, int size);
73c10101
JA
984extern void blk_start_plug(struct blk_plug *);
985extern void blk_finish_plug(struct blk_plug *);
f6603783 986extern void blk_flush_plug_list(struct blk_plug *, bool);
73c10101
JA
987
988static inline void blk_flush_plug(struct task_struct *tsk)
989{
990 struct blk_plug *plug = tsk->plug;
991
a237c1c5
JA
992 if (plug)
993 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
88b996cd 1000 if (plug)
f6603783 1001 blk_flush_plug_list(plug, true);
73c10101
JA
1002}
1003
1004static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1005{
1006 struct blk_plug *plug = tsk->plug;
1007
048c9374 1008 return plug && (!list_empty(&plug->list) || !list_empty(&plug->cb_list));
73c10101
JA
1009}
1010
1da177e4
LT
1011/*
1012 * tag stuff
1013 */
4aff5e23 1014#define blk_rq_tagged(rq) ((rq)->cmd_flags & REQ_QUEUED)
165125e1
JA
1015extern 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 *);
492dfb48
JB
1022extern struct blk_queue_tag *blk_init_tags(int);
1023extern void blk_free_tags(struct blk_queue_tag *);
1da177e4 1024
f583f492
DS
1025static 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}
dd3932ed
CH
1032
1033#define BLKDEV_DISCARD_SECURE 0x01 /* secure discard */
1034
1035extern int blkdev_issue_flush(struct block_device *, gfp_t, sector_t *);
fbd9b09a
DM
1036extern int blkdev_issue_discard(struct block_device *bdev, sector_t sector,
1037 sector_t nr_sects, gfp_t gfp_mask, unsigned long flags);
4363ac7c
MP
1038extern int blkdev_issue_write_same(struct block_device *bdev, sector_t sector,
1039 sector_t nr_sects, gfp_t gfp_mask, struct page *page);
3f14d792 1040extern int blkdev_issue_zeroout(struct block_device *bdev, sector_t sector,
dd3932ed 1041 sector_t nr_sects, gfp_t gfp_mask);
2cf6d26a
CH
1042static inline int sb_issue_discard(struct super_block *sb, sector_t block,
1043 sector_t nr_blocks, gfp_t gfp_mask, unsigned long flags)
fb2dce86 1044{
2cf6d26a
CH
1045 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);
fb2dce86 1048}
e6fa0be6 1049static inline int sb_issue_zeroout(struct super_block *sb, sector_t block,
a107e5a3 1050 sector_t nr_blocks, gfp_t gfp_mask)
e6fa0be6
LC
1051{
1052 return blkdev_issue_zeroout(sb->s_bdev,
1053 block << (sb->s_blocksize_bits - 9),
1054 nr_blocks << (sb->s_blocksize_bits - 9),
a107e5a3 1055 gfp_mask);
e6fa0be6 1056}
1da177e4 1057
018e0446 1058extern int blk_verify_command(unsigned char *cmd, fmode_t has_write_perm);
0b07de85 1059
eb28d31b
MP
1060enum 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};
0e435ac2 1067
1da177e4
LT
1068#define blkdev_entry_to_request(entry) list_entry((entry), struct request, queuelist)
1069
ae03bf63
MP
1070static inline unsigned long queue_bounce_pfn(struct request_queue *q)
1071{
025146e1 1072 return q->limits.bounce_pfn;
ae03bf63
MP
1073}
1074
1075static inline unsigned long queue_segment_boundary(struct request_queue *q)
1076{
025146e1 1077 return q->limits.seg_boundary_mask;
ae03bf63
MP
1078}
1079
1080static inline unsigned int queue_max_sectors(struct request_queue *q)
1081{
025146e1 1082 return q->limits.max_sectors;
ae03bf63
MP
1083}
1084
1085static inline unsigned int queue_max_hw_sectors(struct request_queue *q)
1086{
025146e1 1087 return q->limits.max_hw_sectors;
ae03bf63
MP
1088}
1089
8a78362c 1090static inline unsigned short queue_max_segments(struct request_queue *q)
ae03bf63 1091{
8a78362c 1092 return q->limits.max_segments;
ae03bf63
MP
1093}
1094
1095static inline unsigned int queue_max_segment_size(struct request_queue *q)
1096{
025146e1 1097 return q->limits.max_segment_size;
ae03bf63
MP
1098}
1099
e1defc4f 1100static inline unsigned short queue_logical_block_size(struct request_queue *q)
1da177e4
LT
1101{
1102 int retval = 512;
1103
025146e1
MP
1104 if (q && q->limits.logical_block_size)
1105 retval = q->limits.logical_block_size;
1da177e4
LT
1106
1107 return retval;
1108}
1109
e1defc4f 1110static inline unsigned short bdev_logical_block_size(struct block_device *bdev)
1da177e4 1111{
e1defc4f 1112 return queue_logical_block_size(bdev_get_queue(bdev));
1da177e4
LT
1113}
1114
c72758f3
MP
1115static inline unsigned int queue_physical_block_size(struct request_queue *q)
1116{
1117 return q->limits.physical_block_size;
1118}
1119
892b6f90 1120static inline unsigned int bdev_physical_block_size(struct block_device *bdev)
ac481c20
MP
1121{
1122 return queue_physical_block_size(bdev_get_queue(bdev));
1123}
1124
c72758f3
MP
1125static inline unsigned int queue_io_min(struct request_queue *q)
1126{
1127 return q->limits.io_min;
1128}
1129
ac481c20
MP
1130static inline int bdev_io_min(struct block_device *bdev)
1131{
1132 return queue_io_min(bdev_get_queue(bdev));
1133}
1134
c72758f3
MP
1135static inline unsigned int queue_io_opt(struct request_queue *q)
1136{
1137 return q->limits.io_opt;
1138}
1139
ac481c20
MP
1140static inline int bdev_io_opt(struct block_device *bdev)
1141{
1142 return queue_io_opt(bdev_get_queue(bdev));
1143}
1144
c72758f3
MP
1145static inline int queue_alignment_offset(struct request_queue *q)
1146{
ac481c20 1147 if (q->limits.misaligned)
c72758f3
MP
1148 return -1;
1149
ac481c20 1150 return q->limits.alignment_offset;
c72758f3
MP
1151}
1152
e03a72e1 1153static inline int queue_limit_alignment_offset(struct queue_limits *lim, sector_t sector)
81744ee4
MP
1154{
1155 unsigned int granularity = max(lim->physical_block_size, lim->io_min);
e03a72e1 1156 unsigned int alignment = (sector << 9) & (granularity - 1);
81744ee4 1157
e03a72e1
MP
1158 return (granularity + lim->alignment_offset - alignment)
1159 & (granularity - 1);
c72758f3
MP
1160}
1161
ac481c20
MP
1162static 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
86b37281
MP
1175static 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
e03a72e1 1183static inline int queue_limit_discard_alignment(struct queue_limits *lim, sector_t sector)
86b37281 1184{
dd3d145d
MP
1185 unsigned int alignment = (sector << 9) & (lim->discard_granularity - 1);
1186
a934a00a
MP
1187 if (!lim->max_discard_sectors)
1188 return 0;
1189
dd3d145d
MP
1190 return (lim->discard_granularity + lim->discard_alignment - alignment)
1191 & (lim->discard_granularity - 1);
86b37281
MP
1192}
1193
c6e66634
PB
1194static 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
98262f27
MP
1204static inline unsigned int queue_discard_zeroes_data(struct request_queue *q)
1205{
a934a00a 1206 if (q->limits.max_discard_sectors && q->limits.discard_zeroes_data == 1)
98262f27
MP
1207 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
4363ac7c
MP
1217static 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
165125e1 1227static inline int queue_dma_alignment(struct request_queue *q)
1da177e4 1228{
482eb689 1229 return q ? q->dma_alignment : 511;
1da177e4
LT
1230}
1231
14417799 1232static inline int blk_rq_aligned(struct request_queue *q, unsigned long addr,
87904074
FT
1233 unsigned int len)
1234{
1235 unsigned int alignment = queue_dma_alignment(q) | q->dma_pad_mask;
14417799 1236 return !(addr & alignment) && !(len & alignment);
87904074
FT
1237}
1238
1da177e4
LT
1239/* 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
2befb9e3 1250static inline unsigned int block_size(struct block_device *bdev)
1da177e4
LT
1251{
1252 return bdev->bd_block_size;
1253}
1254
f3876930 1255static inline bool queue_flush_queueable(struct request_queue *q)
1256{
1257 return !q->flush_not_queueable;
1258}
1259
1da177e4
LT
1260typedef 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;
18887ad9 1270int kblockd_schedule_work(struct request_queue *q, struct work_struct *work);
1da177e4 1271
9195291e 1272#ifdef CONFIG_BLK_CGROUP
28f4197e
JA
1273/*
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 */
9195291e
DS
1278static inline void set_start_time_ns(struct request *req)
1279{
28f4197e 1280 preempt_disable();
9195291e 1281 req->start_time_ns = sched_clock();
28f4197e 1282 preempt_enable();
9195291e
DS
1283}
1284
1285static inline void set_io_start_time_ns(struct request *req)
1286{
28f4197e 1287 preempt_disable();
9195291e 1288 req->io_start_time_ns = sched_clock();
28f4197e 1289 preempt_enable();
9195291e 1290}
84c124da
DS
1291
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}
9195291e
DS
1301#else
1302static inline void set_start_time_ns(struct request *req) {}
1303static inline void set_io_start_time_ns(struct request *req) {}
84c124da
DS
1304static 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}
9195291e
DS
1312#endif
1313
1da177e4
LT
1314#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
7ba1ba12
MP
1319#if defined(CONFIG_BLK_DEV_INTEGRITY)
1320
b24498d4
JA
1321#define INTEGRITY_FLAG_READ 2 /* verify data integrity on read */
1322#define INTEGRITY_FLAG_WRITE 4 /* generate data integrity on write */
7ba1ba12
MP
1323
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
a63a5cf8 1354extern bool blk_integrity_is_initialized(struct gendisk *);
7ba1ba12
MP
1355extern int blk_integrity_register(struct gendisk *, struct blk_integrity *);
1356extern void blk_integrity_unregister(struct gendisk *);
ad7fce93 1357extern int blk_integrity_compare(struct gendisk *, struct gendisk *);
13f05c8d
MP
1358extern 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 *);
7ba1ba12 1365
b04accc4
JA
1366static inline
1367struct blk_integrity *bdev_get_integrity(struct block_device *bdev)
1368{
1369 return bdev->bd_disk->integrity;
1370}
1371
b02739b0
MP
1372static inline struct blk_integrity *blk_get_integrity(struct gendisk *disk)
1373{
1374 return disk->integrity;
1375}
1376
7ba1ba12
MP
1377static inline int blk_integrity_rq(struct request *rq)
1378{
d442cc44
MP
1379 if (rq->bio == NULL)
1380 return 0;
1381
7ba1ba12
MP
1382 return bio_integrity(rq->bio);
1383}
1384
13f05c8d
MP
1385static 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
7ba1ba12
MP
1397#else /* CONFIG_BLK_DEV_INTEGRITY */
1398
fd83240a
SR
1399struct 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}
7ba1ba12
MP
1463
1464#endif /* CONFIG_BLK_DEV_INTEGRITY */
1465
08f85851 1466struct block_device_operations {
d4430d62
AV
1467 int (*open) (struct block_device *, fmode_t);
1468 int (*release) (struct gendisk *, fmode_t);
d4430d62
AV
1469 int (*ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
1470 int (*compat_ioctl) (struct block_device *, fmode_t, unsigned, unsigned long);
08f85851
AV
1471 int (*direct_access) (struct block_device *, sector_t,
1472 void **, unsigned long *);
77ea887e
TH
1473 unsigned int (*check_events) (struct gendisk *disk,
1474 unsigned int clearing);
1475 /* ->media_changed() is DEPRECATED, use ->check_events() instead */
08f85851 1476 int (*media_changed) (struct gendisk *);
c3e33e04 1477 void (*unlock_native_capacity) (struct gendisk *);
08f85851
AV
1478 int (*revalidate_disk) (struct gendisk *);
1479 int (*getgeo)(struct block_device *, struct hd_geometry *);
b3a27d05
NG
1480 /* this callback is with swap_lock and sometimes page table lock held */
1481 void (*swap_slot_free_notify) (struct block_device *, unsigned long);
08f85851
AV
1482 struct module *owner;
1483};
1484
633a08b8
AV
1485extern int __blkdev_driver_ioctl(struct block_device *, fmode_t, unsigned int,
1486 unsigned long);
9361401e
DH
1487#else /* CONFIG_BLOCK */
1488/*
1489 * stubs for when the block layer is configured out
1490 */
1491#define buffer_heads_over_limit 0
1492
9361401e
DH
1493static inline long nr_blockdev_pages(void)
1494{
1495 return 0;
1496}
1497
1f940bdf
JA
1498struct blk_plug {
1499};
1500
1501static inline void blk_start_plug(struct blk_plug *plug)
73c10101
JA
1502{
1503}
1504
1f940bdf 1505static inline void blk_finish_plug(struct blk_plug *plug)
73c10101
JA
1506{
1507}
1508
1f940bdf 1509static inline void blk_flush_plug(struct task_struct *task)
73c10101
JA
1510{
1511}
1512
a237c1c5
JA
1513static inline void blk_schedule_flush_plug(struct task_struct *task)
1514{
1515}
1516
1517
73c10101
JA
1518static inline bool blk_needs_flush_plug(struct task_struct *tsk)
1519{
1520 return false;
1521}
1522
9361401e
DH
1523#endif /* CONFIG_BLOCK */
1524
1da177e4 1525#endif