]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
8324aa91 JA |
2 | #ifndef BLK_INTERNAL_H |
3 | #define BLK_INTERNAL_H | |
4 | ||
a73f730d | 5 | #include <linux/idr.h> |
f70ced09 ML |
6 | #include <linux/blk-mq.h> |
7 | #include "blk-mq.h" | |
a73f730d | 8 | |
86db1e29 JA |
9 | /* Amount of time in which a process may batch requests */ |
10 | #define BLK_BATCH_TIME (HZ/50UL) | |
11 | ||
12 | /* Number of requests a "batching" process may submit */ | |
13 | #define BLK_BATCH_REQ 32 | |
14 | ||
0d2602ca JA |
15 | /* Max future timer expiry for timeouts */ |
16 | #define BLK_MAX_TIMEOUT (5 * HZ) | |
17 | ||
18fbda91 OS |
18 | #ifdef CONFIG_DEBUG_FS |
19 | extern struct dentry *blk_debugfs_root; | |
20 | #endif | |
21 | ||
7c94e1c1 ML |
22 | struct blk_flush_queue { |
23 | unsigned int flush_queue_delayed:1; | |
24 | unsigned int flush_pending_idx:1; | |
25 | unsigned int flush_running_idx:1; | |
26 | unsigned long flush_pending_since; | |
27 | struct list_head flush_queue[2]; | |
28 | struct list_head flush_data_in_flight; | |
29 | struct request *flush_rq; | |
0048b483 ML |
30 | |
31 | /* | |
32 | * flush_rq shares tag with this rq, both can't be active | |
33 | * at the same time | |
34 | */ | |
35 | struct request *orig_rq; | |
7c94e1c1 ML |
36 | spinlock_t mq_flush_lock; |
37 | }; | |
38 | ||
8324aa91 | 39 | extern struct kmem_cache *blk_requestq_cachep; |
320ae51f | 40 | extern struct kmem_cache *request_cachep; |
8324aa91 | 41 | extern struct kobj_type blk_queue_ktype; |
a73f730d | 42 | extern struct ida blk_queue_ida; |
8324aa91 | 43 | |
8a0ac14b BVA |
44 | /* |
45 | * @q->queue_lock is set while a queue is being initialized. Since we know | |
46 | * that no other threads access the queue object before @q->queue_lock has | |
47 | * been set, it is safe to manipulate queue flags without holding the | |
48 | * queue_lock if @q->queue_lock == NULL. See also blk_alloc_queue_node() and | |
49 | * blk_init_allocated_queue(). | |
50 | */ | |
51 | static inline void queue_lockdep_assert_held(struct request_queue *q) | |
52 | { | |
53 | if (q->queue_lock) | |
54 | lockdep_assert_held(q->queue_lock); | |
55 | } | |
56 | ||
57 | static inline void queue_flag_set_unlocked(unsigned int flag, | |
58 | struct request_queue *q) | |
59 | { | |
60 | if (test_bit(QUEUE_FLAG_INIT_DONE, &q->queue_flags) && | |
61 | kref_read(&q->kobj.kref)) | |
62 | lockdep_assert_held(q->queue_lock); | |
63 | __set_bit(flag, &q->queue_flags); | |
64 | } | |
65 | ||
66 | static inline void queue_flag_clear_unlocked(unsigned int flag, | |
67 | struct request_queue *q) | |
68 | { | |
69 | if (test_bit(QUEUE_FLAG_INIT_DONE, &q->queue_flags) && | |
70 | kref_read(&q->kobj.kref)) | |
71 | lockdep_assert_held(q->queue_lock); | |
72 | __clear_bit(flag, &q->queue_flags); | |
73 | } | |
74 | ||
75 | static inline int queue_flag_test_and_clear(unsigned int flag, | |
76 | struct request_queue *q) | |
77 | { | |
78 | queue_lockdep_assert_held(q); | |
79 | ||
80 | if (test_bit(flag, &q->queue_flags)) { | |
81 | __clear_bit(flag, &q->queue_flags); | |
82 | return 1; | |
83 | } | |
84 | ||
85 | return 0; | |
86 | } | |
87 | ||
88 | static inline int queue_flag_test_and_set(unsigned int flag, | |
89 | struct request_queue *q) | |
90 | { | |
91 | queue_lockdep_assert_held(q); | |
92 | ||
93 | if (!test_bit(flag, &q->queue_flags)) { | |
94 | __set_bit(flag, &q->queue_flags); | |
95 | return 0; | |
96 | } | |
97 | ||
98 | return 1; | |
99 | } | |
100 | ||
101 | static inline void queue_flag_set(unsigned int flag, struct request_queue *q) | |
102 | { | |
103 | queue_lockdep_assert_held(q); | |
104 | __set_bit(flag, &q->queue_flags); | |
105 | } | |
106 | ||
107 | static inline void queue_flag_clear(unsigned int flag, struct request_queue *q) | |
108 | { | |
109 | queue_lockdep_assert_held(q); | |
110 | __clear_bit(flag, &q->queue_flags); | |
111 | } | |
112 | ||
7c94e1c1 | 113 | static inline struct blk_flush_queue *blk_get_flush_queue( |
e97c293c | 114 | struct request_queue *q, struct blk_mq_ctx *ctx) |
7c94e1c1 | 115 | { |
7d7e0f90 CH |
116 | if (q->mq_ops) |
117 | return blk_mq_map_queue(q, ctx->cpu)->fq; | |
118 | return q->fq; | |
7c94e1c1 ML |
119 | } |
120 | ||
09ac46c4 TH |
121 | static inline void __blk_get_queue(struct request_queue *q) |
122 | { | |
123 | kobject_get(&q->kobj); | |
124 | } | |
125 | ||
f70ced09 ML |
126 | struct blk_flush_queue *blk_alloc_flush_queue(struct request_queue *q, |
127 | int node, int cmd_size); | |
128 | void blk_free_flush_queue(struct blk_flush_queue *q); | |
f3552655 | 129 | |
5b788ce3 TH |
130 | int blk_init_rl(struct request_list *rl, struct request_queue *q, |
131 | gfp_t gfp_mask); | |
b425e504 | 132 | void blk_exit_rl(struct request_queue *q, struct request_list *rl); |
86db1e29 JA |
133 | void blk_rq_bio_prep(struct request_queue *q, struct request *rq, |
134 | struct bio *bio); | |
d732580b TH |
135 | void blk_queue_bypass_start(struct request_queue *q); |
136 | void blk_queue_bypass_end(struct request_queue *q); | |
8324aa91 | 137 | void __blk_queue_free_tags(struct request_queue *q); |
3ef28e83 DW |
138 | void blk_freeze_queue(struct request_queue *q); |
139 | ||
140 | static inline void blk_queue_enter_live(struct request_queue *q) | |
141 | { | |
142 | /* | |
143 | * Given that running in generic_make_request() context | |
144 | * guarantees that a live reference against q_usage_counter has | |
145 | * been established, further references under that same context | |
146 | * need not check that the queue has been frozen (marked dead). | |
147 | */ | |
148 | percpu_ref_get(&q->q_usage_counter); | |
149 | } | |
8324aa91 | 150 | |
5a48fc14 DW |
151 | #ifdef CONFIG_BLK_DEV_INTEGRITY |
152 | void blk_flush_integrity(void); | |
7c20f116 CH |
153 | bool __bio_integrity_endio(struct bio *); |
154 | static inline bool bio_integrity_endio(struct bio *bio) | |
155 | { | |
156 | if (bio_integrity(bio)) | |
157 | return __bio_integrity_endio(bio); | |
158 | return true; | |
159 | } | |
5a48fc14 DW |
160 | #else |
161 | static inline void blk_flush_integrity(void) | |
162 | { | |
163 | } | |
7c20f116 CH |
164 | static inline bool bio_integrity_endio(struct bio *bio) |
165 | { | |
166 | return true; | |
167 | } | |
5a48fc14 | 168 | #endif |
8324aa91 | 169 | |
287922eb | 170 | void blk_timeout_work(struct work_struct *work); |
0d2602ca | 171 | unsigned long blk_rq_timeout(unsigned long timeout); |
87ee7b11 | 172 | void blk_add_timer(struct request *req); |
242f9dcb | 173 | void blk_delete_timer(struct request *); |
242f9dcb | 174 | |
320ae51f JA |
175 | |
176 | bool bio_attempt_front_merge(struct request_queue *q, struct request *req, | |
177 | struct bio *bio); | |
178 | bool bio_attempt_back_merge(struct request_queue *q, struct request *req, | |
179 | struct bio *bio); | |
1e739730 CH |
180 | bool bio_attempt_discard_merge(struct request_queue *q, struct request *req, |
181 | struct bio *bio); | |
320ae51f | 182 | bool blk_attempt_plug_merge(struct request_queue *q, struct bio *bio, |
5b3f341f SL |
183 | unsigned int *request_count, |
184 | struct request **same_queue_rq); | |
0809e3ac | 185 | unsigned int blk_plug_queued_count(struct request_queue *q); |
320ae51f JA |
186 | |
187 | void blk_account_io_start(struct request *req, bool new_io); | |
188 | void blk_account_io_completion(struct request *req, unsigned int bytes); | |
522a7775 | 189 | void blk_account_io_done(struct request *req, u64 now); |
320ae51f | 190 | |
242f9dcb JA |
191 | /* |
192 | * EH timer and IO completion will both attempt to 'grab' the request, make | |
e14575b3 JA |
193 | * sure that only one of them succeeds. Steal the bottom bit of the |
194 | * __deadline field for this. | |
242f9dcb JA |
195 | */ |
196 | static inline int blk_mark_rq_complete(struct request *rq) | |
197 | { | |
e14575b3 | 198 | return test_and_set_bit(0, &rq->__deadline); |
242f9dcb JA |
199 | } |
200 | ||
201 | static inline void blk_clear_rq_complete(struct request *rq) | |
202 | { | |
e14575b3 JA |
203 | clear_bit(0, &rq->__deadline); |
204 | } | |
205 | ||
206 | static inline bool blk_rq_is_complete(struct request *rq) | |
207 | { | |
208 | return test_bit(0, &rq->__deadline); | |
242f9dcb | 209 | } |
86db1e29 | 210 | |
158dbda0 TH |
211 | /* |
212 | * Internal elevator interface | |
213 | */ | |
e8064021 | 214 | #define ELV_ON_HASH(rq) ((rq)->rq_flags & RQF_HASHED) |
158dbda0 | 215 | |
ae1b1539 | 216 | void blk_insert_flush(struct request *rq); |
dd831006 | 217 | |
158dbda0 TH |
218 | static inline void elv_activate_rq(struct request_queue *q, struct request *rq) |
219 | { | |
220 | struct elevator_queue *e = q->elevator; | |
221 | ||
c51ca6cf JA |
222 | if (e->type->ops.sq.elevator_activate_req_fn) |
223 | e->type->ops.sq.elevator_activate_req_fn(q, rq); | |
158dbda0 TH |
224 | } |
225 | ||
226 | static inline void elv_deactivate_rq(struct request_queue *q, struct request *rq) | |
227 | { | |
228 | struct elevator_queue *e = q->elevator; | |
229 | ||
c51ca6cf JA |
230 | if (e->type->ops.sq.elevator_deactivate_req_fn) |
231 | e->type->ops.sq.elevator_deactivate_req_fn(q, rq); | |
158dbda0 TH |
232 | } |
233 | ||
ddb72532 | 234 | int elevator_init(struct request_queue *); |
a8a275c9 | 235 | void elevator_exit(struct request_queue *, struct elevator_queue *); |
83d016ac BVA |
236 | int elv_register_queue(struct request_queue *q); |
237 | void elv_unregister_queue(struct request_queue *q); | |
238 | ||
807d4af2 CH |
239 | struct hd_struct *__disk_get_part(struct gendisk *disk, int partno); |
240 | ||
581d4e28 JA |
241 | #ifdef CONFIG_FAIL_IO_TIMEOUT |
242 | int blk_should_fake_timeout(struct request_queue *); | |
243 | ssize_t part_timeout_show(struct device *, struct device_attribute *, char *); | |
244 | ssize_t part_timeout_store(struct device *, struct device_attribute *, | |
245 | const char *, size_t); | |
246 | #else | |
247 | static inline int blk_should_fake_timeout(struct request_queue *q) | |
248 | { | |
249 | return 0; | |
250 | } | |
251 | #endif | |
252 | ||
d6d48196 JA |
253 | int ll_back_merge_fn(struct request_queue *q, struct request *req, |
254 | struct bio *bio); | |
255 | int ll_front_merge_fn(struct request_queue *q, struct request *req, | |
256 | struct bio *bio); | |
b973cb7e JA |
257 | struct request *attempt_back_merge(struct request_queue *q, struct request *rq); |
258 | struct request *attempt_front_merge(struct request_queue *q, struct request *rq); | |
5e84ea3a JA |
259 | int blk_attempt_req_merge(struct request_queue *q, struct request *rq, |
260 | struct request *next); | |
d6d48196 | 261 | void blk_recalc_rq_segments(struct request *rq); |
80a761fd | 262 | void blk_rq_set_mixed_merge(struct request *rq); |
050c8ea8 | 263 | bool blk_rq_merge_ok(struct request *rq, struct bio *bio); |
34fe7c05 | 264 | enum elv_merge blk_try_merge(struct request *rq, struct bio *bio); |
d6d48196 | 265 | |
8324aa91 JA |
266 | void blk_queue_congestion_threshold(struct request_queue *q); |
267 | ||
ff88972c AB |
268 | int blk_dev_init(void); |
269 | ||
f253b86b | 270 | |
8324aa91 JA |
271 | /* |
272 | * Return the threshold (number of used requests) at which the queue is | |
273 | * considered to be congested. It include a little hysteresis to keep the | |
274 | * context switch rate down. | |
275 | */ | |
276 | static inline int queue_congestion_on_threshold(struct request_queue *q) | |
277 | { | |
278 | return q->nr_congestion_on; | |
279 | } | |
280 | ||
281 | /* | |
282 | * The threshold at which a queue is considered to be uncongested | |
283 | */ | |
284 | static inline int queue_congestion_off_threshold(struct request_queue *q) | |
285 | { | |
286 | return q->nr_congestion_off; | |
287 | } | |
288 | ||
e3a2b3f9 JA |
289 | extern int blk_update_nr_requests(struct request_queue *, unsigned int); |
290 | ||
c2553b58 JA |
291 | /* |
292 | * Contribute to IO statistics IFF: | |
293 | * | |
294 | * a) it's attached to a gendisk, and | |
295 | * b) the queue had IO stats enabled when this request was started, and | |
e2a60da7 | 296 | * c) it's a file system request |
c2553b58 | 297 | */ |
26308eab | 298 | static inline int blk_do_io_stat(struct request *rq) |
fb8ec18c | 299 | { |
33659ebb | 300 | return rq->rq_disk && |
e8064021 | 301 | (rq->rq_flags & RQF_IO_STAT) && |
57292b58 | 302 | !blk_rq_is_passthrough(rq); |
fb8ec18c JA |
303 | } |
304 | ||
6cf7677f CH |
305 | static inline void req_set_nomerge(struct request_queue *q, struct request *req) |
306 | { | |
307 | req->cmd_flags |= REQ_NOMERGE; | |
308 | if (req == q->last_merge) | |
309 | q->last_merge = NULL; | |
310 | } | |
311 | ||
0a72e7f4 JA |
312 | /* |
313 | * Steal a bit from this field for legacy IO path atomic IO marking. Note that | |
314 | * setting the deadline clears the bottom bit, potentially clearing the | |
315 | * completed bit. The user has to be OK with this (current ones are fine). | |
316 | */ | |
317 | static inline void blk_rq_set_deadline(struct request *rq, unsigned long time) | |
318 | { | |
319 | rq->__deadline = time & ~0x1UL; | |
320 | } | |
321 | ||
322 | static inline unsigned long blk_rq_deadline(struct request *rq) | |
323 | { | |
324 | return rq->__deadline & ~0x1UL; | |
325 | } | |
326 | ||
f2dbd76a TH |
327 | /* |
328 | * Internal io_context interface | |
329 | */ | |
330 | void get_io_context(struct io_context *ioc); | |
47fdd4ca | 331 | struct io_cq *ioc_lookup_icq(struct io_context *ioc, struct request_queue *q); |
24acfc34 TH |
332 | struct io_cq *ioc_create_icq(struct io_context *ioc, struct request_queue *q, |
333 | gfp_t gfp_mask); | |
7e5a8794 | 334 | void ioc_clear_queue(struct request_queue *q); |
f2dbd76a | 335 | |
24acfc34 | 336 | int create_task_io_context(struct task_struct *task, gfp_t gfp_mask, int node); |
f2dbd76a | 337 | |
c23ecb42 JA |
338 | /** |
339 | * rq_ioc - determine io_context for request allocation | |
340 | * @bio: request being allocated is for this bio (can be %NULL) | |
341 | * | |
342 | * Determine io_context to use for request allocation for @bio. May return | |
343 | * %NULL if %current->io_context doesn't exist. | |
344 | */ | |
345 | static inline struct io_context *rq_ioc(struct bio *bio) | |
346 | { | |
347 | #ifdef CONFIG_BLK_CGROUP | |
348 | if (bio && bio->bi_ioc) | |
349 | return bio->bi_ioc; | |
350 | #endif | |
351 | return current->io_context; | |
352 | } | |
353 | ||
f2dbd76a TH |
354 | /** |
355 | * create_io_context - try to create task->io_context | |
f2dbd76a TH |
356 | * @gfp_mask: allocation mask |
357 | * @node: allocation node | |
358 | * | |
24acfc34 TH |
359 | * If %current->io_context is %NULL, allocate a new io_context and install |
360 | * it. Returns the current %current->io_context which may be %NULL if | |
361 | * allocation failed. | |
f2dbd76a TH |
362 | * |
363 | * Note that this function can't be called with IRQ disabled because | |
24acfc34 | 364 | * task_lock which protects %current->io_context is IRQ-unsafe. |
f2dbd76a | 365 | */ |
24acfc34 | 366 | static inline struct io_context *create_io_context(gfp_t gfp_mask, int node) |
f2dbd76a TH |
367 | { |
368 | WARN_ON_ONCE(irqs_disabled()); | |
24acfc34 TH |
369 | if (unlikely(!current->io_context)) |
370 | create_task_io_context(current, gfp_mask, node); | |
371 | return current->io_context; | |
f2dbd76a TH |
372 | } |
373 | ||
374 | /* | |
375 | * Internal throttling interface | |
376 | */ | |
bc9fcbf9 | 377 | #ifdef CONFIG_BLK_DEV_THROTTLING |
c9a929dd | 378 | extern void blk_throtl_drain(struct request_queue *q); |
bc9fcbf9 TH |
379 | extern int blk_throtl_init(struct request_queue *q); |
380 | extern void blk_throtl_exit(struct request_queue *q); | |
d61fcfa4 | 381 | extern void blk_throtl_register_queue(struct request_queue *q); |
bc9fcbf9 | 382 | #else /* CONFIG_BLK_DEV_THROTTLING */ |
c9a929dd | 383 | static inline void blk_throtl_drain(struct request_queue *q) { } |
bc9fcbf9 TH |
384 | static inline int blk_throtl_init(struct request_queue *q) { return 0; } |
385 | static inline void blk_throtl_exit(struct request_queue *q) { } | |
d61fcfa4 | 386 | static inline void blk_throtl_register_queue(struct request_queue *q) { } |
bc9fcbf9 | 387 | #endif /* CONFIG_BLK_DEV_THROTTLING */ |
297e3d85 SL |
388 | #ifdef CONFIG_BLK_DEV_THROTTLING_LOW |
389 | extern ssize_t blk_throtl_sample_time_show(struct request_queue *q, char *page); | |
390 | extern ssize_t blk_throtl_sample_time_store(struct request_queue *q, | |
391 | const char *page, size_t count); | |
9e234eea | 392 | extern void blk_throtl_bio_endio(struct bio *bio); |
b9147dd1 | 393 | extern void blk_throtl_stat_add(struct request *rq, u64 time); |
9e234eea SL |
394 | #else |
395 | static inline void blk_throtl_bio_endio(struct bio *bio) { } | |
b9147dd1 | 396 | static inline void blk_throtl_stat_add(struct request *rq, u64 time) { } |
297e3d85 | 397 | #endif |
bc9fcbf9 | 398 | |
3bce016a CH |
399 | #ifdef CONFIG_BOUNCE |
400 | extern int init_emergency_isa_pool(void); | |
401 | extern void blk_queue_bounce(struct request_queue *q, struct bio **bio); | |
402 | #else | |
403 | static inline int init_emergency_isa_pool(void) | |
404 | { | |
405 | return 0; | |
406 | } | |
407 | static inline void blk_queue_bounce(struct request_queue *q, struct bio **bio) | |
408 | { | |
409 | } | |
410 | #endif /* CONFIG_BOUNCE */ | |
411 | ||
454be724 ML |
412 | extern void blk_drain_queue(struct request_queue *q); |
413 | ||
bc9fcbf9 | 414 | #endif /* BLK_INTERNAL_H */ |