2 * The Kyber I/O scheduler. Controls latency by throttling queue depths using
5 * Copyright (C) 2017 Facebook
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public
9 * License v2 as published by the Free Software Foundation.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <https://www.gnu.org/licenses/>.
20 #include <linux/kernel.h>
21 #include <linux/blkdev.h>
22 #include <linux/blk-mq.h>
23 #include <linux/elevator.h>
24 #include <linux/module.h>
25 #include <linux/sbitmap.h>
29 #include "blk-mq-debugfs.h"
30 #include "blk-mq-sched.h"
31 #include "blk-mq-tag.h"
33 #define CREATE_TRACE_POINTS
34 #include <trace/events/kyber.h>
37 * Scheduling domains: the device is divided into multiple domains based on the
48 static const char *kyber_domain_names
[] = {
49 [KYBER_READ
] = "READ",
50 [KYBER_WRITE
] = "WRITE",
51 [KYBER_DISCARD
] = "DISCARD",
52 [KYBER_OTHER
] = "OTHER",
57 * In order to prevent starvation of synchronous requests by a flood of
58 * asynchronous requests, we reserve 25% of requests for synchronous
61 KYBER_ASYNC_PERCENT
= 75,
65 * Maximum device-wide depth for each scheduling domain.
67 * Even for fast devices with lots of tags like NVMe, you can saturate the
68 * device with only a fraction of the maximum possible queue depth. So, we cap
69 * these to a reasonable value.
71 static const unsigned int kyber_depth
[] = {
79 * Default latency targets for each scheduling domain.
81 static const u64 kyber_latency_targets
[] = {
82 [KYBER_READ
] = 2ULL * NSEC_PER_MSEC
,
83 [KYBER_WRITE
] = 10ULL * NSEC_PER_MSEC
,
84 [KYBER_DISCARD
] = 5ULL * NSEC_PER_SEC
,
88 * Batch size (number of requests we'll dispatch in a row) for each scheduling
91 static const unsigned int kyber_batch_size
[] = {
99 * Requests latencies are recorded in a histogram with buckets defined relative
100 * to the target latency:
102 * <= 1/4 * target latency
103 * <= 1/2 * target latency
104 * <= 3/4 * target latency
106 * <= 1 1/4 * target latency
107 * <= 1 1/2 * target latency
108 * <= 1 3/4 * target latency
109 * > 1 3/4 * target latency
113 * The width of the latency histogram buckets is
114 * 1 / (1 << KYBER_LATENCY_SHIFT) * target latency.
116 KYBER_LATENCY_SHIFT
= 2,
118 * The first (1 << KYBER_LATENCY_SHIFT) buckets are <= target latency,
121 KYBER_GOOD_BUCKETS
= 1 << KYBER_LATENCY_SHIFT
,
122 /* There are also (1 << KYBER_LATENCY_SHIFT) "bad" buckets. */
123 KYBER_LATENCY_BUCKETS
= 2 << KYBER_LATENCY_SHIFT
,
127 * We measure both the total latency and the I/O latency (i.e., latency after
128 * submitting to the device).
135 static const char *kyber_latency_type_names
[] = {
136 [KYBER_TOTAL_LATENCY
] = "total",
137 [KYBER_IO_LATENCY
] = "I/O",
141 * Per-cpu latency histograms: total latency and I/O latency for each scheduling
142 * domain except for KYBER_OTHER.
144 struct kyber_cpu_latency
{
145 atomic_t buckets
[KYBER_OTHER
][2][KYBER_LATENCY_BUCKETS
];
149 * There is a same mapping between ctx & hctx and kcq & khd,
150 * we use request->mq_ctx->index_hw to index the kcq in khd.
152 struct kyber_ctx_queue
{
154 * Used to ensure operations on rq_list and kcq_map to be an atmoic one.
155 * Also protect the rqs on rq_list when merge.
158 struct list_head rq_list
[KYBER_NUM_DOMAINS
];
159 } ____cacheline_aligned_in_smp
;
161 struct kyber_queue_data
{
162 struct request_queue
*q
;
165 * Each scheduling domain has a limited number of in-flight requests
166 * device-wide, limited by these tokens.
168 struct sbitmap_queue domain_tokens
[KYBER_NUM_DOMAINS
];
171 * Async request percentage, converted to per-word depth for
172 * sbitmap_get_shallow().
174 unsigned int async_depth
;
176 struct kyber_cpu_latency __percpu
*cpu_latency
;
178 /* Timer for stats aggregation and adjusting domain tokens. */
179 struct timer_list timer
;
181 unsigned int latency_buckets
[KYBER_OTHER
][2][KYBER_LATENCY_BUCKETS
];
183 unsigned long latency_timeout
[KYBER_OTHER
];
185 int domain_p99
[KYBER_OTHER
];
187 /* Target latencies in nanoseconds. */
188 u64 latency_targets
[KYBER_OTHER
];
191 struct kyber_hctx_data
{
193 struct list_head rqs
[KYBER_NUM_DOMAINS
];
194 unsigned int cur_domain
;
195 unsigned int batching
;
196 struct kyber_ctx_queue
*kcqs
;
197 struct sbitmap kcq_map
[KYBER_NUM_DOMAINS
];
198 struct sbq_wait domain_wait
[KYBER_NUM_DOMAINS
];
199 struct sbq_wait_state
*domain_ws
[KYBER_NUM_DOMAINS
];
200 atomic_t wait_index
[KYBER_NUM_DOMAINS
];
203 static int kyber_domain_wake(wait_queue_entry_t
*wait
, unsigned mode
, int flags
,
206 static unsigned int kyber_sched_domain(unsigned int op
)
208 switch (op
& REQ_OP_MASK
) {
214 return KYBER_DISCARD
;
220 static void flush_latency_buckets(struct kyber_queue_data
*kqd
,
221 struct kyber_cpu_latency
*cpu_latency
,
222 unsigned int sched_domain
, unsigned int type
)
224 unsigned int *buckets
= kqd
->latency_buckets
[sched_domain
][type
];
225 atomic_t
*cpu_buckets
= cpu_latency
->buckets
[sched_domain
][type
];
228 for (bucket
= 0; bucket
< KYBER_LATENCY_BUCKETS
; bucket
++)
229 buckets
[bucket
] += atomic_xchg(&cpu_buckets
[bucket
], 0);
233 * Calculate the histogram bucket with the given percentile rank, or -1 if there
234 * aren't enough samples yet.
236 static int calculate_percentile(struct kyber_queue_data
*kqd
,
237 unsigned int sched_domain
, unsigned int type
,
238 unsigned int percentile
)
240 unsigned int *buckets
= kqd
->latency_buckets
[sched_domain
][type
];
241 unsigned int bucket
, samples
= 0, percentile_samples
;
243 for (bucket
= 0; bucket
< KYBER_LATENCY_BUCKETS
; bucket
++)
244 samples
+= buckets
[bucket
];
250 * We do the calculation once we have 500 samples or one second passes
251 * since the first sample was recorded, whichever comes first.
253 if (!kqd
->latency_timeout
[sched_domain
])
254 kqd
->latency_timeout
[sched_domain
] = max(jiffies
+ HZ
, 1UL);
256 time_is_after_jiffies(kqd
->latency_timeout
[sched_domain
])) {
259 kqd
->latency_timeout
[sched_domain
] = 0;
261 percentile_samples
= DIV_ROUND_UP(samples
* percentile
, 100);
262 for (bucket
= 0; bucket
< KYBER_LATENCY_BUCKETS
- 1; bucket
++) {
263 if (buckets
[bucket
] >= percentile_samples
)
265 percentile_samples
-= buckets
[bucket
];
267 memset(buckets
, 0, sizeof(kqd
->latency_buckets
[sched_domain
][type
]));
269 trace_kyber_latency(kqd
->q
, kyber_domain_names
[sched_domain
],
270 kyber_latency_type_names
[type
], percentile
,
271 bucket
+ 1, 1 << KYBER_LATENCY_SHIFT
, samples
);
276 static void kyber_resize_domain(struct kyber_queue_data
*kqd
,
277 unsigned int sched_domain
, unsigned int depth
)
279 depth
= clamp(depth
, 1U, kyber_depth
[sched_domain
]);
280 if (depth
!= kqd
->domain_tokens
[sched_domain
].sb
.depth
) {
281 sbitmap_queue_resize(&kqd
->domain_tokens
[sched_domain
], depth
);
282 trace_kyber_adjust(kqd
->q
, kyber_domain_names
[sched_domain
],
287 static void kyber_timer_fn(struct timer_list
*t
)
289 struct kyber_queue_data
*kqd
= from_timer(kqd
, t
, timer
);
290 unsigned int sched_domain
;
294 /* Sum all of the per-cpu latency histograms. */
295 for_each_online_cpu(cpu
) {
296 struct kyber_cpu_latency
*cpu_latency
;
298 cpu_latency
= per_cpu_ptr(kqd
->cpu_latency
, cpu
);
299 for (sched_domain
= 0; sched_domain
< KYBER_OTHER
; sched_domain
++) {
300 flush_latency_buckets(kqd
, cpu_latency
, sched_domain
,
301 KYBER_TOTAL_LATENCY
);
302 flush_latency_buckets(kqd
, cpu_latency
, sched_domain
,
308 * Check if any domains have a high I/O latency, which might indicate
309 * congestion in the device. Note that we use the p90; we don't want to
310 * be too sensitive to outliers here.
312 for (sched_domain
= 0; sched_domain
< KYBER_OTHER
; sched_domain
++) {
315 p90
= calculate_percentile(kqd
, sched_domain
, KYBER_IO_LATENCY
,
317 if (p90
>= KYBER_GOOD_BUCKETS
)
322 * Adjust the scheduling domain depths. If we determined that there was
323 * congestion, we throttle all domains with good latencies. Either way,
324 * we ease up on throttling domains with bad latencies.
326 for (sched_domain
= 0; sched_domain
< KYBER_OTHER
; sched_domain
++) {
327 unsigned int orig_depth
, depth
;
330 p99
= calculate_percentile(kqd
, sched_domain
,
331 KYBER_TOTAL_LATENCY
, 99);
333 * This is kind of subtle: different domains will not
334 * necessarily have enough samples to calculate the latency
335 * percentiles during the same window, so we have to remember
336 * the p99 for the next time we observe congestion; once we do,
337 * we don't want to throttle again until we get more data, so we
342 p99
= kqd
->domain_p99
[sched_domain
];
343 kqd
->domain_p99
[sched_domain
] = -1;
344 } else if (p99
>= 0) {
345 kqd
->domain_p99
[sched_domain
] = p99
;
351 * If this domain has bad latency, throttle less. Otherwise,
352 * throttle more iff we determined that there is congestion.
354 * The new depth is scaled linearly with the p99 latency vs the
355 * latency target. E.g., if the p99 is 3/4 of the target, then
356 * we throttle down to 3/4 of the current depth, and if the p99
357 * is 2x the target, then we double the depth.
359 if (bad
|| p99
>= KYBER_GOOD_BUCKETS
) {
360 orig_depth
= kqd
->domain_tokens
[sched_domain
].sb
.depth
;
361 depth
= (orig_depth
* (p99
+ 1)) >> KYBER_LATENCY_SHIFT
;
362 kyber_resize_domain(kqd
, sched_domain
, depth
);
367 static unsigned int kyber_sched_tags_shift(struct request_queue
*q
)
370 * All of the hardware queues have the same depth, so we can just grab
371 * the shift of the first one.
373 return q
->queue_hw_ctx
[0]->sched_tags
->bitmap_tags
.sb
.shift
;
376 static struct kyber_queue_data
*kyber_queue_data_alloc(struct request_queue
*q
)
378 struct kyber_queue_data
*kqd
;
383 kqd
= kzalloc_node(sizeof(*kqd
), GFP_KERNEL
, q
->node
);
389 kqd
->cpu_latency
= alloc_percpu_gfp(struct kyber_cpu_latency
,
390 GFP_KERNEL
| __GFP_ZERO
);
391 if (!kqd
->cpu_latency
)
394 timer_setup(&kqd
->timer
, kyber_timer_fn
, 0);
396 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++) {
397 WARN_ON(!kyber_depth
[i
]);
398 WARN_ON(!kyber_batch_size
[i
]);
399 ret
= sbitmap_queue_init_node(&kqd
->domain_tokens
[i
],
400 kyber_depth
[i
], -1, false,
401 GFP_KERNEL
, q
->node
);
404 sbitmap_queue_free(&kqd
->domain_tokens
[i
]);
409 for (i
= 0; i
< KYBER_OTHER
; i
++) {
410 kqd
->domain_p99
[i
] = -1;
411 kqd
->latency_targets
[i
] = kyber_latency_targets
[i
];
414 shift
= kyber_sched_tags_shift(q
);
415 kqd
->async_depth
= (1U << shift
) * KYBER_ASYNC_PERCENT
/ 100U;
420 free_percpu(kqd
->cpu_latency
);
427 static int kyber_init_sched(struct request_queue
*q
, struct elevator_type
*e
)
429 struct kyber_queue_data
*kqd
;
430 struct elevator_queue
*eq
;
432 eq
= elevator_alloc(q
, e
);
436 kqd
= kyber_queue_data_alloc(q
);
438 kobject_put(&eq
->kobj
);
442 blk_stat_enable_accounting(q
);
444 eq
->elevator_data
= kqd
;
450 static void kyber_exit_sched(struct elevator_queue
*e
)
452 struct kyber_queue_data
*kqd
= e
->elevator_data
;
455 del_timer_sync(&kqd
->timer
);
457 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++)
458 sbitmap_queue_free(&kqd
->domain_tokens
[i
]);
459 free_percpu(kqd
->cpu_latency
);
463 static void kyber_ctx_queue_init(struct kyber_ctx_queue
*kcq
)
467 spin_lock_init(&kcq
->lock
);
468 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++)
469 INIT_LIST_HEAD(&kcq
->rq_list
[i
]);
472 static int kyber_init_hctx(struct blk_mq_hw_ctx
*hctx
, unsigned int hctx_idx
)
474 struct kyber_queue_data
*kqd
= hctx
->queue
->elevator
->elevator_data
;
475 struct kyber_hctx_data
*khd
;
478 khd
= kmalloc_node(sizeof(*khd
), GFP_KERNEL
, hctx
->numa_node
);
482 khd
->kcqs
= kmalloc_array_node(hctx
->nr_ctx
,
483 sizeof(struct kyber_ctx_queue
),
484 GFP_KERNEL
, hctx
->numa_node
);
488 for (i
= 0; i
< hctx
->nr_ctx
; i
++)
489 kyber_ctx_queue_init(&khd
->kcqs
[i
]);
491 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++) {
492 if (sbitmap_init_node(&khd
->kcq_map
[i
], hctx
->nr_ctx
,
493 ilog2(8), GFP_KERNEL
, hctx
->numa_node
)) {
495 sbitmap_free(&khd
->kcq_map
[i
]);
500 spin_lock_init(&khd
->lock
);
502 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++) {
503 INIT_LIST_HEAD(&khd
->rqs
[i
]);
504 khd
->domain_wait
[i
].sbq
= NULL
;
505 init_waitqueue_func_entry(&khd
->domain_wait
[i
].wait
,
507 khd
->domain_wait
[i
].wait
.private = hctx
;
508 INIT_LIST_HEAD(&khd
->domain_wait
[i
].wait
.entry
);
509 atomic_set(&khd
->wait_index
[i
], 0);
515 hctx
->sched_data
= khd
;
516 sbitmap_queue_min_shallow_depth(&hctx
->sched_tags
->bitmap_tags
,
528 static void kyber_exit_hctx(struct blk_mq_hw_ctx
*hctx
, unsigned int hctx_idx
)
530 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
533 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++)
534 sbitmap_free(&khd
->kcq_map
[i
]);
536 kfree(hctx
->sched_data
);
539 static int rq_get_domain_token(struct request
*rq
)
541 return (long)rq
->elv
.priv
[0];
544 static void rq_set_domain_token(struct request
*rq
, int token
)
546 rq
->elv
.priv
[0] = (void *)(long)token
;
549 static void rq_clear_domain_token(struct kyber_queue_data
*kqd
,
552 unsigned int sched_domain
;
555 nr
= rq_get_domain_token(rq
);
557 sched_domain
= kyber_sched_domain(rq
->cmd_flags
);
558 sbitmap_queue_clear(&kqd
->domain_tokens
[sched_domain
], nr
,
563 static void kyber_limit_depth(unsigned int op
, struct blk_mq_alloc_data
*data
)
566 * We use the scheduler tags as per-hardware queue queueing tokens.
567 * Async requests can be limited at this stage.
569 if (!op_is_sync(op
)) {
570 struct kyber_queue_data
*kqd
= data
->q
->elevator
->elevator_data
;
572 data
->shallow_depth
= kqd
->async_depth
;
576 static bool kyber_bio_merge(struct blk_mq_hw_ctx
*hctx
, struct bio
*bio
)
578 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
579 struct blk_mq_ctx
*ctx
= blk_mq_get_ctx(hctx
->queue
);
580 struct kyber_ctx_queue
*kcq
= &khd
->kcqs
[ctx
->index_hw
[hctx
->type
]];
581 unsigned int sched_domain
= kyber_sched_domain(bio
->bi_opf
);
582 struct list_head
*rq_list
= &kcq
->rq_list
[sched_domain
];
585 spin_lock(&kcq
->lock
);
586 merged
= blk_mq_bio_list_merge(hctx
->queue
, rq_list
, bio
);
587 spin_unlock(&kcq
->lock
);
593 static void kyber_prepare_request(struct request
*rq
, struct bio
*bio
)
595 rq_set_domain_token(rq
, -1);
598 static void kyber_insert_requests(struct blk_mq_hw_ctx
*hctx
,
599 struct list_head
*rq_list
, bool at_head
)
601 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
602 struct request
*rq
, *next
;
604 list_for_each_entry_safe(rq
, next
, rq_list
, queuelist
) {
605 unsigned int sched_domain
= kyber_sched_domain(rq
->cmd_flags
);
606 struct kyber_ctx_queue
*kcq
= &khd
->kcqs
[rq
->mq_ctx
->index_hw
[hctx
->type
]];
607 struct list_head
*head
= &kcq
->rq_list
[sched_domain
];
609 spin_lock(&kcq
->lock
);
611 list_move(&rq
->queuelist
, head
);
613 list_move_tail(&rq
->queuelist
, head
);
614 sbitmap_set_bit(&khd
->kcq_map
[sched_domain
],
615 rq
->mq_ctx
->index_hw
[hctx
->type
]);
616 blk_mq_sched_request_inserted(rq
);
617 spin_unlock(&kcq
->lock
);
621 static void kyber_finish_request(struct request
*rq
)
623 struct kyber_queue_data
*kqd
= rq
->q
->elevator
->elevator_data
;
625 rq_clear_domain_token(kqd
, rq
);
628 static void add_latency_sample(struct kyber_cpu_latency
*cpu_latency
,
629 unsigned int sched_domain
, unsigned int type
,
630 u64 target
, u64 latency
)
636 divisor
= max_t(u64
, target
>> KYBER_LATENCY_SHIFT
, 1);
637 bucket
= min_t(unsigned int, div64_u64(latency
- 1, divisor
),
638 KYBER_LATENCY_BUCKETS
- 1);
643 atomic_inc(&cpu_latency
->buckets
[sched_domain
][type
][bucket
]);
646 static void kyber_completed_request(struct request
*rq
, u64 now
)
648 struct kyber_queue_data
*kqd
= rq
->q
->elevator
->elevator_data
;
649 struct kyber_cpu_latency
*cpu_latency
;
650 unsigned int sched_domain
;
653 sched_domain
= kyber_sched_domain(rq
->cmd_flags
);
654 if (sched_domain
== KYBER_OTHER
)
657 cpu_latency
= get_cpu_ptr(kqd
->cpu_latency
);
658 target
= kqd
->latency_targets
[sched_domain
];
659 add_latency_sample(cpu_latency
, sched_domain
, KYBER_TOTAL_LATENCY
,
660 target
, now
- rq
->start_time_ns
);
661 add_latency_sample(cpu_latency
, sched_domain
, KYBER_IO_LATENCY
, target
,
662 now
- rq
->io_start_time_ns
);
663 put_cpu_ptr(kqd
->cpu_latency
);
665 timer_reduce(&kqd
->timer
, jiffies
+ HZ
/ 10);
668 struct flush_kcq_data
{
669 struct kyber_hctx_data
*khd
;
670 unsigned int sched_domain
;
671 struct list_head
*list
;
674 static bool flush_busy_kcq(struct sbitmap
*sb
, unsigned int bitnr
, void *data
)
676 struct flush_kcq_data
*flush_data
= data
;
677 struct kyber_ctx_queue
*kcq
= &flush_data
->khd
->kcqs
[bitnr
];
679 spin_lock(&kcq
->lock
);
680 list_splice_tail_init(&kcq
->rq_list
[flush_data
->sched_domain
],
682 sbitmap_clear_bit(sb
, bitnr
);
683 spin_unlock(&kcq
->lock
);
688 static void kyber_flush_busy_kcqs(struct kyber_hctx_data
*khd
,
689 unsigned int sched_domain
,
690 struct list_head
*list
)
692 struct flush_kcq_data data
= {
694 .sched_domain
= sched_domain
,
698 sbitmap_for_each_set(&khd
->kcq_map
[sched_domain
],
699 flush_busy_kcq
, &data
);
702 static int kyber_domain_wake(wait_queue_entry_t
*wqe
, unsigned mode
, int flags
,
705 struct blk_mq_hw_ctx
*hctx
= READ_ONCE(wqe
->private);
706 struct sbq_wait
*wait
= container_of(wqe
, struct sbq_wait
, wait
);
708 sbitmap_del_wait_queue(wait
);
709 blk_mq_run_hw_queue(hctx
, true);
713 static int kyber_get_domain_token(struct kyber_queue_data
*kqd
,
714 struct kyber_hctx_data
*khd
,
715 struct blk_mq_hw_ctx
*hctx
)
717 unsigned int sched_domain
= khd
->cur_domain
;
718 struct sbitmap_queue
*domain_tokens
= &kqd
->domain_tokens
[sched_domain
];
719 struct sbq_wait
*wait
= &khd
->domain_wait
[sched_domain
];
720 struct sbq_wait_state
*ws
;
723 nr
= __sbitmap_queue_get(domain_tokens
);
726 * If we failed to get a domain token, make sure the hardware queue is
727 * run when one becomes available. Note that this is serialized on
728 * khd->lock, but we still need to be careful about the waker.
730 if (nr
< 0 && list_empty_careful(&wait
->wait
.entry
)) {
731 ws
= sbq_wait_ptr(domain_tokens
,
732 &khd
->wait_index
[sched_domain
]);
733 khd
->domain_ws
[sched_domain
] = ws
;
734 sbitmap_add_wait_queue(domain_tokens
, ws
, wait
);
737 * Try again in case a token was freed before we got on the wait
740 nr
= __sbitmap_queue_get(domain_tokens
);
744 * If we got a token while we were on the wait queue, remove ourselves
745 * from the wait queue to ensure that all wake ups make forward
746 * progress. It's possible that the waker already deleted the entry
747 * between the !list_empty_careful() check and us grabbing the lock, but
748 * list_del_init() is okay with that.
750 if (nr
>= 0 && !list_empty_careful(&wait
->wait
.entry
)) {
751 ws
= khd
->domain_ws
[sched_domain
];
752 spin_lock_irq(&ws
->wait
.lock
);
753 sbitmap_del_wait_queue(wait
);
754 spin_unlock_irq(&ws
->wait
.lock
);
760 static struct request
*
761 kyber_dispatch_cur_domain(struct kyber_queue_data
*kqd
,
762 struct kyber_hctx_data
*khd
,
763 struct blk_mq_hw_ctx
*hctx
)
765 struct list_head
*rqs
;
769 rqs
= &khd
->rqs
[khd
->cur_domain
];
772 * If we already have a flushed request, then we just need to get a
773 * token for it. Otherwise, if there are pending requests in the kcqs,
774 * flush the kcqs, but only if we can get a token. If not, we should
775 * leave the requests in the kcqs so that they can be merged. Note that
776 * khd->lock serializes the flushes, so if we observed any bit set in
777 * the kcq_map, we will always get a request.
779 rq
= list_first_entry_or_null(rqs
, struct request
, queuelist
);
781 nr
= kyber_get_domain_token(kqd
, khd
, hctx
);
784 rq_set_domain_token(rq
, nr
);
785 list_del_init(&rq
->queuelist
);
788 trace_kyber_throttled(kqd
->q
,
789 kyber_domain_names
[khd
->cur_domain
]);
791 } else if (sbitmap_any_bit_set(&khd
->kcq_map
[khd
->cur_domain
])) {
792 nr
= kyber_get_domain_token(kqd
, khd
, hctx
);
794 kyber_flush_busy_kcqs(khd
, khd
->cur_domain
, rqs
);
795 rq
= list_first_entry(rqs
, struct request
, queuelist
);
797 rq_set_domain_token(rq
, nr
);
798 list_del_init(&rq
->queuelist
);
801 trace_kyber_throttled(kqd
->q
,
802 kyber_domain_names
[khd
->cur_domain
]);
806 /* There were either no pending requests or no tokens. */
810 static struct request
*kyber_dispatch_request(struct blk_mq_hw_ctx
*hctx
)
812 struct kyber_queue_data
*kqd
= hctx
->queue
->elevator
->elevator_data
;
813 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
817 spin_lock(&khd
->lock
);
820 * First, if we are still entitled to batch, try to dispatch a request
823 if (khd
->batching
< kyber_batch_size
[khd
->cur_domain
]) {
824 rq
= kyber_dispatch_cur_domain(kqd
, khd
, hctx
);
831 * 1. We were no longer entitled to a batch.
832 * 2. The domain we were batching didn't have any requests.
833 * 3. The domain we were batching was out of tokens.
835 * Start another batch. Note that this wraps back around to the original
836 * domain if no other domains have requests or tokens.
839 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++) {
840 if (khd
->cur_domain
== KYBER_NUM_DOMAINS
- 1)
845 rq
= kyber_dispatch_cur_domain(kqd
, khd
, hctx
);
852 spin_unlock(&khd
->lock
);
856 static bool kyber_has_work(struct blk_mq_hw_ctx
*hctx
)
858 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
861 for (i
= 0; i
< KYBER_NUM_DOMAINS
; i
++) {
862 if (!list_empty_careful(&khd
->rqs
[i
]) ||
863 sbitmap_any_bit_set(&khd
->kcq_map
[i
]))
870 #define KYBER_LAT_SHOW_STORE(domain, name) \
871 static ssize_t kyber_##name##_lat_show(struct elevator_queue *e, \
874 struct kyber_queue_data *kqd = e->elevator_data; \
876 return sprintf(page, "%llu\n", kqd->latency_targets[domain]); \
879 static ssize_t kyber_##name##_lat_store(struct elevator_queue *e, \
880 const char *page, size_t count) \
882 struct kyber_queue_data *kqd = e->elevator_data; \
883 unsigned long long nsec; \
886 ret = kstrtoull(page, 10, &nsec); \
890 kqd->latency_targets[domain] = nsec; \
894 KYBER_LAT_SHOW_STORE(KYBER_READ
, read
);
895 KYBER_LAT_SHOW_STORE(KYBER_WRITE
, write
);
896 #undef KYBER_LAT_SHOW_STORE
898 #define KYBER_LAT_ATTR(op) __ATTR(op##_lat_nsec, 0644, kyber_##op##_lat_show, kyber_##op##_lat_store)
899 static struct elv_fs_entry kyber_sched_attrs
[] = {
900 KYBER_LAT_ATTR(read
),
901 KYBER_LAT_ATTR(write
),
904 #undef KYBER_LAT_ATTR
906 #ifdef CONFIG_BLK_DEBUG_FS
907 #define KYBER_DEBUGFS_DOMAIN_ATTRS(domain, name) \
908 static int kyber_##name##_tokens_show(void *data, struct seq_file *m) \
910 struct request_queue *q = data; \
911 struct kyber_queue_data *kqd = q->elevator->elevator_data; \
913 sbitmap_queue_show(&kqd->domain_tokens[domain], m); \
917 static void *kyber_##name##_rqs_start(struct seq_file *m, loff_t *pos) \
918 __acquires(&khd->lock) \
920 struct blk_mq_hw_ctx *hctx = m->private; \
921 struct kyber_hctx_data *khd = hctx->sched_data; \
923 spin_lock(&khd->lock); \
924 return seq_list_start(&khd->rqs[domain], *pos); \
927 static void *kyber_##name##_rqs_next(struct seq_file *m, void *v, \
930 struct blk_mq_hw_ctx *hctx = m->private; \
931 struct kyber_hctx_data *khd = hctx->sched_data; \
933 return seq_list_next(v, &khd->rqs[domain], pos); \
936 static void kyber_##name##_rqs_stop(struct seq_file *m, void *v) \
937 __releases(&khd->lock) \
939 struct blk_mq_hw_ctx *hctx = m->private; \
940 struct kyber_hctx_data *khd = hctx->sched_data; \
942 spin_unlock(&khd->lock); \
945 static const struct seq_operations kyber_##name##_rqs_seq_ops = { \
946 .start = kyber_##name##_rqs_start, \
947 .next = kyber_##name##_rqs_next, \
948 .stop = kyber_##name##_rqs_stop, \
949 .show = blk_mq_debugfs_rq_show, \
952 static int kyber_##name##_waiting_show(void *data, struct seq_file *m) \
954 struct blk_mq_hw_ctx *hctx = data; \
955 struct kyber_hctx_data *khd = hctx->sched_data; \
956 wait_queue_entry_t *wait = &khd->domain_wait[domain].wait; \
958 seq_printf(m, "%d\n", !list_empty_careful(&wait->entry)); \
961 KYBER_DEBUGFS_DOMAIN_ATTRS(KYBER_READ
, read
)
962 KYBER_DEBUGFS_DOMAIN_ATTRS(KYBER_WRITE
, write
)
963 KYBER_DEBUGFS_DOMAIN_ATTRS(KYBER_DISCARD
, discard
)
964 KYBER_DEBUGFS_DOMAIN_ATTRS(KYBER_OTHER
, other
)
965 #undef KYBER_DEBUGFS_DOMAIN_ATTRS
967 static int kyber_async_depth_show(void *data
, struct seq_file
*m
)
969 struct request_queue
*q
= data
;
970 struct kyber_queue_data
*kqd
= q
->elevator
->elevator_data
;
972 seq_printf(m
, "%u\n", kqd
->async_depth
);
976 static int kyber_cur_domain_show(void *data
, struct seq_file
*m
)
978 struct blk_mq_hw_ctx
*hctx
= data
;
979 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
981 seq_printf(m
, "%s\n", kyber_domain_names
[khd
->cur_domain
]);
985 static int kyber_batching_show(void *data
, struct seq_file
*m
)
987 struct blk_mq_hw_ctx
*hctx
= data
;
988 struct kyber_hctx_data
*khd
= hctx
->sched_data
;
990 seq_printf(m
, "%u\n", khd
->batching
);
994 #define KYBER_QUEUE_DOMAIN_ATTRS(name) \
995 {#name "_tokens", 0400, kyber_##name##_tokens_show}
996 static const struct blk_mq_debugfs_attr kyber_queue_debugfs_attrs
[] = {
997 KYBER_QUEUE_DOMAIN_ATTRS(read
),
998 KYBER_QUEUE_DOMAIN_ATTRS(write
),
999 KYBER_QUEUE_DOMAIN_ATTRS(discard
),
1000 KYBER_QUEUE_DOMAIN_ATTRS(other
),
1001 {"async_depth", 0400, kyber_async_depth_show
},
1004 #undef KYBER_QUEUE_DOMAIN_ATTRS
1006 #define KYBER_HCTX_DOMAIN_ATTRS(name) \
1007 {#name "_rqs", 0400, .seq_ops = &kyber_##name##_rqs_seq_ops}, \
1008 {#name "_waiting", 0400, kyber_##name##_waiting_show}
1009 static const struct blk_mq_debugfs_attr kyber_hctx_debugfs_attrs
[] = {
1010 KYBER_HCTX_DOMAIN_ATTRS(read
),
1011 KYBER_HCTX_DOMAIN_ATTRS(write
),
1012 KYBER_HCTX_DOMAIN_ATTRS(discard
),
1013 KYBER_HCTX_DOMAIN_ATTRS(other
),
1014 {"cur_domain", 0400, kyber_cur_domain_show
},
1015 {"batching", 0400, kyber_batching_show
},
1018 #undef KYBER_HCTX_DOMAIN_ATTRS
1021 static struct elevator_type kyber_sched
= {
1023 .init_sched
= kyber_init_sched
,
1024 .exit_sched
= kyber_exit_sched
,
1025 .init_hctx
= kyber_init_hctx
,
1026 .exit_hctx
= kyber_exit_hctx
,
1027 .limit_depth
= kyber_limit_depth
,
1028 .bio_merge
= kyber_bio_merge
,
1029 .prepare_request
= kyber_prepare_request
,
1030 .insert_requests
= kyber_insert_requests
,
1031 .finish_request
= kyber_finish_request
,
1032 .requeue_request
= kyber_finish_request
,
1033 .completed_request
= kyber_completed_request
,
1034 .dispatch_request
= kyber_dispatch_request
,
1035 .has_work
= kyber_has_work
,
1037 #ifdef CONFIG_BLK_DEBUG_FS
1038 .queue_debugfs_attrs
= kyber_queue_debugfs_attrs
,
1039 .hctx_debugfs_attrs
= kyber_hctx_debugfs_attrs
,
1041 .elevator_attrs
= kyber_sched_attrs
,
1042 .elevator_name
= "kyber",
1043 .elevator_owner
= THIS_MODULE
,
1046 static int __init
kyber_init(void)
1048 return elv_register(&kyber_sched
);
1051 static void __exit
kyber_exit(void)
1053 elv_unregister(&kyber_sched
);
1056 module_init(kyber_init
);
1057 module_exit(kyber_exit
);
1059 MODULE_AUTHOR("Omar Sandoval");
1060 MODULE_LICENSE("GPL");
1061 MODULE_DESCRIPTION("Kyber I/O scheduler");